Status do número e da conta no WhatsApp API: como ler e o que fazer

O que significa o status do número na API do WhatsApp?

Quando se fala em status de número na API, existem três perguntas diferentes, e misturar as três é o que gera confusão:

• O número está conectado e pode enviar? É o estado operacional: registrado, verificado, com nome de exibição e pagamento ok. Para usar a API, o número precisa estar conectado (connected).
• Existe algum impedimento ou limitação agora? É a leitura da Health Status API: Available, Limited ou Blocked, calculada considerando todos os itens envolvidos no envio.
• As pessoas estão gostando das mensagens? É a qualidade (verde, amarela, vermelha). Esse assunto tem página própria: qualidade do número do WhatsApp API. Aqui o foco é o painel de status e o que fazer quando ele mostra problema.

Como consultar o status pela Health Status API?

A Meta oferece o campo health_status em três tipos de item: a conta do WhatsApp Business, o número comercial e o template. A resposta informa se uma mensagem vai conseguir sair, levando em conta todos os itens envolvidos: o número, o template, a conta do WhatsApp, o portfólio empresarial e o app. O campo can_send_message traz um de três valores:

O status geral é o pior entre os itens: basta um bloqueado para o geral aparecer como BLOCKED, e basta um limitado para aparecer como LIMITED. Por isso um número saudável pode aparecer travado por causa de um template não aprovado, de um problema no portfólio ou no app. A consulta é uma chamada de leitura simples:

GET /<ID_DO_NUMERO>?fields=health_status

O que conferir na resposta:
- can_send_message do número: AVAILABLE, LIMITED ou BLOCKED
- entidades listadas: PHONE_NUMBER, WABA, BUSINESS, APP (e MESSAGE_TEMPLATE, se consultar um template)
- se LIMITED: ler additional_info
- se BLOCKED: ler errors (error_code, error_description, possible_solution)
- depois de corrigir: consultar de novo e registrar a data e a resposta

O que impede um número de ficar conectado e enviar?

Quando o envio falha, o código de erro costuma apontar o item que está fora do status. Os mais comuns, segundo a documentação da Meta:

Número banido no WhatsApp é outro caso: precisa de recurso antes de ser registrado na API. E a qualidade baixa deixou de reduzir o limite de envio em 7 de outubro de 2025, mas continua pesando em outros pontos: templates ruins são pausados (3 horas na primeira vez, 6 horas na segunda e desativação na terceira) e a subida de limite exige qualidade alta.

Que avisos (webhooks) a Meta envia sobre número e conta?

Quem só abre o painel de vez em quando descobre o problema depois do prejuízo. Os webhooks avisam na hora. Os campos mais úteis para a rotina de disparo:

Um detalhe prático: as notificações de violação também chegam por e-mail aos administradores do portfólio. Se o endereço cadastrado é de alguém que saiu da empresa, o aviso se perde. Mais sobre o webhook em geral em webhook do WhatsApp API.

Que rotina de checagem evita surpresa no dia do disparo?

1. 1
   Três dias antes

   Confira o nome de exibição, a forma de pagamento e o status dos templates da campanha. A análise de um template pode levar até 24 horas, e template reprovado precisa de ajuste. Veja template reprovado.

2. 2
   Um dia antes

   Consulte a Health Status API do número e do template. Se aparecer LIMITED, corrija ainda hoje.

3. 3
   No dia, antes do primeiro lote

   Repita a consulta e confira o limite de envio disponível frente ao tamanho da base. Veja limite de envio.

4. 4
   Entre os lotes

   Olhe falhas e respostas. Se o erro de limite por pessoa (131049) aparecer, não insista no mesmo contato: a orientação da Meta é esperar pelo menos 24 horas.

5. 5
   Depois do disparo

   Registre o resultado e o que mudou no painel. Compare com o relatório. Veja métricas de campanha de WhatsApp.

[ ] Número conectado (connected) e sem aviso no WhatsApp Manager
[ ] Nome de exibição aprovado
[ ] Forma de pagamento ativa, sem pendência
[ ] Health Status do número: AVAILABLE (se LIMITED, ler additional_info)
[ ] Templates da campanha aprovados e fora de pausa
[ ] Limite de envio maior que o tamanho do lote do dia
[ ] Webhooks ligados e alerta chegando para quem responde
[ ] E-mails dos administradores do portfólio atualizados
[ ] Base com opt-in e sem quem pediu para sair
[ ] Quem atende as respostas escalado para o horário do envio

O que fazer quando o status aparece como Limited ou Blocked?

1. Não reenvie em loop. Insistir com quem já está no limite de marketing por pessoa pode bloquear novas tentativas para aquele contato por até 24 horas (erro 131049).
2. Leia a causa. Em LIMITED, o campo additional_info; em BLOCKED, o array errors com código, descrição e solução sugerida.
3. Aplique a solução sugerida e consulte de novo para confirmar a mudança de status.
4. Se a causa é política ou spam, siga o roteiro de recurso em conta restrita.
5. Se a causa é template, ajuste o texto, a categoria e as variáveis e submeta de novo.
6. Se a causa é opt-in ou reclamação, revise a base antes da próxima campanha. Veja opt-in no WhatsApp.

Quem dispara pela AD PRO precisa vigiar o status do número?

Para entender como a AD PRO trabalha por completo, veja empresa de disparo em massa, o hub de disparo em massa e a página sobre disparo em massa agendado.