API oficial do WhatsApp

Como validar números de WhatsApp antes de uma campanha

Resposta rápida

Para validar números de WhatsApp antes do disparo, confira em três camadas: o formato do telefone (DDI, DDD e dígitos), a consistência da base (duplicados e números de outro titular) e a entrega real, lendo os status do primeiro lote. Validar não substitui o aceite do contato. A AD PRO valida os números na preparação da base.

Por AD PRO TecnologiaPublicado em 7 min de leitura
Neste conteúdo (9 partes)

O que significa validar números de WhatsApp?

Validar é descobrir, antes de gastar o envio, se cada número da lista tem chance real de chegar à pessoa certa. São duas perguntas diferentes: o número está escrito de um jeito que o WhatsApp entende? E ele pertence à pessoa que aceitou receber a mensagem? A primeira se resolve na planilha. A segunda exige olhar a origem do contato e o resultado do envio.

A validação é um passo da higienização da base de contatos. Ela vem depois de padronizar o telefone e de remover duplicados, e antes do teste e do envio.

Quais são as três camadas de validação?

Camadas de validação de números de WhatsApp
CamadaO que checaComo se fazO que ela não resolve
1. FormatoDDI 55, DDD, 11 dígitos de celular, nada de letrasFórmulas na planilha (veja formato de telefone para disparo)Número bem escrito que não existe ou é de outra pessoa
2. ConsistênciaDuplicados, linhas com o mesmo número em formatos diferentes, número que não bate com o cadastroRemoção de duplicados e conferência de amostraNúmero que mudou de dono sem o cadastro saber
3. Entrega realSe a mensagem chegou ou falhouEnvio em lote pequeno e leitura dos statusNão prova o aceite: entregue não é o mesmo que autorizado

As camadas se completam. A primeira é barata e pega erro de digitação. A terceira é a única que mostra o que acontece com o número de verdade, porque a confirmação final de que um número recebe mensagem vem do envio: ou a mensagem é entregue, ou falha.

Como validar o formato do número na planilha?

O telefone de celular brasileiro, no formato de envio, tem 13 dígitos: 55, o DDD de 2 dígitos e o número de 9 dígitos começando por 9. Uma fórmula simples marca o que foge desse padrão. Ela supõe o telefone já padronizado na coluna A, só com números (as fórmulas de limpeza estão em formato de telefone para disparo).

Fórmula de checagem do formato (Excel e Google Planilhas em português)
Telefone padronizado na coluna A, a partir da linha 2. Na coluna B:

=SE(E(NÚM.CARACT(A2)=13;ESQUERDA(A2;2)="55";EXT.TEXTO(A2;5;1)="9");"FORMATO OK";"REVISAR")

Contar quantos precisam de revisão:
=CONT.SE(B:B;"REVISAR")

Observações:
- se a sua planilha usa vírgula como separador de argumentos, troque ; por ,
- em inglês: IF, AND, LEN, LEFT, MID, COUNTIF
- a fórmula só checa o desenho do número; não prova que ele tem WhatsApp
- fixo e celular sem o 9 caem em REVISAR de propósito: confira à mão

Para ir além da fórmula, filtre a coluna B por REVISAR e olhe os casos um a um. Um telefone sem DDD ou com DDD que não existe é erro de cadastro, e a correção quase nunca é automática.

Por que um número errado é um problema além de não entregar?

Porque o número errado pode ser de outra pessoa. Um dígito trocado na digitação, ou uma linha antiga que mudou de dono, faz a mensagem chegar a alguém que nunca aceitou receber nada da sua empresa. A política do WhatsApp só permite contatar quem passou o número e deu opt-in. Quem recebe sem ter pedido tende a bloquear ou denunciar, e bloqueios e denúncias derrubam a qualidade dos templates.

Pelas regras da Meta, o template com feedback ruim é pausado (3 horas na primeira vez, 6 horas na segunda) e desativado na terceira. O efeito de uma base mal validada, portanto, vai além de uma campanha: pode atingir os modelos que você vai querer usar na próxima. A qualidade do número no WhatsApp API explica como esses sinais pesam.

Como validar na prática com um primeiro lote?

Em vez de disparar a base inteira de uma vez, envie um lote pequeno e leia os resultados antes de seguir. A lógica de dividir o envio está em disparo em lotes. O primeiro lote funciona como validação real: mostra quantos números entregam, quantos falham e se algum erro se repete.

  1. 1
    Separar o lote piloto

    Uma amostra variada da base: contatos novos e antigos, de DDDs diferentes. Evite pegar só os mais recentes.

  2. 2
    Enviar o teste em números reais

    Antes do lote, mande o template para números do time, para conferir texto, variáveis, mídia e links. Veja teste antes do disparo.

  3. 3
    Enviar o lote piloto

    Dispare para a amostra, no horário combinado.

  4. 4
    Ler os status

    Separe enviados, entregues e falhas. A leitura de cada status está em status de mensagem do WhatsApp API.

  5. 5
    Marcar os números que falharam

    Registre na planilha, com a data e o tipo de falha, para não repetir na próxima campanha.

  6. 6
    Seguir com o restante da base

    Se o primeiro lote correu bem, envie os próximos. Se não, corrija antes.

