Validador de número de WhatsApp

Equipe zapfunil · conteúdo revisado pela redação
Publicado em 13 de agosto de 2026 · Regras conferidas na Anatel e na documentação da Meta

Vamos começar pela parte que quase nenhuma página de “validador de WhatsApp” admite: não existe mais jeito público e legítimo de perguntar “esse número tem WhatsApp?” e receber sim ou não. Existia. Era o endpoint /contacts da On-Premises API, e ele foi para o mesmo lugar que o resto daquela API: encerramento em 23 de outubro de 2025. A Cloud API, que ficou no lugar, nunca teve função equivalente.

O que sobrou é menos glamouroso e resolve mais problema do que parece. A maioria dos números que falha num disparo não falha por falta de conta no WhatsApp: falha porque está escrito errado. DDD que não existe, celular sem o nono dígito, zero de operadora colado na frente, o mesmo cliente cadastrado três vezes em formatos diferentes. É isso que a ferramenta acima resolve, no navegador, sem mandar seus contatos para lugar nenhum.

O que dá e o que não dá para checar num número

Vale colar esta tabela na parede antes de contratar qualquer serviço de “higienização de base”:

A linha da operadora merece nota. O Consulta Número da ABR Telecom é o banco oficial de portabilidade, é gratuito e não pede cadastro, só um captcha. Serve para conferir um caso duvidoso, não para rodar uma planilha de quatro mil linhas.

Por que a checagem automática sumiu

Quem programava para WhatsApp antes de 2023 lembra do /contacts: você mandava uma lista de telefones e a resposta dizia quais eram valid e devolvia o WhatsApp ID de cada um. Com o fim da On-Premises API em outubro de 2025, todo mundo migrou para a Cloud API, que não expõe nada parecido. Você descobre que o número não tem conta do jeito mais caro possível: mandando a mensagem e olhando o erro.

E o erro não é generoso. O código 131026 funciona como guarda-chuva: destinatário sem WhatsApp, destinatário que não aceitou os termos novos, aplicativo velho demais e bloqueio do seu número pelo cliente caem todos no mesmo código, e a documentação da Meta diz que a razão exata não é revelada, por privacidade do destinatário. Uma boa notícia no meio: mensagem que volta com 131026 não é cobrada, porque nenhuma conversa chegou a abrir.

As três regras que a numeração brasileira impõe

1. O DDD precisa existir

São 67 códigos em uso no país. Os pares que não existem são poucos e sempre pegam alguém desprevenido: 23, 25, 26, 29, 36, 39, 52, 56, 57, 58, 59, 72, 76, 78, além de qualquer par terminado em zero. Um “(23) 99876-5432” numa planilha é quase sempre um 21 ou um 24 digitado com o dedo torto. A tabela completa, com a região de cada código:

2. Celular tem nove dígitos e começa com 9

A Anatel terminou a migração em 14 de fevereiro de 2017: desde então todo celular do país tem o formato 9XXXX-XXXX. Um número de oito dígitos começando com 6, 7, 8 ou 9 não é um celular diferente, é um cadastro velho que ninguém atualizou. O conserto é colar o 9 na frente do bloco local, e não no lugar de outro dígito.

Existe uma regra de bolso que a ferramenta trata como aviso, não como reprovação: as faixas de celular nasceram dos prefixos 6, 7, 8 e 9 da numeração antiga, então um número como 91234-5678 chama atenção. A Anatel não publica essa restrição no plano de numeração, e por isso não reprovamos ninguém por causa dela.

3. Fixo é oito dígitos e começa entre 2 e 5

Fixo entra no WhatsApp Business, que verifica a conta por ligação em vez de SMS. No WhatsApp comum, não entra. Se a sua base tem muitos fixos e você dispara por lá, a taxa de falha vai parecer um problema de entrega quando é um problema de segmentação.

O nono dígito que some no meio do caminho

Esta é a armadilha que derruba integração de gente experiente. O WhatsApp guarda um identificador interno para cada conta, e contas brasileiras antigas de DDD 31 para cima costumam estar registradas sem o nono dígito, enquanto as de DDD 11 a 28 mantêm o 9. Provedores de API documentam isso há anos, e as bibliotecas não oficiais vivem abrindo chamado por causa disso: a biblioteca adiciona o 9 em todo número brasileiro, monta um identificador que não existe e a mensagem simplesmente não chega. Sem erro, sem aviso, sem cobrança. O relatório mostra enviado e o cliente jura que não recebeu.

Na API oficial da Meta esse problema não é seu: você manda o E.164 com o 9 e a plataforma faz a correspondência. Por isso a ferramenta acima mostra as duas formas quando o DDD é 31 ou maior, em vez de escolher uma. Se a sua plataforma é oficial, use a primeira e ignore a segunda. Se você herdou um script que fala direto com o identificador, a segunda explica o mistério das mensagens que somem.

A conta que uma lista suja cobra

Números errados não custam tarifa. Contatos repetidos custam, e é aí que a planilha antiga morde. Vamos a um caso concreto, com premissas declaradas: uma clínica odontológica em Goiânia com 4.000 linhas acumuladas em três anos de formulário de site, ficha de recepção e exportação de agenda. As proporções abaixo são uma premissa de trabalho, não uma medição nossa:

