Skip to main content

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.

Notification URLs let you send WhatsApp events to external systems in real time. From Settings you can create a URL associated with a specific bot.
This gives you independent control based on the flow or use case.

​
What are they used for?

They allow your system to automatically receive information when an event occurs in a campaign or message. For example:
  • Confirm that a message was read
  • Detect a send failure
  • Record when a user replies
All without manual intervention.

​
How to configure a notification URL

When creating a new URL you will need to:
  1. Select the type of event you want to receive:
    • Read
    • Failed
    • Reply
    • All (includes all events)
  2. Enter the destination URL (endpoint).
  3. Define the authentication type the endpoint will use.
Each configuration is done per bot, which allows you to customize the integration according to the logic of each flow.
To receive Read events, the WhatsApp user must have read receipts (blue checkmarks) enabled on their device. If the user has this option disabled, the platform will not receive the read notification and, therefore, the event will not be sent to your notification URL.

​
Benefits

Greater flexibility
You can define a URL for a specific event or group all of them into one. More security
Configure the authentication method that best suits your technical environment. Simpler administration
Fewer duplicate configurations and better organization. Better operational experience
Clear interface to manage notifications in an organized and efficient way.
Notification URLs are key when you need to integrate Jelou with a CRM, internal systems, or real-time analytics tools.

​
Event examples

Below are examples of the payload you will receive at your notification URL depending on the event type:
Sent when the message could not be delivered.
{
  "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"
}
Sent when the message was delivered to the channel (WhatsApp).
{
  "id": "f777ebe8-41f5-4ffd-9c86-*********",
  "status": "DELIVERED_CHANNEL",
  "timestamp": "1777326454",
  "campaignId": "69efd9747eba1414ecbc66d2",
  "destination": "5939800000000",
  "isFinalEvent": true,
  "template": "template_name"
}
Sent when the message was delivered to the user’s device.
{
  "id": "78518db4-4f5d-451f-a4ad-*********",
  "status": "DELIVERED_USER",
  "timestamp": "1777326039",
  "campaignId": "69efd7d4b5095a8*********",
  "destination": "5939800000000",
  "isFinalEvent": true,
  "template": "plantilla_lto_kevin_ai"
}
Sent when the user read the message.
{
  "id": "c3eca84b-3fcf-4038-80e7-*********",
  "status": "READ",
  "timestamp": "1777326047",
  "campaignId": "69efd5bfc2da2*********",
  "destination": "5939800000000",
  "isFinalEvent": true,
  "template": "template_name"
}
This event is only received if the user has read receipts (blue checkmarks) enabled in WhatsApp.
Sent when the user replies to the message.
{
  "id": "f777ebe8-41f5-4ffd-9c86-*********",
  "campaignId": "69efd9747eba141*********",
  "reply": "button_name",
  "template": "template_name",
  "timestamp": "1777326462",
  "status": "REPLY",
  "isFinalEvent": true,
  "destination": "5939800000000"
}