O que é o formato E.164
A Recomendação ITU-T E.164 é o plano de numeração internacional que dá a cada número de telefone do mundo uma forma única. Um número E.164 é o código do país (de 1 a 3 dígitos) seguido do número nacional significativo, com no máximo 15 dígitos no total. Escrito para sistemas, ele leva um sinal de mais no início e nada além disso: sem espaços, parênteses, hífens, o 0 de longa distância nem o código de operadora.
O mesmo celular pode aparecer como (11) 91234-5678, +55 11 91234-5678, 005511912345678 ou 55-11-912345678 numa exportação do CRM. Só um deles é E.164: +5511912345678. Guardar todos os números assim os torna comparáveis: os duplicados aparecem e qualquer API de SMS, WhatsApp ou voz os aceita.
- Códigos de país: +55 Brasil, +351 Portugal, +244 Angola, +971 Emirados Árabes Unidos, +966 Arábia Saudita, +44 Reino Unido, +1 Estados Unidos e Canadá.
- Remova o prefixo nacional: 050 nos Emirados vira 50 depois de +971, e 07400 no Reino Unido vira 7400 depois de +44.
- Troque o prefixo de discagem internacional (00 na maioria dos países, 011 a partir dos EUA e do Canadá) por +.
- O comprimento máximo é de 15 dígitos, sem contar o sinal de mais.
Formatos de número no Golfo e na região MENA
Os planos de numeração do Golfo se parecem, mas mudam no comprimento e no uso ou não de um 0 nacional. Por isso, uma lista que mistura formatos locais de vários países não pode ser limpa sem um país padrão e dados completos de numeração.
- Emirados Árabes Unidos (+971): celulares têm 9 dígitos e começam com 5 (50, 52, 54, 55, 56, 58), discados localmente como 05X XXX XXXX. Fixos têm 8 dígitos, por exemplo 04 em Dubai e 02 em Abu Dhabi.
- Arábia Saudita (+966): celulares têm 9 dígitos e começam com 5, escritos localmente como 05X XXX XXXX. A forma E.164 é +966 50 123 4567.
- Catar (+974), Kuwait (+965), Bahrein (+973) e Omã (+968): números de 8 dígitos sem 0 nacional, então o número local é o próprio número nacional. Celulares começam com 3, 5, 6 ou 7 no Catar, com 5, 6 ou 9 no Kuwait, com 3 no Bahrein e com 7 ou 9 em Omã.
- Egito (+20): celulares têm 10 dígitos e começam com 10, 11, 12 ou 15, escritos localmente como 01X XXXX XXXX.
- Dígitos arábico-índicos (٠١٢٣٤٥٦٧٨٩) e persas (۰۱۲۳۴۵۶۷۸۹) são comuns em formulários preenchidos com teclado árabe. São os mesmos números e precisam ser convertidos para dígitos ASCII antes que uma API os aceite.
Por que listas limpas melhoram a entrega e reduzem custos
Cada número inválido, duplicado ou fixo numa lista de campanha é dinheiro ou mensagem desperdiçada. Muitas rotas de SMS cobram por mensagem enviada, então um número com um dígito a menos é pago do mesmo jeito. Um duplicado faz o mesmo cliente receber sua oferta duas vezes, o que aumenta descadastros e denúncias de spam, e uma taxa alta de falhas prejudica a reputação do seu remetente junto às operadoras.
No WhatsApp, um número mal formatado simplesmente falha: a Cloud API espera o número internacional completo, e um (11) 9… sem código do país é rejeitado ou vai para o país errado. Limpar a lista antes de importar também torna úteis seus relatórios de entrega, porque as falhas passam a apontar problemas reais, como números inativos, e não erros de digitação.
- Remova duplicados depois de normalizar, não antes: 11912345678 e +5511912345678 são a mesma pessoa.
- Tire os fixos dos envios de SMS e WhatsApp; direcione-os para voz.
- Mantenha as linhas inválidas sinalizadas num arquivo separado para corrigir o sistema de origem.
- A validação de formato prova que o número pode existir, não que está ativo. Para isso, use uma consulta HLR ou os relatórios de entrega.
Como este formatador funciona
A ferramenta usa a libphonenumber-js com os metadados completos da libphonenumber do Google, os mesmos dados de numeração usados pelo Android e pela maioria das plataformas de mensagens. Ela compara cada número com as faixas atribuídas no país e informa o tipo de linha quando o plano o define: celular, fixo, gratuito, VoIP, tarifa premium ou custo compartilhado. Nos EUA e no Canadá, celulares e fixos dividem as mesmas faixas, então o tipo aparece como fixo ou celular.
Antes da análise, ela converte dígitos arábico-índicos, persas e de largura total, remove marcas de direção invisíveis que o texto em árabe costuma trazer, tira os prefixos tel: e wa.me e troca 00 por +. Números que já começam com código do país sem o mais, como 5511912345678, também são reconhecidos. Tudo roda no seu navegador: listas de até 50.000 linhas são processadas em blocos no seu dispositivo e nunca são enviadas.
E.164 ou só dígitos: qual formato usar
Use E.164 com o mais (+5511912345678) para guardar números num CRM ou banco de dados, em links tel: e na maioria das APIs de SMS e voz. Use só dígitos (5511912345678) onde o mais não é aceito: links wa.me, o wa_id da Cloud API do WhatsApp e APIs de SMS que recebem o destino como número simples, como a API de SMS da OmniChannels.ai.
Seja qual for a escolha, mantenha o mesmo formato em todos os sistemas. Misturar formatos é a causa mais comum de contatos duplicados e de listas que falham na validação ao serem importadas.