O que fazer com os números que falham?

Primeiro, descubra o tipo de falha. Nem toda falha significa número inválido. Há um caso específico que as pessoas confundem: o erro 131049 aparece quando a Meta barra a mensagem de marketing porque a pessoa já recebeu muitas, e não porque o número não existe. Nesse caso, a orientação oficial é esperar pelo menos 24 horas antes de tentar de novo. Insistir pode bloquear novas tentativas para aquela pessoa por até 24 horas.

Como tratar cada resultado do envio
ResultadoO que costuma indicarO que fazer
EntregueA mensagem chegou ao aparelhoManter na base e acompanhar resposta e saída.
Falha sem motivo claroNúmero sem WhatsApp, errado ou desatualizadoMarcar como falha, tirar da próxima campanha ou reconfirmar por outro canal.
Falha 131049Limite de marketing por pessoaEsperar pelo menos 24 horas. Não tratar como número inválido.
Resposta 'não sou essa pessoa'Número de outro titularRemover o contato e corrigir o cadastro de origem.
Resposta 'sair'Pedido de saídaRemover da lista e registrar a data.

O custo também acompanha a entrega: a Meta cobra por mensagem entregue, e na AD PRO o débito do saldo é pelo que foi entregue, comprovado no relatório. O relatório mostra enviados, entregues e evidências, e serve de base para limpar a lista da próxima vez.

Vale usar uma ferramenta de validação de números?

Pode valer, desde que você saiba o que ela faz. Antes de usar qualquer serviço de checagem, faça três perguntas:

  • Como ele descobre se o número tem WhatsApp? Se o método envia algo ao titular, isso é um contato sem aceite.
  • O que ele faz com a sua lista? São dados pessoais dos seus clientes. Pela LGPD, a empresa dona da base é a controladora e quem trata por ela é operadora; confirme o que o serviço faz com os dados.
  • O resultado é confiável? Um número que consta como válido hoje pode mudar de dono depois. Valide perto da data do envio.

Ferramenta nenhuma substitui o aceite. Se o contato não autorizou, validar o número só confirma que a mensagem chegaria a uma pessoa que não pediu para recebê-la.

Como a AD PRO valida os números do cliente?

Acompanhe cada demanda no portal de disparos e, se quiser entender o processo inteiro, abra o serviço de disparo em massa ou o hub de disparo em massa.

Perguntas frequentes

Como saber se um número tem WhatsApp?

A confirmação definitiva vem do envio: a mensagem é entregue ou falha. Antes disso, dá para checar se o número está bem formado (DDI 55, DDD e 9 dígitos de celular) e se não é duplicado. Na AD PRO, a validação acontece na preparação da base, e o envio em lotes confirma o que a planilha não mostra.

Enviar para números sem WhatsApp custa dinheiro?

A Meta cobra por mensagem entregue, então mensagem que não chega não gera cobrança por ela. Na AD PRO, o saldo é debitado conforme as mensagens entregues, e o relatório comprova. O custo real de uma base ruim aparece em outro lugar: tempo gasto, campanha menor do que o esperado e risco de bloqueios quando o número é de outra pessoa.

Validar números dispensa o opt-in?

Não. Validar mostra que o número está correto e parece ativo. O opt-in mostra que a pessoa aceitou receber mensagens da empresa. A política do WhatsApp exige o segundo, e o cliente é quem garante que a base autorizou. Veja o guia de opt-in no WhatsApp.

O erro 131049 quer dizer que o número é inválido?

Não. O 131049 indica que a Meta limitou a mensagem de marketing para aquela pessoa, porque o limite dela foi atingido. A orientação oficial é esperar pelo menos 24 horas antes de reenviar. Marcar o contato como inválido nesse caso faz você perder um contato bom.

Com que frequência devo validar a base?

Antes de cada campanha, principalmente se a base ficou parada. Números mudam de dono e cadastros recebem erros novos toda semana. Quanto mais perto do envio a validação, mais confiável o resultado.

Fontes
AD PRO Tecnologia

Mande a base para a AD PRO validar e disparar

Envie a planilha, a copy e o objetivo da campanha. A AD PRO valida os números, faz o teste com você e dispara pela API oficial no dia e horário combinados.

  • Disparo pela API oficial do WhatsApp, da estrutura da AD PRO
  • Base tratada: sem duplicados, números validados, DDI e DDD padronizados
  • Teste em números reais antes de disparar, com a sua aprovação
  • Preço final já com a tarifa da Meta, pago só pelo que foi entregue
  • Relatório de entrega por campanha

Já é cliente? Crie a demanda, aprove o teste e baixe o relatório no portal de disparos, operado com a Nexor Company, empresa parceira do mesmo grupo.

Suas informações ficam com o time da AD PRO. Nada de spam.