Consultar estado

Descripción

Devuelve el estado de la sesión asociada a un referenceId para un agente con canal personalizado. Este endpoint es una consulta controlada: exige la misma firma HMAC que enviar interacción. La autenticación credentials.auth del canal no se exige aquí (solo aplica a las llamadas salientes hacia tu webhook).

Endpoint

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

Parámetros de ruta

string

requerido

Identificador del agente.

Parámetros del cuerpo

string

requerido

Mismo identificador de usuario que usaste al enviar la interacción.

Autenticación / firma

Incluye el header obligatorio:

X-Jelou-Signature: sha256=<HMAC_HEX>

La firma se calcula sobre el raw body exacto de la petición (HMAC-SHA256). Detalles en Firma HMAC.

Valores de `status`

Valor	Significado
`running`	Hay una ejecución del flujo en curso.
`pending_input`	El agente espera una respuesta del usuario.
`idle`	No hay ejecución activa ni espera de input.

Ejemplo de solicitud

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"
  }'

Respuestas

Código	Estado	Descripción
200	OK	Estado devuelto.
400	Bad Request	Falta `referenceId`.
401	Unauthorized	Firma inválida, ausente o no se pudo resolver la clave.
500	Internal Server Error	No se pudo leer el estado.

Ejemplo de respuesta

{
  "status": "pending_input"
}

⌘I

API reference

Envío de mensajes

Campañas

Conversaciones

Métricas

Usuarios

Recursos

Widget

Datum

Panel de Atención Externo

Canal Personalizado

Gestión de Memoria

Descripción

Endpoint

Parámetros de ruta

Parámetros del cuerpo

Autenticación / firma

Valores de `status`

Ejemplo de solicitud

Respuestas

Ejemplo de respuesta

​Descripción

​Endpoint

​Parámetros de ruta

​Parámetros del cuerpo

​Autenticación / firma

​Valores de status

​Ejemplo de solicitud

​Respuestas

​Ejemplo de respuesta

Descripción

Endpoint

Parámetros de ruta

Parámetros del cuerpo

Autenticación / firma

Valores de `status`

Ejemplo de solicitud

Respuestas

Ejemplo de respuesta