Números de telefone no formato E.164: Como formatar números para uma Consulta da operadora original

Um guia prático para escrever números de telefone no formato E.164, converter formatos locais e preparar entradas em tempo real e em arquivos para o CarrierLookup.

Um número de telefone no formato E.164 é escrito com um sinal de mais inicial, o código do país e o número do assinante, sem espaços, traços ou parênteses, por exemplo, +442071838750. O padrão internacional E.164 limita o total a 15 dígitos. Para uma consulta de operadora, converta primeiro cada número local para este formato, removendo qualquer prefixo de tronco nacional, como um zero inicial. As consultas em tempo real do CarrierLookup esperam o sinal de mais inicial. As linhas de arquivos em lote usam os mesmos dígitos sem o sinal de mais, um número por linha. Um número rejeitado por seu formato é um problema de formatação a ser corrigido, não um resultado de operadora inexistente.

O que significa o formato E.164

E.164 é o plano de numeração internacional publicado pela ITU. Um número neste plano tem até três partes: um código de país de um a três dígitos, um código de destino nacional e o número do assinante. Escrito, ele se torna um sinal de mais seguido apenas por dígitos. O comprimento total é limitado a 15 dígitos.

O sinal de mais é uma notação para o prefixo de discagem internacional. O prefixo que você disca de um telefone fixo ou celular varia de acordo com o país, e é por isso que o padrão escreve um sinal de mais em vez de qualquer prefixo específico.

Trate o E.164 como o formato de armazenamento único para números de telefone. Formatos de exibição, como parênteses e espaços, são adequados para pessoas, mas pertencem a uma camada de apresentação e não ao campo que você envia para uma consulta.

Convertendo formatos locais passo a passo

A maioria das colunas de telefone desorganizadas segue alguns padrões. Trabalhe nelas nesta ordem.

1. Remova tudo o que não seja um dígito ou um sinal de mais inicial. Espaços, pontos, traços e parênteses devem ser removidos.
2. Substitua o prefixo de discagem internacional inicial. Um número que começa com 00 seguido pelo código do país torna-se um sinal de mais seguido pelo código do país.
3. Remova o prefixo de tronco nacional. Muitos países escrevem números locais com um zero inicial que não faz parte do número internacional. Um celular do Reino Unido escrito como 07911 123456 torna-se +447911123456, enquanto um número dos EUA escrito como (212) 555-0123 torna-se +12125550123 após a adição do código de país 1.
4. Adicione o código do país quando ele estiver faltando. Faça isso apenas quando você souber o país a partir de outro campo, como o endereço de cobrança ou o formulário de onde o contato veio. Tentar adivinhar o país adiciona erros que você não conseguirá detectar depois.
5. Verifique o comprimento. Um resultado vazio, ou um resultado com mais de 15 dígitos, precisa de revisão, não de uma consulta.

Execute isso como um script repetível ou fórmula de planilha e mantenha o valor original em uma coluna separada, para que você possa auditar qualquer conversão que pareça estranha.

Entrada em tempo real versus linhas de arquivos em lote

O CarrierLookup aceita dois estilos de entrada, e eles não são intercambiáveis.

Para consultas em tempo real, envie o número no formato E.164 com o sinal de mais inicial. Uma consulta única usa POST /api/v1/check, e uma solicitação síncrona múltipla usa POST /api/v1/batch-check. Consultas em tempo real não precisam de uma seleção de país separada, portanto, uma solicitação múltipla pode conter números de diferentes países.

Para tarefas de arquivos em lote, crie um arquivo TXT ou CSV com um número por linha e sem extras no estilo de cabeçalho. Cada linha contém o código do país, escrito como dígitos simples, e um país é selecionado quando a tarefa é enviada. O arquivo de resultado também relata o identificador como dígitos simples com o código do país e sem o sinal de mais, portanto, uma junção de volta à sua coluna principal com prefixo de sinal de mais precisa de uma etapa de normalização.

Uma regra prática é manter uma única coluna principal em E.164 e gerar a versão do arquivo a partir dela, removendo o sinal de mais. Isso mantém ambas as rotas consistentes e evita duas fontes de verdade para o mesmo número.

Por que um formato rejeitado não é um resultado de operadora inexistente

Quando um número não está em um formato que a consulta possa analisar, ele é rejeitado por seu formato. Isso não diz nada sobre o número em si. Muitas equipes leem uma rejeição como um veredito e excluem linhas, o que faz com que bons contatos sejam perdidos.

Separe três resultados em seu fluxo de trabalho:

• Formato rejeitado. Corrija o número usando as etapas acima e envie-o novamente.
• Consulta concluída com campos vazios. A consulta foi finalizada e alguns valores estão indisponíveis. Mantenha a linha e armazene os valores vazios como indisponíveis.
• Consulta falha ou Indeterminado. Nenhum resultado foi produzido e nenhuma cobrança é mantida. Tente novamente mais tarde ou coloque a linha na fila para revisão.

Na rota em lote, o pré-processamento também exclui linhas que são inválidas, duplicadas, que não possuem código de país ou que estão fora do país selecionado. Linhas excluídas não são cobradas, e manter um registro de quais linhas foram excluídas informa qual parte da sua limpeza precisa de melhorias.

Erros comuns de formatação

A maioria dos problemas de formato vem de uma pequena lista de hábitos.

• Manter o zero do tronco após o código do país. +4407911123456 está incorreto. O zero pertence apenas ao formato local.
• Misturar separadores em uma única coluna. Uma regra organizada aplicada a tudo é melhor do que uma dúzia de exceções.
• Tratar números como células numéricas em uma planilha. Sinais de mais e zeros iniciais desaparecem. Armazene a coluna como texto.
• Códigos de país compartilhados. Vários países compartilham o +1, portanto, o código sozinho não identifica um país. Para tarefas de arquivo, selecione o país que corresponde à lista.
• Tentar adivinhar um país para um número local puro. Use outro campo confiável ou deixe a linha de fora.

Após a conversão, verifique manualmente algumas dezenas de linhas em relação a uma referência, como o plano de numeração nacional, e então execute a lista completa. Lembre-se de que um número formatado corretamente informa apenas que o formato está correto. O resultado da operadora que se segue relata o contexto original de alocação do número, não a operadora atual ou a disponibilidade.

FAQ

Como as equipes podem converter um número local para o formato E.164?

Remova todos os espaços e separadores, remova o prefixo de tronco nacional, como um zero inicial, e coloque um sinal de mais e o código do país na frente. Adicione um código de país apenas quando outro campo confiável identificar o país. Mantenha o valor original em uma coluna separada para auditoria.

Como as equipes podem preparar números para uma tarefa de arquivo em lote?

Escreva um número por linha em um arquivo TXT ou CSV, como dígitos com o código do país e sem o sinal de mais, e selecione o país que corresponde à lista. Linhas que são inválidas, duplicadas ou que estão fora do país selecionado são excluídas durante o pré-processamento e não são cobradas.

Como as equipes podem tratar um número rejeitado em uma consulta de operadora?

Trate-o como um problema de formatação. Verifique o sinal de mais, o código do país, o prefixo de tronco e o comprimento, corrija o número e envie-o novamente. Uma rejeição não é um resultado de operadora inexistente, portanto, mantenha o contato na lista em vez de excluí-lo.

Saiba mais

Escolha as informações do produto que se ajustam à próxima etapa do seu fluxo de trabalho.

• Ver a documentação do produto →
• Falar com a equipe →