Endpoint
POST /api/conversations/export
Exportá conversaciones como archivo ZIP con archivos CSV individuales por conversación.
Bearer token con tu API key de organización.
Request Body
Filtrar por canal: api, website, whatsapp, dashboard, etc.
Filtrar por prioridad: LOW, MEDIUM, HIGH, URGENT
Filtrar por evaluación de mensajes: good, bad
Filtrar por agente específico
Filtrar por usuario asignado
# Exportar todas las conversaciones
curl -X POST https://app.horneross.com/api/conversations/export \
-H "Authorization: Bearer sk_live_xxx" \
-H "Content-Type: application/json" \
-o conversations.zip \
-d '{}'
# Exportar solo conversaciones de WhatsApp con evaluaciones "good"
curl -X POST https://app.horneross.com/api/conversations/export \
-H "Authorization: Bearer sk_live_xxx" \
-H "Content-Type: application/json" \
-o whatsapp_good.zip \
-d '{
"channel": "whatsapp",
"messageEval": "good"
}'
Response
La respuesta es un archivo ZIP binario que contiene un archivo CSV por cada conversación exportada.
Headers de respuesta:
Content-Type: application/zip
Content-Disposition: attachment; filename=data.zip
Estructura del CSV:
| Columna | Descripción |
|---|
agent_id | ID del agente |
conversation_id | ID de la conversación |
message_id | ID del mensaje |
text | Contenido del mensaje |
from | Origen: human o agent |
sources | Fuentes usadas (JSON) |
evaluation | Evaluación: good, bad, o vacío |
read | Si el mensaje fue leído |
createdAt | Fecha de creación |