Como converter uma lista de telefones para E.164 antes de uma verificação no Telegram
Aprenda a converter números de telefone para E.164 em planilhas: remova símbolos, prefixos nacionais, adicione códigos de país e valide antes da verificação.
Um fluxo de trabalho em nível de planilha para transformar números de telefone locais em E.164, para que uma Verificação de registro no Telegram ou um arquivo em lote de país único possam processá-los.
Para converter números de telefone para E.164, remova espaços e símbolos, descarte qualquer prefixo de tronco nacional (como um zero à esquerda) e escreva um sinal de mais seguido pelo código do país e pelos dígitos restantes. O resultado não contém espaços ou pontuação e utiliza no máximo 15 dígitos. Fazer isso em uma planilha antes de uma Verificação de registro no Telegram mantém os números legíveis para a verificação em tempo real e para arquivos em lote de país único.
O que o E.164 exige
O E.164 é o plano de numeração de telecomunicações públicas internacionais publicado pela ITU, descrito na página de recomendação da ITU. No trabalho diário com dados, isso significa um formato canônico: um sinal de mais, o código do país e o número do assinante, incluindo qualquer código de área, sem espaços, colchetes ou hifens. O comprimento total é de no máximo 15 dígitos.
Dois hábitos causam a maioria dos erros de conversão. O primeiro é tratar um número local como se fosse internacional. Um número escrito da forma como as pessoas discam em casa geralmente começa com um prefixo de tronco, que não faz parte da forma internacional. O segundo é tratar o sinal de mais como decoração. Em planilhas, um sinal de mais inicial é frequentemente interpretado como um operador de fórmula, fazendo com que a célula o remova silenciosamente.
A verificação em tempo real do TG Validator aceita um número de telefone E.164. Seu painel e arquivos em lote para números de telefone esperam códigos de país internacionais, portanto, uma coluna E.164 limpa é a preparação correta para qualquer um dos caminhos.
Passo 1: Mantenha a coluna como texto e faça um backup
Antes de alterar qualquer coisa, copie a coluna original para uma nova planilha ou aba. É fácil cometer erros na conversão, e o original intacto permite que você rastreie qualquer número de volta.
Em seguida, defina o formato da coluna de trabalho como texto simples. No Excel ou Google Sheets, isso impede que o programa remova zeros à esquerda ou leia um sinal de mais inicial como aritmética. Se o arquivo chegar como CSV, importe-o com a coluna de telefone explicitamente definida como texto, em vez de deixar o programa adivinhar.
Passo 2: Remova tudo o que não for um dígito
Remova espaços, hifens, pontos, colchetes e qualquer texto, como rótulos de ramal. No Google Sheets, uma substituição por expressão regular na coluna faz isso em uma etapa: substitua qualquer caractere que não seja um dígito por nada. No Excel, chamadas aninhadas de SUBSTITUTE para cada símbolo alcançam o mesmo resultado, ou a etapa de limpeza de texto do Power Query pode lidar com uma coluna inteira.
Anote os números que começavam com um sinal de mais ou com um prefixo internacional de zero duplo antes da remoção. Eles já possuem um código de país e precisam de um tratamento diferente na próxima etapa. Uma coluna auxiliar rápida que registra se o original começou com o sinal de mais ou com o zero duplo facilita isso.
Passo 3: Remova o prefixo de tronco e adicione o código do país
Esta é a etapa que requer uma decisão por país, portanto, trabalhe um país de cada vez.
- Já internacional. Se o original começou com um sinal de mais ou um prefixo de zero duplo, os dígitos que seguem são o código do país e o número. Remova o prefixo de zero duplo e coloque um sinal de mais na frente.
- Local com prefixo de tronco. Muitos países escrevem números nacionais com um zero à esquerda que é descartado na forma internacional. Remova esse único dígito inicial e adicione o sinal de mais e o código do país.
- Local sem prefixo de tronco. Alguns planos nacionais não possuem prefixo de tronco, portanto, os dígitos são mantidos como estão e apenas o sinal de mais e o código do país são adicionados.
Para uma planilha com uma coluna de país, uma tabela de consulta de nome de país para código de país, além de uma coluna registrando se aquele país usa um dígito de tronco inicial, orienta a fórmula. O resultado é uma nova coluna: sinal de mais, depois o código, depois o número com o dígito de tronco removido onde aplicável.
Não adivinhe um país para um número que não especifica um. Uma lista curta de linhas sem um país claro é melhor ser separada do que receber um padrão que as envia para o grupo errado.
Passo 4: Valide o comprimento e procure por valores discrepantes
Algumas verificações rápidas detectam a maior parte do que as fórmulas perdem.
- Comprimento. Após o sinal de mais, o número deve ter no máximo 15 dígitos. Qualquer coisa mais longa é um erro.
- Muito curto. Resultados muito curtos geralmente significam um código de área ausente ou um ramal colado.
- Códigos de país repetidos. Um número que já continha seu código e teve o código adicionado novamente começará com o código duas vezes. Classifique pelos primeiros dígitos para identificar esses casos.
- Países mistos em um arquivo de país único. Tarefas em lote de telefone funcionam em um país selecionado, portanto, agrupe as linhas por código de país e exporte um arquivo por país. A lista deve ser essencialmente do país selecionado, uma vez que um arquivo com uma grande parcela de outros códigos de país é rejeitado.
Mantenha uma aba de rejeição com o valor original, o valor convertido e o motivo da falha. Essa aba é a lista de trabalho para correções manuais.
Passo 5: Exporte para a verificação em tempo real ou para um arquivo em lote
Decida o caminho pelo tamanho da lista.
Para um conjunto pequeno, execute a Verificação de registro no Telegram em tempo real. A rota REST é POST /api/v1/check, autenticada com X-API-Key, com um número E.164 e o tipo de serviço tg, e o POST /api/v1/batch-check aceita até 100 números em uma única solicitação. A aba Batch Check do painel aceita até 500 números colados. Todos esses retornam na mesma sessão.
Para uma lista muito maior, exporte um TXT ou CSV com um número por linha, carregue-o como uma tarefa em lote para o país escolhido, aguarde a tarefa e baixe o result.csv. Os limites exatos por serviço estão na documentação da API atual e na página de preços, portanto, verifique-os antes de uma execução grande.
Números da China continental, Hong Kong e Macau podem ser verificados um de cada vez em pequenos volumes na verificação única em tempo real, mas arquivos em lote assíncronos não suportam essas regiões, portanto, mantenha-os fora das exportações em lote.
O que um arquivo E.164 limpo oferece e o que não oferece
A formatação limpa remove a causa mais comum de entrada ilegível, mas não altera o que a verificação significa. Um resultado de registro é um sinal de presença de conta específico da plataforma no momento da verificação. Ele não mostra atividade, identidade, propriedade, consentimento ou probabilidade de resposta, portanto, mantenha suas regras normais de permissão e relevância em vigor após a verificação.
Um hábito final útil é manter a coluna convertida ao lado da original na planilha principal, com a data da conversão, para que importações posteriores possam ser correspondidas sem repetir o trabalho.
FAQ
Como as equipes podem converter números de telefone locais para E.164 em uma planilha?
As equipes podem remover caracteres que não sejam dígitos, remover qualquer prefixo de tronco nacional, adicionar um sinal de mais e o código do país. Trabalhar um país de cada vez com uma tabela de consulta mantém a fórmula simples.
Qual é o comprimento máximo de um número E.164?
Um número E.164 tem no máximo 15 dígitos após o sinal de mais, sem espaços ou pontuação. Resultados mais longos geralmente indicam um código de país duplicado.
Como as equipes podem impedir que uma planilha remova o sinal de mais inicial?
Formate a coluna de telefone como texto simples antes de inserir ou importar valores, e importe arquivos CSV com a coluna de telefone definida como texto para que o sinal de mais e quaisquer zeros à esquerda sejam mantidos.
Arquivos em lote do Telegram precisam de um único país?
Sim. Tarefas em lote de números de telefone funcionam em um país selecionado, portanto, agrupe as linhas por código de país e exporte um arquivo por país; arquivos com uma grande parcela de outros códigos de país são rejeitados.
Saiba mais
Escolha as informações do produto que se encaixam na próxima etapa do seu fluxo de trabalho.