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

# Plantillas de WhatsApp

> Crea, consulta y envía plantillas aprobadas de WhatsApp mediante canales conectados a Visito.

Usa plantillas para mensajes proactivos fuera de la ventana de atención: confirmaciones, instrucciones de llegada, recordatorios de pago o códigos de acceso.

## Requisitos

* Canal de WhatsApp conectado y activo.
* Token M2M almacenado en el servidor.
* Scopes adecuados.
* Plantilla aprobada por Meta antes del envío.

## Endpoints

| Operación         | Endpoint                                    | Scope                      |
| ----------------- | ------------------------------------------- | -------------------------- |
| Listar plantillas | `GET /whatsapp-templates/{channelId}`       | `whatsapp_templates:read`  |
| Crear plantilla   | `POST /whatsapp-templates/{channelId}`      | `whatsapp_templates:write` |
| Enviar plantilla  | `POST /whatsapp-templates/{channelId}/send` | `whatsapp_templates:send`  |

Al crear una plantilla, usa nombre, idioma, categoría y componentes compatibles con Meta. La creación inicia el proceso de revisión y no implica aprobación inmediata.

Incluye `Idempotency-Key` al enviar. Una respuesta `202` significa que el mensaje está en cola. Guarda los identificadores de solicitud para reconciliación.

## Reglas de envío

* Envía solo plantillas con estado `APPROVED`.
* Comprueba que variables, idioma y número del huésped sean correctos.
* Reutiliza el mismo cuerpo y la misma clave al reintentar.
* Respeta `retryAfterSeconds` cuando aparezca en un error de límite.
* No marques un mensaje como entregado basándote únicamente en el `202`.