Enviar interacción

Descripción

Tu aplicación envía una interacción al agente. Jelou valida la firma HMAC, responde de inmediato con 202 y un executionId, y procesa el flujo de forma asíncrona. Las respuestas del agente llegan después a tu webhookUrl.

Endpoint

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

Parámetros de ruta

string

requerido

Identificador del agente con canal personalizado habilitado.

Parámetros del cuerpo

string

requerido

Identificador estable del usuario en tu sistema. Se usa como userId en las entregas salientes y para consultar el estado de la sesión.

object

requerido

Payload del mensaje. Se reenvía al flujo del agente. Un ejemplo típico de texto es { "type": "TEXT", "text": "Hola" }.

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. La autenticación credentials.auth del canal no se exige en este endpoint: solo aplica a las llamadas salientes de Jelou hacia tu webhook.

Ejemplo de solicitud

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

Respuestas

Código	Estado	Descripción
202	Accepted	Interacción aceptada. El flujo se procesa en segundo plano.
400	Bad Request	Falta `referenceId` o está vacío.
401	Unauthorized	Firma inválida, ausente o no se pudo resolver la clave.
500	Internal Server Error	Error interno (por ejemplo, canal no resuelto).

Ejemplo de respuesta

{
  "executionId": "EXECUTION_ID"
}

Un 202 no garantiza que el flujo terminó con éxito. Usa consultar estado y/o espera la entrega en tu webhook.

⌘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

Ejemplo de solicitud

Respuestas

Ejemplo de respuesta

​Descripción

​Endpoint

​Parámetros de ruta

​Parámetros del cuerpo

​Autenticación / firma

​Ejemplo de solicitud

​Respuestas

​Ejemplo de respuesta

Descripción

Endpoint

Parámetros de ruta

Parámetros del cuerpo

Autenticación / firma

Ejemplo de solicitud

Respuestas

Ejemplo de respuesta