Solução de problemas
Número restrito ou banido
Como reconhecer e tratar um número restrito, bloqueado ou banido pela Meta.
Cada sintoma abaixo segue o mesmo formato: o que você vê, a causa e o que fazer.
Onde ver o que está acontecendo
Seção intitulada “Onde ver o que está acontecendo”Na página da conexão, aba Visão geral, o card Saúde mostra:
- Qualidade, Faixa de envio e Velocidade;
- Envio: Liberado, Limitado ou Bloqueado;
- Restrição, com o prazo (
Até {data}) ou “Sem prazo informado”; - a lista O que está bloqueado ou limitado, agrupada por Número, Conta do WhatsApp, Empresa e App, cada item com o código da Meta, a descrição e a solução sugerida;
- O que continua funcionando.
O Messajo lê a saúde a cada 15 minutos. Atualizar saúde lê na hora.
A conexão aparece como Restrita ou Desativada
Seção intitulada “A conexão aparece como Restrita ou Desativada”| Status | Motivo (reason) |
O que fazer |
|---|---|---|
| Restrita | account_restriction: a Meta restringiu a conta por um prazo |
Esperar o prazo e corrigir a causa no Gerenciador do WhatsApp |
| Restrita | policy_blocked: a Meta bloqueou um envio por política (368 ou 131031) |
Idem |
| Desativada | violation:<tipo> ou banned |
Recorrer na Meta. Se ela reativar (reinstated), a conexão volta a Ativa sozinha |
| Ativa | restriction_lifted: a restrição acabou |
Nada |
scheduled_for_disable avisa antes: a Meta agendou a desativação da conta, sem mudar o status.
Enquanto a conexão está restrita, os envios voltam 403 policy_blocked ou 409 connection_restricted. Desativada, 409 connection_disabled.
Envio Limitado ou Bloqueado, sem mudar o status
Seção intitulada “Envio Limitado ou Bloqueado, sem mudar o status”A conexão segue Ativa, mas o Envio mudou. O Messajo emite connection.updated com reason can_send_changed. Os casos que o painel explica:
- Sem forma de pagamento (código
141006): a empresa não pode iniciar conversas (templates). Respostas a clientes que escreveram nas últimas 24 h continuam funcionando. Ação: Adicionar forma de pagamento no Meta Business. - Empresa não verificada (código
141010): limites de envio menores. Os envios dentro do limite atual continuam. Ação: verificar a empresa.
Para o erro de envio por falta de pagamento, veja também meta_payment_required.
Qualidade ou faixa de envio mudaram
Seção intitulada “Qualidade ou faixa de envio mudaram”O Messajo emite connection.updated com reason quality_changed (qualidade) ou limit_changed (faixa de envio ou capacidade). Entenda a faixa em Limite de mensagens da Meta.
Sinais de spam nos envios
Seção intitulada “Sinais de spam nos envios”429meta_spam_rate_limited(Meta131048): muitas mensagens do número foram denunciadas ou bloqueadas. Não reenvie. As campanhas pausam sozinhas. Revise a lista (só quem deu opt-in), o conteúdo do template e a frequência, e espere a qualidade se recuperar.422marketing_limit_reached(Meta131049): a Meta segurou o template de marketing para proteger o engajamento do contato. Não reenvie na hora.
O que o Messajo faz sozinho
Seção intitulada “O que o Messajo faz sozinho”- Manda e-mail para donos e admins a cada mudança de status (no máximo um por motivo a cada 6 h).
- Emite eventos
connection.*com o motivo emreason.
O que o Messajo não faz
Seção intitulada “O que o Messajo não faz”Não levanta restrição nem reverte banimento. Recursos e contestações são feitos nas ferramentas da Meta, no Gerenciador do WhatsApp.
Receber o aviso no seu sistema
Seção intitulada “Receber o aviso no seu sistema”Crie um destino global que assine os eventos de conexão:
{ "connection_id": null, "event_types": ["connection.*", "org.*"] }Cada evento traz data.connection.status, previous_status e reason. A tabela completa está em Motivos da conexão.