Exportación cualitativa
Exportar mensajes
Exporta mensajes de chat como stream NDJSON para análisis cualitativo con IDs anonimizados
GET
Descripción
Exporta mensajes de chat como un stream NDJSON (Newline-Delimited JSON) para análisis cualitativo. Todos los IDs de personas se anonimizan automáticamente con HMAC-SHA256.Header de autenticación
string
requerido
Tu API Key de Mindo. Acepta dos tipos:
- Global (cross-company):
mindo_global_<key>— acceso a todas las empresas - De empresa:
mindo_xxxxxxxxxxxxxxxxxxxxxxxx— acceso limitado a la empresa asociada
Query parameters
string
requerido
ID de empresa. Acepta un entero o lista separada por comas:
42 o 42,57.string
requerido
Fecha/hora de inicio (ISO-8601, inclusive). Ejemplo:
2026-04-01T00:00:00Z.string
requerido
Fecha/hora de fin (ISO-8601, exclusivo). Debe ser mayor que
from. Máximo 31 días de rango.string
predeterminado:"all"
Filtro de plataforma:
whatsapp, instagram, messenger, all.string
Filtrar por agente IA. Un entero o lista CSV:
5 o 5,12.string
predeterminado:"all"
Dirección del mensaje:
incoming, outgoing, all.string
predeterminado:"classifications"
Campos extras a incluir (CSV):
classifications, extractions, tool_calls, trace_id.string
Cursor de paginación obtenido de
next_cursor en la respuesta anterior.integer
predeterminado:"5000"
Cantidad máxima de filas por llamada. Rango: 1–10000.
Respuesta
La respuesta es un stream NDJSON. Cada línea es un objeto JSON con los siguientes campos:string
ID anonimizado del mensaje (
msg_<24 hex chars>).string
ID anonimizado del chat (
conv_<24 hex chars>).string
Timestamp ISO-8601 de cuándo se envió el mensaje.
string
Plataforma:
META_WHATSAPP, WHATSAPP_EVOLUTION, INSTAGRAM, MESSENGER, MANYCHAT_WHATSAPP, MANYCHAT_INSTAGRAM.string
"inbound" (del contacto) o "outbound" (del sistema/agente/operador).object
Quién envió el mensaje.
object
Datos del agente IA (solo si el mensaje fue generado por un agente).
object
Contenido del mensaje.
object
Contexto de la conversación.
object
Datos de exportación.
Campos opcionales (parámetro include)
Estos campos solo aparecen si se solicitan en el parámetro include.
array
Clasificaciones aplicadas al mensaje (incluido por defecto).
array
Datos extraídos del mensaje por extractores de custom fields.
array
Herramientas ejecutadas por el agente IA durante la generación del mensaje.
string
ID de traza en Langfuse para debugging. Solo tiene valor en mensajes outgoing generados por un agente IA.
Paginación
La paginación es cursor-based. Si hay más resultados, la última línea del stream es un sentinel:cursor=<next_cursor> para obtener la página siguiente. Cuando no hay sentinel, se agotaron todos los datos.
Anonimización de IDs
La anonimización es determinista por empresa, irreversible y consistente entre exportaciones.
Mapeo de canales
Errores mid-stream
Si ocurre un error después de que el stream ya comenzó, se emite como una línea NDJSON adicional:Límites
Casos de uso
Análisis de calidad de respuestas de agentes
Análisis de calidad de respuestas de agentes
Exportar solo mensajes outgoing de un agente específico con tool_calls para evaluar qué herramientas usó y con qué éxito:
Dataset de entrenamiento para clasificadores
Dataset de entrenamiento para clasificadores
Exportar mensajes incoming con sus clasificaciones para evaluar o reentrenar modelos:
Auditoría cross-platform
Auditoría cross-platform
Exportar todos los mensajes de múltiples empresas para auditoría comparativa:
Debugging de agentes con Langfuse
Debugging de agentes con Langfuse
Exportar mensajes con
trace_id para correlacionar con trazas en Langfuse:
