Los webhooks le permiten recibir notificaciones en tiempo real cuando alguien envía un mensaje de WhatsApp a su número o cuando cambia el estado de entrega de un mensaje saliente.
Cómo funciona
Cuando se produce un evento (p. ej., un mensaje entrante o una actualización de estado de entrega), seven envía una solicitud HTTP POST a la URL de webhook que haya configurado. Su servidor procesa la carga y responde con un código de estado 2xx para confirmar la recepción.
Configurar su URL de webhook
- Inicie sesión en dashboard.seven.io.
- Vaya a Ajustes > Webhooks.
- Introduzca su URL de webhook: debe ser un endpoint HTTPS accesible públicamente en su servidor.
- Seleccione los tipos de evento que desea recibir.
- Guarde la configuración.
Asegúrese de que su endpoint es accesible y responde en un tiempo razonable (menos de 10 segundos). Si su endpoint no es accesible o devuelve errores de forma reiterada, la entrega de webhooks puede pausarse.
Tipos de evento
Mensaje entrante (wa_mo)
Se activa cuando un usuario envía un mensaje de WhatsApp a su número conectado. La carga útil incluye el número de teléfono del remitente, el contenido del mensaje, el tipo de mensaje y la marca de tiempo.
Informes de entrega
Se activa cuando cambia el estado de un mensaje saliente. Los estados incluyen:
- sent: el mensaje se envió a los servidores de WhatsApp
- delivered: el mensaje se entregó al dispositivo del destinatario
- read: el destinatario ha leído el mensaje
- failed: el mensaje no se pudo entregar
Formato de la carga útil
Las cargas útiles de los webhooks se envían como JSON en el cuerpo de una solicitud POST. Una carga útil típica de mensaje entrante incluye:
{
"event": "wa_mo",
"from": "491701234567",
"to": "491709876543",
"timestamp": "2026-01-15T10:30:00Z",
"message": {
"type": "text",
"text": "Hello, I have a question about my order."
}
}La estructura exacta de la carga útil puede variar en función del tipo de mensaje y del evento. Consulte la documentación de la API para ver el esquema completo.
Lectura adicional
Para información detallada sobre autenticación, comportamiento de reintentos y la especificación completa de la carga útil, consulte la documentación de la API de seven.