Pular para o conteúdo

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.

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.

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.

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.

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.

  • 429 meta_spam_rate_limited (Meta 131048): 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.
  • 422 marketing_limit_reached (Meta 131049): a Meta segurou o template de marketing para proteger o engajamento do contato. Não reenvie na hora.
  • 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 em reason.

Não levanta restrição nem reverte banimento. Recursos e contestações são feitos nas ferramentas da Meta, no Gerenciador do WhatsApp.

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.