Resumen
Los webhooks en Wati te permiten recibir actualizaciones en tiempo real sobre los mensajes y sus estados enviando datos de eventos a tu servidor. Esta guía explica qué eventos puedes rastrear, cómo configurar un webhook y cómo funcionan las devoluciones de llamada basadas en la sesión para que puedas procesar de forma fiable la actividad de los mensajes en tu sistema.
Instrucciones
¿Qué eventos pueden capturar los webhooks?
Los webhooks de Wati pueden notificar a tu sistema cuando ocurren los siguientes eventos:
Mensajes recibidos
Mensajes enviados (mensajes de plantilla y de sesión)
Actualizaciones del estado de los mensajes:
Enviado
Entregado
Leído
Estos eventos se envían a tu URL de webhook configurada como cargas útiles de devolución de llamada.
Cómo añadir un webhook en Wati
Sigue estos pasos para configurar un webhook:
Inicia sesión en tu panel de control de Wati.
Ve a Conectores y haz clic en Webhooks en el menú de navegación superior.
Haz clic en Añadir Webhook.
Introduce la URL completa de tu webhook.
Establece el estado en Activado.
Selecciona los eventos que quieres capturar.
Haz clic en Guardar.
Cómo probar tu webhook
Después de añadir el webhook, puedes probar la conexión:
Utiliza la opción Activar devolución de llamada de muestra.
Wati enviará una carga útil de muestra a la URL de tu webhook.
Verifica que tu servidor recibe y procesa la carga útil correctamente.
Comprender los webhooks basados en la sesión
En la API de WhatsApp Business, las conversaciones se rastrean como sesiones de 24 horas. Una sesión comienza cuando se entrega un mensaje de empresa.
Tipos de sesiones
Sesión activa
Tanto la empresa como el cliente han intercambiado al menos un mensaje.
Ejemplo: Una empresa envía un mensaje de plantilla y el cliente responde.
Sesión inactiva
Solo una de las partes ha enviado un mensaje y la otra no ha respondido.
Ejemplo: Una empresa envía un mensaje de plantilla, pero el cliente no responde.
Nota: Los callbacks de webhook pueden variar dependiendo de si la sesión está activa o inactiva.
Respuesta del webhook y lógica de reintento
Para garantizar una entrega fiable, tu webhook debe responder correctamente.
Tu servidor debe devolver una respuesta
200 OKpara confirmar que el evento se ha recibido.
Si no se recibe una respuesta
200:Wati reintenta enviar el evento.
Los reintentos pueden ocurrir hasta 144 veces.
Los intentos de reintento se ejecutan a intervalos de 10 minutos.
Si hay más de 100 fallos consecutivos:
El webhook se marca como Defectuoso.
Recibirás una notificación por correo electrónico.
Si todos los intentos de reintento fallan, el evento dejará de enviarse.
Buenas prácticas
Asegúrate de que tu punto final de webhook esté siempre disponible y responda.
Registra las cargas útiles entrantes para facilitar la depuración.
Gestiona los eventos duplicados, ya que los reintentos pueden enviar la misma carga útil más de una vez.
Valida las solicitudes entrantes para asegurarte de que proceden de Wati.
Esta configuración te ayuda a mantener tus sistemas sincronizados con la actividad de mensajería en tiempo real en Wati.
Preguntas frecuentes (FAQ)
Visión general de los webhooks
1. ¿Qué hacen los webhooks en Wati?
Los webhooks en Wati envían actualizaciones en tiempo real sobre los mensajes y sus estados a tu servidor mediante la entrega de datos de eventos a una URL de webhook configurada.
2. ¿Qué tipos de eventos pueden capturar los webhooks de Wati?
Los webhooks de Wati pueden capturar los siguientes eventos:
Mensajes recibidos
Mensajes enviados (mensajes de plantilla y de sesión)
Actualizaciones del estado de los mensajes, incluyendo Enviado, Entregado y Leído
Configuración y prueba de webhooks
3. ¿Cómo se añade y se prueba un webhook en Wati?
Para añadir y probar un webhook en Wati:
Inicia sesión en tu panel de control de Wati.
Ve a Conectores y haz clic en Webhooks.
Haz clic en Añadir Webhook.
Introduce la URL de tu webhook y establece el estado en Activado.
Selecciona los eventos que quieres capturar y haz clic en Guardar.
Utiliza la opción Activar devolución de llamada de muestra para enviar una carga útil de muestra.
Verifica que tu servidor recibe y procesa la carga útil correctamente.
Webhooks basados en la sesión
4. ¿Qué es una sesión en la API de WhatsApp Business?
Una sesión es una ventana de conversación de 24 horas que comienza cuando se entrega un mensaje de empresa.
5. ¿Cuál es la diferencia entre una sesión activa y una sesión inactiva?
Una sesión activa se produce cuando tanto la empresa como el cliente han intercambiado al menos un mensaje. Una sesión inactiva se produce cuando solo una de las partes ha enviado un mensaje y la otra no ha respondido.
Fiabilidad del webhook y reintentos
6. ¿Qué respuesta debe devolver tu servidor para una entrega de webhook correcta?
Tu servidor debe devolver una respuesta 200 OK para confirmar que el evento de webhook se ha recibido.
7. ¿Qué ocurre si tu servidor no devuelve una respuesta 200 OK?
Si tu servidor no devuelve una respuesta 200 OK, Wati reintenta enviar el evento hasta 144 veces a intervalos de 10 minutos.
8. ¿Qué ocurre si la entrega del webhook sigue fallando?
Si hay más de 100 fallos consecutivos, el webhook se marca como Defectuoso y se envía una notificación por correo electrónico. Si todos los intentos de reintento fallan, el evento dejará de enviarse.
Buenas prácticas
9. ¿Cómo puedes garantizar un procesamiento fiable del webhook?
Para garantizar un procesamiento fiable del webhook:
Mantén tu punto final de webhook disponible y sensible
Registra las cargas útiles entrantes para la depuración
Gestiona los eventos duplicados porque los reintentos pueden enviar la misma carga útil más de una vez
Valida las solicitudes entrantes para confirmar que proceden de Wati