Corrigindo erros de 'O número de telefone deve estar no formato E.164'
Corrija códigos de país ausentes, sinais de mais e prefixos nacionais antes de enviar um número para a verificação de registro no Telegram.
Corrija códigos de país ausentes, sinais de mais e prefixos nacionais antes de enviar um número para a verificação de registro no Telegram.
Um erro de "o número de telefone deve estar no formato E.164" significa que o valor enviado precisa estar no formato internacional de telefone antes que uma verificação de registro no Telegram possa utilizá-lo. Comece com o código de país e o número nacional corretos, adicione o sinal de mais inicial e remova a pontuação de exibição e qualquer prefixo de discagem nacional que não pertença à forma internacional. Valide o valor transformado em relação ao registro de origem antes de reenviá-lo; um número sintaticamente correto, mas incorreto, ainda é uma entrada errada.
O que o requisito E.164 está verificando
E.164 é o plano de numeração internacional publicado pela International Telecommunication Union. Na aplicação cotidiana, sua apresentação familiar começa com um sinal de mais, seguido por um código de país e o número nacional significativo. O sinal de mais representa o contexto de discagem internacional; espaços, colchetes e hifens podem ajudar uma pessoa a ler um número de telefone, mas não fazem parte do valor compacto que uma API de verificação espera.
Um erro de formatação ocorre antes de uma resposta de registro significativa. Ele não deve ser registrado como "Não registrado" no Telegram. A verificação de registro em tempo real de número único do TG Validator requer que o número de telefone enviado esteja na forma E.164. Uma vez que a entrada é aceita, um resultado decidido diz respeito à presença da conta no Telegram para aquele número enviado no momento da verificação. A verificação de formato em si não diz nada sobre a presença da conta, identidade, propriedade ou permissão de contato.
Use o valor da fonte original e o país conhecido em conjunto. Não adivinhe um código de país a partir dos primeiros dígitos de um número incompleto ou do país no endereço de correspondência de um contato. Um número nacional só pode ser significativo com seu contexto de numeração. Quando o país for desconhecido, mantenha o registro para revisão de dados em vez de criar silenciosamente um número internacional com aparência plausível.
Diagnostique os erros de entrada mais comuns
Comece inspecionando a string exata enviada para a verificação, não apenas a maneira como uma planilha a exibe. Um sinal de mais ausente é comum quando um campo foi armazenado como um número. O mesmo ocorre com espaços, parênteses e hifens copiados de um cartão de contato legível por humanos. Algumas fontes retêm um prefixo de tronco nacional que deve ser omitido após a adição do código do país. Outras fontes já incluem o código do país, portanto, prefixá-lo novamente cria uma duplicata.
| Sintoma | Problema de dados provável | Ação de revisão |
|---|---|---|
| Sem sinal de mais inicial | Valor nacional ou internacional truncado | Confirme o país e, em seguida, construa a forma internacional |
| Colchetes ou separadores | Formato de exibição humano copiado para a entrada da API | Remova caracteres de apresentação do valor enviado |
| Zero inicial extra após o código do país | Prefixo de discagem nacional retido | Aplique a regra de discagem internacional do país específico |
| Código de país repetido | Código adicionado a um número já internacional | Compare com a fonte e remova a duplicata |
| Número inesperado de dígitos | Dígitos perdidos, ramal ou país errado | Verifique novamente o registro de origem e o plano específico do país |
O Twilio E.164 error guide ilustra um requisito comum do lado do serviço para a mesma forma compacta. Ele não define o resultado de registro do TG Validator. Para uma transformação específica do país, consulte a orientação de numeração autorizada; uma regra genérica de "remover todo zero" não é segura, pois um zero pode pertencer ao número nacional significativo.
Normalize em uma sequência controlada
Primeiro, preserve o valor bruto em um campo separado. Segundo, atribua um país ou região de numeração confiável a partir do registro de origem. Terceiro, remova apenas caracteres de exibição, como espaços, hifens e colchetes; não descarte dígitos simplesmente porque parecem incomuns. Quarto, decida se o valor já possui um sinal de mais e um código de país. Quinto, se estiver no formato nacional, aplique a regra nacional-para-internacional relevante, incluindo se um prefixo de tronco deve ser removido. Finalmente, verifique se a saída começa com um sinal de mais, contém os dígitos pretendidos e não possui ramal incorporado no valor enviado.
Por exemplo, um número no formato nacional do Reino Unido pode ter um 0 inicial usado na discagem doméstica. Em uma representação internacional, o código do país do Reino Unido é +44 e esse 0 de tronco doméstico é geralmente descartado. A transformação deve ser baseada em um número verificado do Reino Unido; não é uma regra universal para todos os países. A definição da ITU de um prefixo de tronco nacional explica por que a string de discagem nacional e um número internacional podem diferir. Mantenha a fonte e o valor transformado lado a lado para que um revisor possa detectar a perda acidental de dígitos.
Não use uma correspondência de Regex sozinha como o portão de qualidade final. Um Regex pode detectar pontuação óbvia ou um sinal de mais ausente, mas não pode determinar se o país está correto ou se uma regra de numeração local foi aplicada corretamente. Um analisador que reconhece o país pode ajudar, mas os dados de origem da equipe ainda precisam de revisão quando as informações de país ou propriedade são incertas.
Verifique o que a planilha ou CRM realmente armazena
O Excel e ferramentas similares podem alterar silenciosamente valores semelhantes a números quando uma coluna é tratada como numérica. A Microsoft recomenda formatar células como texto antes da entrada, porque números de telefone são identificadores, e não quantidades para aritmética. Um formato personalizado visualmente correto pode apenas alterar a exibição e deixar um valor subjacente diferente. Se um dígito inicial foi perdido antes que a célula se tornasse texto, alterar o formato posteriormente não o reconstruirá.
Antes de enviar um lote, exporte uma pequena amostra e inspecione o TXT ou CSV bruto em um visualizador de texto simples. Confirme a primeira e a última linha, algumas entradas com prefixos nacionais e algumas entradas internacionais. Conte os dígitos nos valores de origem e transformados para essas amostras. Se uma linha contiver um ramal, mantenha-o em um campo de CRM separado; ele não é o número de telefone enviado para uma verificação de registro no Telegram.
Se a fonte for um formulário, colete o país e o número de telefone em campos distintos e validados, quando prático. Se for uma lista antiga, marque as linhas incertas para revisão em vez de aplicar uma conversão ampla que poderia alterar milhares de números incorretamente. Isso é especialmente importante quando uma lista contém vários países.
Reenvie o fluxo de trabalho correto após corrigir a entrada
Para um único registro, use o Painel de Verificação Única do TG Validator ou sua verificação de registro REST em tempo real após a normalização. A verificação única REST é o caminho POST /api/v1/check documentado. Uma verificação decidida retorna o resultado do registro na mesma sessão de solicitação. Uma verificação indecisa é um resultado separado com um código de negócio diferente de zero; ela não deve ser reclassificada como um erro de formato ou como um resultado de registro negativo.
Para um pequeno conjunto, a rota de lote em tempo real pode verificar até 100 números através da API, e a Verificação de Lote em Tempo Real do painel pode aceitar até 500 números colados. Uma lista preparada muito maior segue o fluxo de trabalho de arquivo em lote assíncrono separado, com entrada TXT ou CSV, monitoramento de tarefas e download de resultados. Revise a documentação da API do TG Validator atual antes de escolher uma rota ou codificar detalhes da solicitação. Esses fluxos de trabalho diferem, mas cada um se beneficia do mesmo processo de normalização que preserva a fonte.
Após uma correção, registre qual registro foi alterado e por quê. Se uma verificação anterior usou o número errado, não edite esse resultado histórico como se ele se referisse ao número corrigido. Execute uma nova verificação para o valor corrigido e mantenha uma trilha de auditoria clara. O objetivo é um resultado sobre o número pretendido, não apenas o desaparecimento de um erro de entrada.
Perguntas frequentes
Como as equipes podem corrigir um sinal de mais ausente em um erro E.164?
Confirme o número de origem e o país, então construa o valor internacional com um sinal de mais inicial e o código de país correto. Não adicione um código adivinhado a um registro incerto.
As equipes devem remover todos os zeros iniciais dos números de telefone?
Não. Aplique a regra de numeração do país específico. Um prefixo de tronco nacional pode ser omitido internacionalmente, mas outros zeros podem ser dígitos significativos.
O que deve acontecer com um registro que ainda falha após a normalização?
Mantenha os valores brutos e transformados, inspecione o país e os dados de origem e encaminhe o registro para revisão. Uma falha de formato não é um resultado de registro no Telegram.
Saiba mais
Escolha as informações do produto que se encaixam na próxima etapa do seu fluxo de trabalho.