API y SDK

Mantén y gestiona conversaciones

Conserva el contexto, consulta el historial y elimina una conversación mediante la API.

Actualizado 3 de agosto de 2026 · 9 min

Continúa una conversación

La primera respuesta devuelve un conversation_id. Inclúyelo en las llamadas siguientes para que el agente conserve el contexto:

{
  "message": "¿Puedes ampliar el segundo punto?",
  "conversation_id": "uuid-de-la-conversacion",
  "metadata": {}
}

No reutilices el mismo identificador entre usuarios o sesiones que no deban compartir contexto.

Consulta los mensajes

GET /v1/agents/{AGENT_ID}/conversations/{CONVERSATION_ID}/messages?page=1&page_size=50

El resultado incluye la conversación, sus mensajes, el total y has_more para paginar historiales largos.

Elimina la conversación

DELETE /v1/agents/{AGENT_ID}/conversations/{CONVERSATION_ID}

Una eliminación correcta responde con estado 204. Utilízala cuando el usuario solicite borrar el diálogo o cuando tu política de retención lo requiera.