Complementos

Webhooks salientes

Configura el secreto de firma, los webhooks y sus entregas en Administración → Configuración de la empresa.

Dónde configurar

Ve a Administración → Configuración de la empresa (/company-settings) y abre la pestaña Webhooks.

(Disponible para administradores de la empresa.)

Secreto de firma: créalo o regenéralo. Cada entrega se firma para que tu sistema verifique que viene de whapi.chat. Al regenerarlo, el anterior deja de valer de inmediato.
Webhooks: con Agregar webhook indicas una URL (ej. https://tu-sistema.com/webhooks/whapi) y los eventos que quieres recibir. Un webhook puede escuchar varios eventos; cada evento solo puede estar en un webhook.
Entregas: consulta los intentos y el payload enviado, prueba un webhook con Probar y reintenta las entregas fallidas con Reintentar.

Evento	Cuándo se envía
Lead creado	Se creó un lead, a mano o automáticamente.
Lead actualizado	Cambió un lead, sus contactos, canales o campos personalizados.
Estado de plantilla WABA	Meta aprobó, rechazó o pausó una plantilla, o cambió su calidad.
Mensaje WABA recibido	Un cliente escribió a una de tus líneas de WhatsApp Business API.
Estado de mensaje WABA (Waba API)	Cambió el estado de un mensaje enviado con la WABA API.
Estado de cuenta WABA	Una cuenta de WhatsApp Business se desconectó, necesita reconexión, quedó limitada o volvió a operar.
Estado de número WABA	Cambió la conexión, el registro, la calidad, el nombre visible o la modalidad de un número.

Copia el secreto de firma y guárdalo en tu servidor.
Implementa la verificación de firma en tu receptor. La guía técnica, con ejemplos en Node.js y Python, está en whapi.chat/desarrolladores/webhooks.
Agrega un webhook y marca los eventos que necesites (puedes repartirlos en varios webhooks si van a sistemas distintos).
Pulsa Probar y revisa las entregas.

Los webhooks notifican cambios hacia afuera. Si necesitas consultar o actualizar datos desde un sistema externo, usa la API pública.