> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Política anti-banimento

> Como reduzir risco de bloqueio no WhatsApp: ritmo humano, aquecimento e boas práticas.

<Tip>
  WhatsApp não é megafone. Quanto mais o envio parecer **robô**, maior o risco. A Notifique coloca **freios** entre seu código e o destinatário, fila, delay e limites.
</Tip>

## Em poucas palavras

* O risco existe nos dois modos; **não oficial** exige mais cuidado com volume e chip novo.
* Na **oficial**, a Meta também aplica regras (templates, 24h, pagamento, qualidade).
* Você precisa de **opt-in**, conteúdo permitido e uso gradual em números novos.
* A Notifique **não garante** zero bloqueio se o uso violar políticas.

Modos de conexão: [Modos de conexão](/whatsapp-api/como-funciona/modos-de-conexao).

***

## O que aumenta o risco

| Comportamento                                          | Risco                   |
| ------------------------------------------------------ | ----------------------- |
| Centenas de mensagens iguais em segundos               | Alto                    |
| Campanha enorme em **um número só**                    | Alto                    |
| Chip **novo** + API no mesmo dia                       | Alto                    |
| Mensagem para quem **nunca falou** com você            | Alto                    |
| Volume **distribuído**, com pausa entre lotes          | Menor (com aquecimento) |
| Resposta a quem **já entrou em contato** ou deu opt-in | Menor                   |

<Warning>
  Siga as [políticas da Meta](https://www.whatsapp.com/legal/business-policy) e os [Termos](https://app.notifique.dev/terms) da Notifique. Opt-in e conteúdo lícito não são opcionais.
</Warning>

***

## Números e chips novos

Chips e contas Business **novas** são vigiados com mais rigor. A plataforma aplica **warm-up automático** (20 msgs/dia nos primeiros 3 dias), é um **teto de segurança**, não meta para o dia 1.

### Antes de conectar à API (3–7 dias)

Use o número **no celular**, sem API:

1. Complete o perfil (foto, nome, descrição)
2. Converse **manualmente** com contatos reais
3. Evite ativar o chip e conectar na API **no mesmo dia**

### Depois de conectar

| Período      | O que fazer                                                                                         |
| ------------ | --------------------------------------------------------------------------------------------------- |
| **Dia 0**    | Só testes internos, **sem** campanha                                                                |
| **Dias 1–3** | Poucos envios (ideal **5–10**/dia), conteúdo variado                                                |
| **Dias 4–7** | Aumente aos poucos se não houver falhas                                                             |
| **Depois**   | Escale com [Sending Pools](/whatsapp-api/como-funciona/sending-pools) quando o chip estiver estável |

Consulte `warmup` em **GET /v1/whatsapp/instances/:id** (`active`, `sentToday`, `daysRemaining`).

### Opt-in e conversas

| Tipo de envio                              | Precisa de opt-in? |
| ------------------------------------------ | ------------------ |
| OTP, status de pedido, boleto              | Não (transacional) |
| Marketing / promoção                       | **Sim**            |
| Prospecção fria (“Olá, somos a empresa X”) | **Evite**          |

A Notifique não bloqueia automaticamente todo cold outreach, **você** modela consentimento no produto. Webhooks de mensagem recebida ajudam a saber quem já abriu conversa.

***

## Como a Notifique ajuda

| Proteção                | O que faz                                                  |
| ----------------------- | ---------------------------------------------------------- |
| **Smart Delay**         | Pausa calculada antes de enviar (ritmo menos robótico)     |
| **Fila com prioridade** | OTP pode usar `"priority": "high"`, só o urgente           |
| **Sending Pools**       | Divide volume entre vários números                         |
| **Retentativas**        | Backoff (30 s → 5 min → 30 min → 2 h), não loop infinito   |
| **Circuit breaker**     | Número com muita falha pausa **no pool**; os outros seguem |

<Info>
  Com `instanceId` fixo, o pool não entra. Pools são **opcionais**. Detalhes: [Sending Pools](/whatsapp-api/como-funciona/sending-pools).
</Info>

***

## Só na conexão não oficial

| Regra                           | Resumo                                                                      |
| ------------------------------- | --------------------------------------------------------------------------- |
| **Um chip por instância**       | Depois do primeiro pareamento, troque de número = **nova instância**        |
| `expectedPhoneNumber`           | Opcional na criação; chip errado → `PHONE_NUMBER_MISMATCH`                  |
| **Cooldown de reconexão (6 h)** | Queda involuntária bloqueia novo código por um tempo (`RECONNECT_COOLDOWN`) |
| **Desconexão manual**           | Via API **não** aplica esse cooldown                                        |
| **Warm-up 3 dias**              | 20 envios/dia (`WARMUP_DAILY_LIMIT` ao estourar)                            |

<Warning>
  Tela de **banimento** no celular? Não fique pedindo código na mesma instância. Aguarde ou use **outro número** saudável.
</Warning>

***

## Só na conexão oficial

A Meta controla qualidade, templates e cobrança:

| Requisito                                | Por quê                                                |
| ---------------------------------------- | ------------------------------------------------------ |
| Template **aprovado** fora da janela 24h | Sem isso → `META_TEMPLATE_REQUIRED`                    |
| Cartão no gerenciador do WhatsApp        | Sem isso → `META_PAYMENT_METHOD_REQUIRED`              |
| Opt-in em marketing                      | Política Meta + menos denúncia                         |
| Token válido na instância                | Expirado → `META_TOKEN_EXPIRED` / `META_TOKEN_INVALID` |

Detalhes: [Templates oficiais Meta](/whatsapp-api/como-funciona/templates-oficiais-meta).

<Note>
  Sandbox (`sk_test_`) **não** valida gates Meta de verdade. Em produção (`sk_live_`), trate `META_*` como conta ou política Meta.
</Note>

***

## Códigos de erro relacionados

| `code`                  | HTTP | O que fazer                                       |
| ----------------------- | ---- | ------------------------------------------------- |
| `PHONE_NUMBER_MISMATCH` | 409  | Chip errado, use o número certo ou nova instância |
| `RECONNECT_COOLDOWN`    | 429  | Aguarde `retryAfterSec` antes de novo código      |
| `WARMUP_DAILY_LIMIT`    | 429  | Limite diário de warm-up, envie amanhã (UTC)      |

Catálogo completo (pools, Meta, campanhas): [Respostas de erro](/guides/conceitos/resposta-de-erros).

***

## Boas práticas

1. **Aqueça o chip** no celular antes da API
2. **Comece devagar** na API (5–10 envios/dia nos primeiros dias)
3. **Priorize** quem já falou com você ou deu opt-in
4. **Separe** transacional de marketing (instância, pool ou prioridade)
5. **Monitore** webhooks de falha (`message.failed`)
6. Use **idempotência** para não duplicar envio

***

## O que a Notifique não faz

* Não garante zero bloqueio com conteúdo ou volume abusivo
* Não substitui **consentimento** do destinatário
* Não controla banimento ou qualidade decididos pela Meta na linha oficial

***

## Próximos passos

* [Introdução](/whatsapp-api/como-funciona/introducao): visão geral do canal
* [Quick Start](/whatsapp-api/como-funciona/quick-start): conectar e enviar
* [Sending Pools](/whatsapp-api/como-funciona/sending-pools): vários números
* [Templates oficiais Meta](/whatsapp-api/como-funciona/templates-oficiais-meta): linha oficial