Add-ons
Outbound webhooks
Set up the signing secret, webhooks, and deliveries in Administración → Configuración de la empresa.
Where to set it up
Go to Administración → Configuración de la empresa (/company-settings) and open the Webhooks tab.
(Available to company admins.)
What the tab includes
- Secreto de firma (signing secret): create or regenerate it. Each delivery is signed so your system can verify it comes from whapi.chat. When you regenerate it, the previous one stops working immediately.
- Webhooks: with Agregar webhook you set a URL (e.g.
https://your-system.com/webhooks/whapi) and one event. Each webhook listens to a single event, and each event can have only one webhook. - Entregas (deliveries): review attempts and the payload sent, test a webhook with Probar, and retry failed deliveries with Reintentar.
Available events
| Event | When it is sent |
|---|---|
| Lead creado | A lead was created, manually or automatically. |
| Lead actualizado | A lead, its contacts, channels, or custom fields changed. |
| Estado de plantilla WABA | Meta approved, rejected, or paused a template. |
| Mensaje WABA recibido | A customer wrote to one of your WhatsApp Business API numbers. |
| Estado de mensaje WABA (Waba API) | The status of a message sent with the WABA API changed. |
Recommended flow
- Copy the signing secret and store it on your server.
- Implement signature verification in your receiver. The technical guide, with Node.js and Python examples, is at whapi.chat/desarrolladores/webhooks (Spanish only for now).
- Add one webhook per event you need.
- Click Probar and review the deliveries.
Webhooks notify changes outward. If you need to read or update data from an external system, use the Public API.