• 214 repetidos. O mesmo celular cadastrado como +55 62 98765-4321, 62987654321 e (62) 98765-4321. Remover duplicata antes de padronizar o formato não pega nenhum dos três.
• 96 recusados. DDD inexistente, oito dígitos começando com 9, número local sem DDD.
• 3.690 prontos para importar.

Com a tarifa de marketing da Meta em US$ 0,0625 por mensagem entregue e o dólar a R$ 5,10, cada envio sai por R$ 0,3188. A campanha limpa custa 3.690 × R$ 0,3188 = R$ 1.176,19 de tarifa. Os 214 repetidos, se ficassem, entregariam de novo e cobrariam de novo:

• 214 × R$ 0,3188 = R$ 68,21 jogados fora por disparo;
• com duas campanhas por mês, R$ 136,43 mensais;
• no ano, R$ 1.637,10 pagos para mandar a mesma promoção duas vezes para a mesma pessoa.

Os 96 recusados não entram nessa conta em reais, porque voltariam com 131026 sem cobrança. O preço deles é outro: 96 falhas em 4.000 envios são 2,4% de não entrega registrados contra o seu número, e a nota de qualidade que a Meta calcula a partir disso é o que define o seu limite diário de mensagens. Some a mensalidade da plataforma para chegar ao custo real, a calculadora de custo da WhatsApp API faz essa parte com o seu volume, e as tarifas por categoria estão destrinchadas em preços da API do WhatsApp em 2026.

Erros comuns na hora de higienizar a base

• Tirar duplicata antes de padronizar. A ordem certa é limpar, converter para E.164 e só então comparar. Ao contrário, o mesmo cliente passa três vezes.
• Deixar o Excel comer o zero e o mais. Célula formatada como número transforma +5562987654321 em notação científica. Formate a coluna como texto antes de colar, ou exporte em CSV e abra num editor simples.
• Adicionar o 9 em tudo com um localizar e substituir. Fixo com nove dígitos vira número que não existe, e o disparo falha inteiro naquela faixa.
• Confiar em serviço que promete checar conta em massa. Sem endpoint oficial, o que resta é sondagem por biblioteca não oficial. Isso fere os Termos do WhatsApp Business e o preço costuma ser o banimento do seu número.
• Tratar erro 131026 como número inválido. Pode ser cliente que bloqueou você, aplicativo desatualizado ou limite de frequência. Antes de apagar o contato, tente uma mensagem de utilidade em outro dia.

Mais ferramentas para WhatsApp

Com o número no formato certo, o passo seguinte costuma ser o link: o gerador de link do WhatsApp monta o wa.me com mensagem pronta, e o gerador de QR Code transforma o mesmo link em código para balcão e vitrine. Antes de submeter o template, o contador de caracteres avisa se o texto cabe nos limites da Meta. Para o envio em si, vale ler como fazer disparo em massa no WhatsApp e comparar os melhores disparadores ou os melhores chatbots para WhatsApp. Se o volume ainda é pequeno, a lista de transmissão resolve sem API. Veja também todas as ferramentas grátis.

Perguntas frequentes

Como apuramos

A lista de DDD e a regra do nono dígito vêm da Anatel; o fim da On-Premises API, o comportamento do erro 131026 e o formato E.164 vêm da documentação da Meta, tudo conferido em 13 de agosto de 2026. A inconsistência do identificador interno em DDD 31 ou maior não está em documento da Meta: ela é descrita por provedores de API e aparece em chamados abertos de bibliotecas não oficiais, e por isso a tratamos como informação de terceiros, exibida como alternativa e não como correção automática.

O que não medimos: não testamos taxa de acerto de serviços pagos de higienização, não rodamos HLR lookup e não temos número próprio de quantos contatos repetidos existem numa base brasileira típica. O cenário da clínica usa proporções declaradas como premissa, e a matemática em cima delas é conferível linha a linha.

A ferramenta em si passou por uma bateria de casos antes de sair do ar de testes: número com e sem 55, com zero de operadora na frente, com DDD inexistente, celular de oito dígitos, fixo, sequência repetida, número local sem DDD e a lista de exemplo com três grafias do mesmo celular. Os seis exemplos da aba Lista são exatamente esses casos, deixados no campo para você conferir o comportamento sem digitar nada.

Fontes

• Anatel, Nono Dígito (formato 9XXXX-XXXX concluído em 14/02/2017)
• Meta, On-Premises API Sunset (encerramento em 23/10/2025)
• Meta, referência do endpoint Contacts da On-Premises API
• Meta, códigos de erro da Cloud API (131026, mensagem não entregue)
• Gupshup, inconsistência do dígito 9 no Brasil e do dígito 1 no México
• ABR Telecom, Consulta Número (base de portabilidade)
• Meta, preços por mensagem entregue

Regras e tarifas conferidas em 13 de agosto de 2026. A Meta revisa preço e política sem aviso, e a Anatel pode abrir novos códigos de área. Confira antes de fechar orçamento ou reprovar um cadastro. Nosso método de checagem está em como avaliamos.