Skip to main content
La API de Conversaciones te permite acceder al historial completo de interacciones, gestionar el estado de las conversaciones, evaluar respuestas y exportar datos.

Endpoints disponibles

Listar conversaciones

Obtener todas las conversaciones con filtrado y paginación.

Crear conversación

Crear una nueva conversación programáticamente.

Obtener mensajes

Obtener los mensajes de una conversación específica.

Actualizar metadata

Actualizar la metadata de una conversación.

Actualizar estado masivo

Actualizar el estado de múltiples conversaciones.

Exportar

Exportar conversaciones como archivo ZIP con CSVs.

Evaluar respuesta

Evaluar la calidad de una respuesta del agente.

Evaluar con LLM

Ejecutar evaluación completa usando LLM-as-Judge.

Resumen de endpoints

MétodoEndpointDescripción
GET/v2/conversationsListar conversaciones
POST/v2/conversationsCrear conversación
GET/v2/conversations/{id}/messagesObtener mensajes
PATCH/v2/conversations/{id}/metadataActualizar metadata
POST/conversations/update-statusActualizar estado masivo
POST/conversations/exportExportar conversaciones
POST/conversations/eval-answerEvaluar respuesta de mensaje
POST/conversations/{id}/evaluateEvaluar conversación con LLM

Canales disponibles

CanalDescripción
apiConversaciones iniciadas via API
websiteWidget de chat en sitio web
whatsappWhatsApp Business API
instagramInstagram Messaging
telegramTelegram Bot
dashboardDesde el dashboard de Horneross
agent_builderDesde el constructor de agentes

Estados de conversación

EstadoDescripción
UNRESOLVEDConversación activa, esperando respuesta o acción
RESOLVEDMarcada como resuelta por el agente o usuario
HUMAN_REQUESTEDEl usuario solicitó intervención humana