> ## Documentation Index
> Fetch the complete documentation index at: https://docs.juryo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API HTTP

> Habla con tu agente desde cualquier sistema mediante la API de sesiones

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_…`

<Note>
  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.
</Note>

## Iniciar una sesión

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
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."}'
```