Send interaction

Description

Your app sends an interaction to the agent. Jelou validates the HMAC signature, responds immediately with 202 and an executionId, and processes the flow asynchronously. Agent replies arrive later on your webhookUrl.

Endpoint

POST https://chatbot.jelou.ai/v1/custom-channel/{botId}

Path parameters

string

required

Agent identifier with custom channel enabled.

Body parameters

string

required

Stable user identifier in your system. Used as userId in outbound deliveries and to check session status.

object

required

Message payload forwarded to the agent flow. A typical text example is { "type": "TEXT", "text": "Hello" }.

Authentication / signature

Include the required header:

X-Jelou-Signature: sha256=<HMAC_HEX>

The signature is computed over the exact raw body of the request (HMAC-SHA256). Details in HMAC signature. Channel credentials.auth is not required on this endpoint; it only applies to Jelou’s outbound calls to your webhook.

Request example

cURL

curl --request POST \
  --url https://chatbot.jelou.ai/v1/custom-channel/BOT_ID \
  --header 'Content-Type: application/json' \
  --header 'X-Jelou-Signature: sha256=HMAC_HEX' \
  --data '{
    "referenceId": "user-123",
    "message": {
      "type": "TEXT",
      "text": "Hello"
    }
  }'

Responses

Code	Status	Description
202	Accepted	Interaction accepted. The flow runs in the background.
400	Bad Request	Missing or empty `referenceId`.
401	Unauthorized	Invalid, missing, or unresolvable signature.
500	Internal Server Error	Internal error (for example, channel not resolved).

Response example

{
  "executionId": "EXECUTION_ID"
}

A 202 does not mean the flow finished successfully. Use check status and/or wait for delivery on your webhook.

⌘I

API reference

Send Messages

Campaigns

Conversations

Metrics

Users

Resources

Widget

Datum

External Support Panel

Custom Channel

Memory Management

Description

Endpoint

Path parameters

Body parameters

Authentication / signature

Request example

Responses

Response example

​Description

​Endpoint

​Path parameters

​Body parameters

​Authentication / signature

​Request example

​Responses

​Response example

Description

Endpoint

Path parameters

Body parameters

Authentication / signature

Request example

Responses

Response example