Check status

Description

Returns the session status for a referenceId on an agent with custom channel enabled. This endpoint is a controlled query: it requires the same HMAC signature as send interaction. Channel credentials.auth is not required here (it only applies to outbound calls to your webhook).

Endpoint

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

Path parameters

string

required

Agent identifier.

Body parameters

string

required

Same user identifier you used when sending the interaction.

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.

`status` values

Value	Meaning
`running`	A flow execution is in progress.
`pending_input`	The agent is waiting for a user reply.
`idle`	No active execution and no pending input.

Request example

cURL

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

Responses

Code	Status	Description
200	OK	Status returned.
400	Bad Request	Missing `referenceId`.
401	Unauthorized	Invalid, missing, or unresolvable signature.
500	Internal Server Error	Could not read status.

Response example

{
  "status": "pending_input"
}

⌘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

`status` values

Request example

Responses

Response example

​Description

​Endpoint

​Path parameters

​Body parameters

​Authentication / signature

​status values

​Request example

​Responses

​Response example

Description

Endpoint

Path parameters

Body parameters

Authentication / signature

`status` values

Request example

Responses

Response example