Skip to main content
Use notifications to directly obtain the status of sent messages. They allow you to obtain relevant information, such as the number of messages read from your individual, bulk, or campaign messages. By using notifications, you can understand user behavior and use that information to improve your marketing campaign or choose a better message type to be more precise in your communications. You can get specific information about a notification by its ID or all notifications to populate your database or Dashboard.

​
Get Notifications

This endpoint allows you to retrieve previously sent notifications. 
GET https://api.jelou.ai/v1/external/bots/{botId}/notifications

​
Path Parameters

PropertyTypeDescriptionRequired
botIdstringBot ID.Yes

​
Query Parameters

PropertyTypeDescriptionRequired
messageIdstringMessage ID.No
campaignIdstringCampaign ID.No
elementNamestringElement name.No
fromdateStart date.No
todateEnd date.No
limitnumberPagination limit (Max: 50).No
pagenumberPage number (Default: 1).No

​
Request Example

curl --request GET \
  --url 'https://api.jelou.ai/v1/external/bots/BOT_ID/notifications?limit=50&from=2024-01-01&to=2024-12-31&page=1' \
  --header 'Authorization: Basic {{Base64EncodedUsername:Password}}'

​
Message status list

StatusDescription
DELIVERED_CHANNELThe message was received by WhatsApp.
DELIVERED_USERThe message was received by the user.
READThe user read the message.
REPLYThe user replied to the message.
CREATEDThe message was received by Jelou.
FAILEDThe message could not be delivered.

​
Message read status

StatusDescription
trueThe user read the message.
falseThe user has not read the message.

​
API Responses

The payload contains the following fields:
PropertyDescription
sentStatusTemplate delivery status.
createdAtMessage send date.
deliveryChannelAtDelivery date to the WhatsApp channel.
deliveryUserAtMessage delivery date by WhatsApp.
readAtDate the message was read by the user.
destinationUser’s phone number.
elementNameTemplate name.
idMessage ID.
errorReason for template delivery failure (if applicable).
replyUser’s response (available when status is REPLY).

​
Metrics analysis

Analyze delivery, read, and response rates to optimize future campaigns.
Use notification data to:
  • Measure engagement: Calculate the percentage of messages read vs. delivered.
  • Identify issues: Detect invalid or blocked numbers through FAILED errors.
  • Optimize schedules: Analyze timestamps to find the best send times.
  • Improve content: Use responses (REPLY) to understand which messages generate the most interaction.