Saltar al contenido principal
La misma clave pk_live_… del canal Widget (API) autoriza llamadas directas a la API HTTP del agente — útil para integraciones a medida (formularios propios, sistemas internos, otros bots). El widget web usa exactamente esta API por debajo.
  • Base: https://agents.juryo.ai
  • Autenticación: cabecera Authorization: Bearer pk_live_…
La clave identifica a tu despacho como inquilino. Cualquier sistema que la presente puede iniciar conversaciones con tu agente — igual que cualquier visitante de tu web puede abrir el widget.

Iniciar una sesión

curl -X POST https://agents.juryo.ai/eve/v1/session \
  -H 'Authorization: Bearer pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"message": "Hola, quiero información sobre una reclamación."}'
La respuesta incluye dos valores que reutilizarás:
  • el identificador de sesión, en la cabecera x-eve-session-id
  • un continuationToken en el cuerpo JSON, para continuar la conversación

Seguir la respuesta en directo

La sesión emite eventos NDJSON (application/x-ndjson) mientras el agente trabaja:
curl https://agents.juryo.ai/eve/v1/session/SESSION_ID/stream \
  -H 'Authorization: Bearer pk_live_TU_CLAVE'
Los eventos principales son session.started, message.completed (la respuesta del agente) y session.completed. Los clientes que no muestran texto incremental pueden ignorar los eventos *.appended y quedarse solo con los *.completed.

Enviar un mensaje de seguimiento

Cuando la sesión espera el siguiente mensaje del usuario:
curl -X POST https://agents.juryo.ai/eve/v1/session/SESSION_ID \
  -H 'Authorization: Bearer pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"continuationToken": "TOKEN", "message": "Fue un accidente de tráfico."}'