# 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

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

| 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`](/errors#policy_blocked) ou `409` [`connection_restricted`](/errors#connection_restricted). Desativada, `409` [`connection_disabled`](/errors#connection_disabled).

## 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`](/errors#meta_payment_required).

## 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](/api/limits/#limite-de-mensagens-da-meta).

## Sinais de spam nos envios

- `429` [`meta_spam_rate_limited`](/errors#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`](/errors#marketing_limit_reached) (Meta `131049`): a Meta segurou o template de marketing para proteger o engajamento do contato. Não reenvie na hora.

## 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 em `reason`.

## 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

Crie um [destino](/webhooks/destinations/#global-ou-por-conexão) global que assine os eventos de conexão:

```json
{ "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](/webhooks/events/#motivos-da-conexão).
