Webhooks
Los webhooks te permiten recibir notificaciones en tiempo real cuando ocurren eventos en tu cuenta de Platica. Configura un endpoint propio para recibir eventos de conversaciones, mensajes, comentarios, clientes, anuncios de Meta y WhatsApp Flows dinámicos.
Cómo empezar
- Crea un webhook con
POST /v1/webhooks. - Elige los eventos desde la lista de
GET /v1/webhooks/events. - Valida la firma con el
secretconfigurado en tu webhook. - Procesa el
payloadsegún el tipo de evento recibido.
Consejo
La mayoría de eventos sólo notifican que algo ocurrió. Los eventos de WhatsApp Flows son especiales porque tu endpoint debe responder con un JSON para continuar el flow. Esa diferencia se explica en WhatsApp Flows .
Endpoints disponibles
| Método | Endpoint | Descripción |
|---|---|---|
GET | /v1/webhooks | Listar todos los webhooks |
GET | /v1/webhooks/{id} | Obtener un webhook específico |
POST | /v1/webhooks | Crear un nuevo webhook |
PATCH | /v1/webhooks/{id} | Actualizar un webhook |
DELETE | /v1/webhooks/{id} | Eliminar un webhook |
GET | /v1/webhooks/events | Listar eventos disponibles |
Siguientes lecturas
| Página | Cuándo usarla |
|---|---|
| Listar eventos | Ver los 22 eventos disponibles en 6 categorías |
| Entrega y firmas | Validar autenticidad y entender headers / envelope de un webhook normal |
| Payloads | Revisar la estructura de conversation.*, message.*, comment.*, client.* y referral.received |
| WhatsApp Flows | Implementar flows dinámicos con respuesta requerida |