Skip to main content

​
¿Qué son los webhooks de plantilla?

A diferencia de los webhooks de canal, ofrece webhooks de plantilla: endpoints que reciben exclusivamente los eventos de plantilla de WhatsApp y que no dependen de una instancia (instanceId = null). Conviven con las rutas de webhook por canal, que se mantienen sin cambios. El enrutamiento de los eventos de plantilla lo realiza el servicio interno con independencia de la instancia.
Los conceptos comunes a los dos tipos de webhook (rol ENTERPRISE, autenticación, firma HMAC y formatos de payload) están en la Introducción.

​
Autenticación

Todas las rutas exigen el header:

​
Eventos de plantilla admitidos

Un webhook de plantilla admite únicamente eventos de plantilla. Enviar cualquier evento que no sea de plantilla devuelve 422.

​
Reglas de negocio

  1. Alcance de los eventos (obligatorio).
    • Webhook de plantilla → solo admite eventos de plantilla. Cualquier otro evento → 422.
    • Webhook de canal → no puede suscribirse a eventos de plantilla → 422.
  2. payloadFormat se ignora. En los webhooks de plantilla el formato es siempre DEFAULT. El campo se puede omitir; si se envía (con cualquier valor, incluido CHATWOOT), se descarta de forma silenciosa y se persiste como DEFAULT.
  3. instanceId se guarda como null automáticamente: en estas rutas no hay campo de instancia. channelId también llega como null.

​
Observaciones importantes

Alcance por tenant. Las operaciones de lectura, edición y eliminación están limitadas al tenant resuelto a partir del Authorization: no hay acceso cross-tenant por id.
Caché del enrutador. Tras crear o modificar un webhook de plantilla, el enrutamiento puede tardar hasta unos 5 min en reflejar el cambio (TTL de la caché).

​
Gestión

Crear webhook de plantilla

Registra un nuevo endpoint de plantilla.

Listar webhooks de plantilla

Consulta todos los webhooks de plantilla del tenant.

Consultar webhook de plantilla

Busca un webhook de plantilla concreto.

Actualizar webhook de plantilla

Actualiza la URL, los eventos, la autenticación o el estado.

Eliminar webhook de plantilla

Elimina permanentemente un webhook de plantilla.

Estructura de los payloads

Ejemplos reales de los payloads que se reciben para cada evento de plantilla.