Setting up your Webhook

Webhooks are powerful when receiving and sending messages on WhatsApp. They can be employed for various purposes, such as data synchronization, real-time notifications, and automation.

Webhooks are used in a wide range of applications, including messaging platforms like WhatsApp, social media, e-commerce, and more. They can be harnessed to perform intelligent actions based on inbound and outbound messages.

A webhook is a mechanism for one application to provide real-time data to another application. It is essentially an HTTP callback, where one application (the provider) sends data to a specific URL (the endpoint) in response to events or requests from another application (the consumer).

Webhooks are typically implemented using the HTTP protocol. When an event occurs, the provider sends an HTTP POST request to the consumer's specified endpoint, containing relevant data in the request body.

For setting up your webhook you have to use the following endpoint:

Set Webhook Url

POST https://api.jelou.ai/v1/bots/:botId/webhook/

Endpoint for setting up your webhook for receiving user messages.

Path Parameters

Name	Type	Description
botId	string	Bot id

Request Body

Name	Type	Description
webhookUrl	string	Url of the webhook|endpoint where the messages are going to be forwarded.

200 Success changing your webhookUrl

{
  "message": [
    {
      "webhookUrl": "<url>"
    }
  ],
  "status": "success"
}

500 Failed to set settings.

{
  "message": [
    "Couldn't set setting"
  ],
  "status": "failed"
}

Warning: The server will retry the post to your server 3 times if it doesn't get status code 200 as a response.