Plantillas de WhatsApp - Visito Documentation

Usa plantillas para mensajes proactivos fuera de la ventana de atención: confirmaciones de pedido, recordatorios de citas, actualizaciones de pago o avisos de cuenta.

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 cliente 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.

Límites de envío

Los límites se calculan por espacio de trabajo y canal de WhatsApp durante una ventana móvil de 24 horas:

Categoría	Límite
`UTILITY`	2,000 envíos
`MARKETING`, `AUTHENTICATION` y envíos antiguos sin categoría	100 envíos compartidos

Cuando se alcanza el límite correspondiente, Visito devuelve 429 con el código WHATSAPP_TEMPLATE_SEND_LIMIT_24H_REACHED. Usa error.details.limit para conocer el límite aplicado y espera error.details.retryAfterSeconds antes de reintentar el mismo cuerpo con la misma Idempotency-Key.