Eventos Disponibles
Puedes suscribirte a cualquiera de estos eventos al crear o actualizar tu webhook.
Mensajes
Eventos relacionados con el envío y recepción de mensajes.
| Evento | Descripción |
|---|
message.received | Un cliente envió un mensaje |
message.sent | Un mensaje fue enviado (manual o por IA) |
message.delivered | WhatsApp confirmó la entrega |
message.read | El cliente leyó el mensaje |
message.failed | El mensaje no se pudo enviar |
El evento message.received incluye el mensaje en formato Meta original. Ver Payloads para detalles.
Conversaciones
Eventos relacionados con la gestión de conversaciones.
| Evento | Descripción |
|---|
conversation.created | Nueva conversación iniciada |
conversation.assigned | Conversación asignada a un agente |
conversation.unassigned | Conversación desasignada |
conversation.closed | Conversación cerrada |
Eventos relacionados con la gestión de contactos.
| Evento | Descripción |
|---|
contact.created | Nuevo contacto creado |
contact.updated | Contacto actualizado |
contact.deleted | Contacto eliminado |
Eventos relacionados con envíos masivos.
| Evento | Descripción |
|---|
broadcast.sent | Broadcast iniciado |
broadcast.completed | Broadcast completado |
broadcast.failed | Broadcast falló |
Wildcard
Para suscribirte a todos los eventos, usa el wildcard:
| Evento | Descripción |
|---|
* | Recibe todos los eventos |
El wildcard puede generar un alto volumen de requests. Úsalo con precaución.
Ejemplo de Suscripción
curl -X POST https://api.whaapy.com/user-webhooks \
-H "Authorization: Bearer wha_TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Todos los mensajes",
"url": "https://mi-servidor.com/webhooks",
"events": ["message.received", "message.sent", "message.delivered", "message.read"]
}'
Próximos Pasos
