Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt

Use this file to discover all available pages before exploring further.

Las URLs de notificación te permiten enviar eventos de WhatsApp a sistemas externos en tiempo real. Desde Configuraciones puedes crear una URL asociada a un bot específico.
Esto te da control independiente según el flujo o caso de uso.

​
¿Para qué sirven?

Permiten que tu sistema reciba información automáticamente cuando ocurre un evento en una campaña o mensaje. Por ejemplo:
  • Confirmar que un mensaje fue leído
  • Detectar un fallo en el envío
  • Registrar cuando un usuario responde
Todo sin intervención manual.

​
Cómo configurar una URL de notificación

Al crear una nueva URL deberás:
  1. Seleccionar el tipo de evento que deseas recibir:
    • 📩 Leído
    • ❌ Fallido
    • 💬 Respuesta
    • 📌 Todos (incluye todos los eventos)
  2. Ingresar la URL destino (endpoint).
  3. Definir el tipo de autenticación que utilizará el endpoint.
Cada configuración se realiza por bot, lo que permite personalizar la integración según la lógica de cada flujo.
Para recibir eventos de tipo Leído, el usuario de WhatsApp debe tener habilitada la función de confirmaciones de lectura (vistos azules) en su dispositivo. Si el usuario tiene esta opción desactivada, la plataforma no recibirá la notificación de lectura y, por lo tanto, el evento no se enviará a tu URL de notificación.

​
Beneficios

Mayor flexibilidad
Puedes definir una URL para un evento específico o agrupar todos en una sola. Más seguridad
Configura el método de autenticación que mejor se adapte a tu entorno técnico. Administración más simple
Menos configuraciones duplicadas y mejor organización. Mejor experiencia operativa
Interfaz clara para gestionar notificaciones de forma ordenada y eficiente.
Las URLs de notificación son clave cuando necesitas integrar Jelou con CRM, sistemas internos o herramientas de análisis en tiempo real.

​
Ejemplos de eventos

A continuación se muestran ejemplos del payload que recibirás en tu URL de notificación según el tipo de evento:
Se envía cuando el mensaje no pudo ser entregado.
{
  "id": "c75170d3-917d-48a4-8b15-*********",
  "status": "FAILED",
  "error": "buttons: Button at index 0 of type Url requires a parameter",
  "timestamp": "1777325700",
  "campaignId": "69efd6834d469ea6*********",
  "destination": "5939800000000",
  "isFinalEvent": true,
  "template": "autentica_01"
}
Se envía cuando el mensaje fue entregado al canal (WhatsApp).
{
  "id": "f777ebe8-41f5-4ffd-9c86-*********",
  "status": "DELIVERED_CHANNEL",
  "timestamp": "1777326454",
  "campaignId": "69efd9747eba1414ecbc66d2",
  "destination": "5939800000000",
  "isFinalEvent": true,
  "template": "template_name"
}
Se envía cuando el mensaje fue entregado al dispositivo del usuario.
{
  "id": "78518db4-4f5d-451f-a4ad-*********",
  "status": "DELIVERED_USER",
  "timestamp": "1777326039",
  "campaignId": "69efd7d4b5095a8*********",
  "destination": "5939800000000",
  "isFinalEvent": true,
  "template": "plantilla_lto_kevin_ai"
}
Se envía cuando el usuario leyó el mensaje.
{
  "id": "c3eca84b-3fcf-4038-80e7-*********",
  "status": "READ",
  "timestamp": "1777326047",
  "campaignId": "69efd5bfc2da2*********",
  "destination": "5939800000000",
  "isFinalEvent": true,
  "template": "template_name"
}
Este evento solo se recibe si el usuario tiene habilitadas las confirmaciones de lectura (vistos azules) en WhatsApp.
Se envía cuando el usuario responde al mensaje.
{
  "id": "f777ebe8-41f5-4ffd-9c86-*********",
  "campaignId": "69efd9747eba141*********",
  "reply": "button_name",
  "template": "template_name",
  "timestamp": "1777326462",
  "status": "REPLY",
  "isFinalEvent": true,
  "destination": "5939800000000"
}