Skip to main content
Jelou API is a powerful tool for companies to communicate more professionally and efficiently with their customers through chatbots. It enables the creation of complex, interconnected systems, integrating seamlessly with the Jelou platform, external services, and other systems. Based on REST principles, it facilitates collaboration and information exchange, personalizing messages, maintaining user context, and saving chat history. In practical terms, the Jelou API allows chatbots to communicate with other systems, facilitating collaboration, information exchange, and the execution of various tasks, such as personalizing messages, maintaining user context, or ensuring continuity by saving chat history. This is crucial for developing modern, interconnected applications, enabling a better user experience and multi-turn conversations. The API will always respond with an object and, depending on the context, resources may respond with a simple object or an array of objects.
This API accepts request bodies in JSON format and requires the content to include the Content-Type: application/json header. This header must be specified in every request.

​
Domains

Jelou exposes two domains depending on the endpoint you use:
Each endpoint’s documentation indicates the domain and authentication method that applies to it. Check the Endpoint and Authentication block of each resource.

​
Authentication

The authentication method depends on the endpoint’s domain.

​
Jelou API (api.jelou.ai) legacy

Clients using this API receive a client ID and a client secret key for basic authentication. For any api.jelou.ai endpoint, the following header must be added:

​
Example

If your clientId is my_client_id and your clientSecret is my_client_secret:
  1. Join them with a colon: my_client_id:my_client_secret
  2. Encode it in Base64: bXlfY2xpZW50X2lkOm15X2NsaWVudF9zZWNyZXQ=
  3. Include it in the header: Authorization: Basic bXlfY2xpZW50X2lkOm15X2NsaWVudF9zZWNyZXQ=

​
Gateway (gateway.jelou.ai)

Endpoints published on gateway.jelou.ai are authenticated with an API key in the x-api-key header:
See API Keys to create and manage your keys. Each endpoint indicates the scopes it requires.

​
Errors

Jelou uses HTTP standards to report errors. In general:
  • 2XX codes indicate success.
  • 4XX codes indicate client errors.
  • 5XX codes indicate server errors.
When an error occurs, the response includes a JSON object with a code and a detailed description of the problem.

​
Error codes

​
Rate limits

The API has a limit of 5 requests per second.