Quer que suas mensagens do WhatsApp cheguem sempre? Salve cada número de telefone dos contatos no formato correto. O WhatsApp só reconhece números escritos no estilo internacional completo: um sinal de mais, o código do país e o número local limpo. Além disso, em certos países existem ambiguidades na normalização dos números, como adicionar ou remover um dígito — errar nisso significa que o chat nunca começa ou sua chamada de API falha.
Aprenda a validar e formatar números de telefone para México, Argentina, Brasil e Rússia.
Normalizar números de telefone por país
México
Escreva +52 1 antes do número móvel de 10 dígitos. Exemplo: +52 1 55 1234 5678. O WhatsApp ainda usa o “1” para marcar celulares, mesmo após a mudança do plano de discagem do México em 2019.
Se o número local começar com 11, remova esses dois primeiros dígitos. Excentricidades antigas da Telcel/Nextel; mantém o comprimento total correto.(green-api.com) WhatsApp ID final: 521XXXXXXXXXX@c.us Exigido pela maioria dos BSPs e pela Business API.
Aviso: Para voz ou SMS fora do WhatsApp você agora disca +52 XXXXXXXXXX sem o “1”. Alguns provedores bloqueiam o formato antigo.
Argentina
Coloque um 9 após o código do país: +54 9. O “9” sinaliza celulares na Argentina. Apague o 15 que frequentemente aparece no início dos números móveis locais. “15” é um prefixo nacional não usado internacionalmente.
Seu WhatsApp ID fica como 549XXXXXXXXXX@c.us (13 dígitos no total). Necessário para a entrega de mensagens.
Brasil
Para os códigos de área 11–19, 21, 22, 24, 27, 28, adicione um 9 na frente do número local. Exemplo: +55 21 98765 4321. A ANATEL adicionou um nono dígito aos celulares nessas regiões.
Para a maioria dos outros códigos de área, mantenha o número como está (já com 9 dígitos). Nem todo DDD precisou do “9” extra.
Os WhatsApp IDs são 55DD9XXXXXXXX@c.us ou 55DDXXXXXXXX@c.us (12–13 dígitos). Ambas as formas são aceitas após aplicar a regra acima.
Rússia
Substitua o “8” doméstico por +7. Exemplo: 8 912 345 6789 → +7 912 345 6789. O “8” é apenas um prefixo de longa distância nacional; o WhatsApp precisa do código internacional.
Certifique-se de terminar com 11 dígitos após o sinal de mais. Os números da Rússia são “+7” mais dez dígitos. O WhatsApp ID fica como 7XXXXXXXXXX@c.us (sem o sinal +). Esse é o formato que a API espera.
Dicas rápidas
- Remova espaços, traços e parênteses antes de armazenar o número.
- Use uma biblioteca de parsing de telefones (por exemplo, libphonenumber do Google) para automatizar a limpeza.
- Teste um número de exemplo com https://wa.me/
<phonenumber>antes de enviar as mensagens
Wassenger dá superpoderes ao seu WhatsApp
A API da Wassenger formata, valida e verifica números de telefone do WhatsApp para você antes de enviar a mensagem, então você pode planejar a comunicação com seus clientes com antecedência. Explore um trial gratuito de 7 dias e veja funcionar antes do seu café ficar frio. 😉
🤩 🤖 Wassenger é uma solução completa de API para WhatsApp. Cadastre-se para um trial gratuito de 7 dias e comece em minutos!
Use a API da Wassenger para validar e formatar uma lista de números de telefone:
- Valide números usando o testador de API: https://app.wassenger.com/help/api-tester?example=validate
- Documentação da API: https://app.wassenger.com/docs/#tag/Numbers/operation/validateNumbers
