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

> Cómo reducir el riesgo de bloqueo de WhatsApp: ritmo humano, calentamiento y buenas prácticas.

<Tip>
  WhatsApp no es un megáfono. Cuanto más parezca un **bot** el envío, mayor el riesgo. Notifique agrega **frenos** entre su código y el destinatario: cola, retraso y límites.
</Tip>

## En breve

* El riesgo existe en ambos modos; **no oficial** necesita más cuidado con el volumen y las SIM nuevas.
* En la línea **oficial**, Meta también aplica reglas (plantillas, ventana de 24 h, facturación, calidad).
* Necesita **suscripción voluntaria**, contenido permitido y uso gradual en números nuevos.
* Notifique **no garantiza** cero bloqueos si el uso viola las políticas.

Modos de conexión: [Modos de conexión](/es/whatsapp-api/como-funciona/modos-de-conexao).

***

## ¿Qué aumenta el riesgo?

| Comportamiento                                          | Riesgo                    |
| ------------------------------------------------------- | ------------------------- |
| Cientos de mensajes idénticos en segundos               | Alto                      |
| Campaña enorme en **un número**                         | Alto                      |
| **SIM nueva** + API el mismo día                        | Alto                      |
| Mensaje a alguien que **nunca le contactó**             | Alto                      |
| Volumen **repartido** entre números con pausas          | Menor (con calentamiento) |
| Responder a quien **ya le escribió** o optó por recibir | Menor                     |

<Warning>
  Siga las [políticas de Meta](https://www.whatsapp.com/legal/business-policy) y los [Términos](https://app.notifique.dev/terms) de Notifique. Opt-in y contenido lícito no son opcionales.
</Warning>

***

## Nuevos números y SIM

Las nuevas SIM y las **nuevas cuentas Business** se vigilan más de cerca. La plataforma aplica un **calentamiento automático** (20 mensajes/día durante los primeros 3 días), un **límite de seguridad**, no un objetivo para el primer día.

### Antes de conectar la API (3 a 7 días)

Utilice el número **en el teléfono**, sin la API:

1. Complete el perfil (foto, nombre, descripción)
2. Chatee **manualmente** con contactos reales
3. Evite activar la SIM y conectar la API **el mismo día**

### Después de conectarse

| Período      | Qué hacer                                                                                             |
| ------------ | ----------------------------------------------------------------------------------------------------- |
| **Día 0**    | Solo pruebas internas, **sin** campaña                                                                |
| **Días 1–3** | Pocos envíos (ideal **5–10**/día), contenido variado                                                  |
| **Días 4–7** | Aumente despacio si no hay fallos                                                                     |
| **Después**  | Escale con [Sending Pools](/es/whatsapp-api/como-funciona/sending-pools) cuando la línea esté estable |

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

### Suscripción y conversaciones

| Tipo de envío                                 | ¿Opt-in necesario? |
| --------------------------------------------- | ------------------ |
| OTP, estado de pedido, factura                | No (transaccional) |
| Marketing / promo                             | **Sí**             |
| Contacto en frío ("Hola, somos la empresa X") | **Evitar**         |

Notifique no bloquea automáticamente todo contacto en frío; **usted** modela el consentimiento en su producto. Los webhooks de mensajes entrantes ayudan a saber quién ya abrió un chat.

***

## Cómo ayuda Notifique

| Protección           | Qué hace                                                       |
| -------------------- | -------------------------------------------------------------- |
| **Smart Delay**      | Pausa calculada antes del envío (ritmo menos robótico)         |
| **Cola prioritaria** | OTP puede usar `"priority": "high"`, solo lo urgente           |
| **Sending Pools**    | Reparte volumen entre varios números                           |
| **Reintentos**       | Backoff (30 s → 5 min → 30 min → 2 h), no bucles infinitos     |
| **Circuit breaker**  | Un número con fallas pausa **en el pool**; los demás continúan |

<Info>
  Con un `instanceId` fijo, el pool no aplica. Los pools son **opcionales**. Detalles: [Sending Pools](/es/whatsapp-api/como-funciona/sending-pools).
</Info>

***

## Solo conexión no oficial

| Regla                            | Resumen                                                                  |
| -------------------------------- | ------------------------------------------------------------------------ |
| **Una SIM por instancia**        | Tras el primer emparejamiento, número nuevo = **nueva instancia**        |
| `expectedPhoneNumber`            | Opcional al crear; SIM incorrecta → `PHONE_NUMBER_MISMATCH`              |
| **Cooldown de reconexión (6 h)** | Caída involuntaria bloquea nuevo código un tiempo (`RECONNECT_COOLDOWN`) |
| **Desconexión manual**           | Vía API **no** aplica ese cooldown                                       |
| **Calentamiento 3 días**         | 20 envíos/día (`WARMUP_DAILY_LIMIT` al exceder)                          |

<Warning>
  **¿Pantalla de prohibición** en el teléfono? No siga pidiendo códigos en la misma instancia. Espere o use otro número **saludable**.
</Warning>

***

## Solo conexión oficial

Meta controla calidad, plantillas y facturación:

| Requisito                                    | Por qué                                                |
| -------------------------------------------- | ------------------------------------------------------ |
| Plantilla **aprobada** fuera de ventana 24 h | Sin ella → `META_TEMPLATE_REQUIRED`                    |
| Tarjeta en WhatsApp Manager                  | Sin ella → `META_PAYMENT_METHOD_REQUIRED`              |
| Opt-in para marketing                        | Política Meta + menos reportes                         |
| Token válido en la instancia                 | Caducado → `META_TOKEN_EXPIRED` / `META_TOKEN_INVALID` |

Detalles: [Plantillas oficiales Meta](/es/whatsapp-api/como-funciona/templates-oficiais-meta).

<Note>
  Sandbox (`sk_test_`) **no** ejecuta puertas Meta reales. En producción (`sk_live_`), trate `META_*` como señales de cuenta o política Meta.
</Note>

***

## Códigos de error relacionados

| `code`                  | HTTP | Qué hacer                                                |
| ----------------------- | ---- | -------------------------------------------------------- |
| `PHONE_NUMBER_MISMATCH` | 409  | SIM incorrecta; use el número correcto o nueva instancia |
| `RECONNECT_COOLDOWN`    | 429  | Espere `retryAfterSec` antes de un nuevo código          |
| `WARMUP_DAILY_LIMIT`    | 429  | Tope diario de calentamiento; envíe mañana (UTC)         |

Catálogo completo (pools, Meta, campañas): [Respuestas de error](/es/guides/conceitos/resposta-de-erros).

***

## Mejores prácticas

1. **Caliente la SIM** en el teléfono antes de la API
2. **Comience lento** en la API (5 a 10 envíos/día los primeros días)
3. **Priorice** a quienes ya se comunicaron o se suscribieron
4. **Separe** transaccional de marketing (instancia, grupo o prioridad)
5. **Supervise** webhooks fallidos (`message.failed`)
6. Utilice **idempotencia** para evitar envíos duplicados

***

## Lo que Notifique no hace

* No garantiza cero bloqueos con contenido o volumen abusivo
* No reemplaza el **consentimiento** del destinatario
* No controla baneos ni decisiones de calidad de Meta en la línea oficial

***

## Próximos pasos

* [Introducción](/es/whatsapp-api/como-funciona/introducao): descripción general del canal
* [Inicio rápido](/es/whatsapp-api/como-funciona/quick-start): conectar y enviar
* [Sending Pools](/es/whatsapp-api/como-funciona/sending-pools): múltiples números
* [Plantillas oficiales Meta](/es/whatsapp-api/como-funciona/templates-oficiais-meta): línea oficial
