> ## 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.

# URLs de notificación

> Envía eventos de tus campañas a sistemas externos en tiempo real.

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.

<Warning>
  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.
</Warning>

## Beneficios

**<u>Mayor flexibilidad</u>**\
Puedes definir una URL para un evento específico o agrupar todos en una sola.

**<u>Más seguridad</u>**\
Configura el método de autenticación que mejor se adapte a tu entorno técnico.

**<u>Administración más simple</u>**\
Menos configuraciones duplicadas y mejor organización.

**<u>Mejor experiencia operativa</u>**\
Interfaz clara para gestionar notificaciones de forma ordenada y eficiente.

<Note>
  Las URLs de notificación son clave cuando necesitas integrar Jelou con CRM, sistemas internos o herramientas de análisis en tiempo real.
</Note>

## 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:

<AccordionGroup>
  <Accordion title="Fallido">
    Se envía cuando el mensaje no pudo ser entregado.

    ```json theme={null}
    {
      "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"
    }
    ```
  </Accordion>

  <Accordion title="Entregado a canal">
    Se envía cuando el mensaje fue entregado al canal (WhatsApp).

    ```json theme={null}
    {
      "id": "f777ebe8-41f5-4ffd-9c86-*********",
      "status": "DELIVERED_CHANNEL",
      "timestamp": "1777326454",
      "campaignId": "69efd9747eba1414ecbc66d2",
      "destination": "5939800000000",
      "isFinalEvent": true,
      "template": "template_name"
    }
    ```
  </Accordion>

  <Accordion title="Entregado a usuario">
    Se envía cuando el mensaje fue entregado al dispositivo del usuario.

    ```json theme={null}
    {
      "id": "78518db4-4f5d-451f-a4ad-*********",
      "status": "DELIVERED_USER",
      "timestamp": "1777326039",
      "campaignId": "69efd7d4b5095a8*********",
      "destination": "5939800000000",
      "isFinalEvent": true,
      "template": "plantilla_lto_kevin_ai"
    }
    ```
  </Accordion>

  <Accordion title="Leído">
    Se envía cuando el usuario leyó el mensaje.

    ```json theme={null}
    {
      "id": "c3eca84b-3fcf-4038-80e7-*********",
      "status": "READ",
      "timestamp": "1777326047",
      "campaignId": "69efd5bfc2da2*********",
      "destination": "5939800000000",
      "isFinalEvent": true,
      "template": "template_name"
    }
    ```

    <Warning>
      Este evento solo se recibe si el usuario tiene habilitadas las **confirmaciones de lectura** (vistos azules) en WhatsApp.
    </Warning>
  </Accordion>

  <Accordion title="Respuesta">
    Se envía cuando el usuario responde al mensaje.

    ```json theme={null}
    {
      "id": "f777ebe8-41f5-4ffd-9c86-*********",
      "campaignId": "69efd9747eba141*********",
      "reply": "button_name",
      "template": "template_name",
      "timestamp": "1777326462",
      "status": "REPLY",
      "isFinalEvent": true,
      "destination": "5939800000000"
    }
    ```
  </Accordion>
</AccordionGroup>