Exportar reportes

CX Inbox permite exportar datos en diferentes formatos para análisis externo, respaldo de configuraciones, o migración entre organizaciones.

Qué puedes exportar

Dato	Formato	Ubicación
Resultados de campaña	CSV	Campañas > Envíos > [campaña] > Exportar
Configuración del bot	JSON	Configuración > Bot > Exportar
Datos vía API	JSON	Endpoints REST con API key

Exportar resultados de campaña

Desde el detalle de cualquier campaña puedes descargar un CSV con el estado de cada destinatario.

Cómo exportar

Ve a Campañas > Envíos
Haz clic en la campaña que quieres exportar
Haz clic en el botón Exportar
Se descarga un archivo CSV

Contenido del CSV

Columna	Descripción
Teléfono	Número del destinatario con código de país
Estado	Enviado, Entregado, Leído o Fallido
Error	Código y mensaje de error (si falló)
Timestamp	Fecha y hora de cada evento de entrega

Usa este archivo para identificar números problemáticos, calcular métricas personalizadas, o importar los resultados a tu CRM.

Exportar configuración del bot

La función de exportación del bot descarga un archivo JSON con toda la configuración, incluyendo intenciones, flujos, herramientas y prompt del sistema. Es útil para:

Crear un respaldo antes de hacer cambios
Migrar la configuración a otra organización
Revisar la configuración fuera de la plataforma

Cómo exportar

Ve a Configuración > Bot > General
Haz clic en Exportar configuración
Se descarga un archivo JSON con toda la configuración

Contenido del JSON

Sección	Qué incluye
systemPrompt	Prompt del sistema completo
intents	Lista de intenciones con nombres, tipo y ejemplos
flowSteps	Flujos completos con pasos de cada intención
tools	Herramientas configuradas (URLs, parámetros, reintentos)
settings	Toggles de habilitación (bot activo, auto-handle, asignación manual)

Importar configuración del bot

Puedes restaurar o migrar una configuración importando un archivo JSON previamente exportado.

Cómo importar

Ve a Configuración > Bot > General
Haz clic en Importar configuración
Selecciona el archivo JSON
Revisa los cambios que se aplicarán
Confirma la importación

Al importar una configuración de bot, los toggles de habilitación se desactivan automáticamente por seguridad. Deberás activar el bot manualmente después de verificar la configuración.

Consideraciones al importar

Aspecto	Comportamiento
Prompt del sistema	Se reemplaza completamente
Intenciones	Se reemplazan todas las existentes
Herramientas	Se reemplazan, pero las URLs de APIs externas deben ser válidas en el nuevo entorno
Bot habilitado	Se desactiva automáticamente para evitar que un bot mal configurado atienda clientes
Auto-handle	Se desactiva automáticamente
Asignación manual	Se desactiva automáticamente

Exportar datos vía API REST

Para exportaciones programáticas o automatizadas, usa la API REST de CX Inbox con API keys.

Requisitos

Crea una API key en Configuración > API Keys (ver API Keys)
Usa el header X-API-Key en tus peticiones

Endpoints útiles para exportación

Recurso	Endpoint	Descripción
Conversaciones	`GET /api/v1/conversations`	Lista de conversaciones con filtros
Mensajes	`GET /api/v1/conversations/:id/messages`	Historial de mensajes de una conversación
Contactos	`GET /api/v1/contacts`	Lista de contactos
Campañas	`GET /api/v1/campaigns`	Lista de campañas con métricas
Plantillas	`GET /api/v1/templates`	Plantillas sincronizadas

Ejemplo de uso

curl -H "X-API-Key: cxi_tu_api_key" \
  https://tu-dominio.com/api/v1/conversations?status=CLOSED&limit=100

La respuesta incluye paginación. Usa los parámetros limit y offset para recorrer todos los resultados.

Para la referencia completa de endpoints, parámetros y respuestas, consulta la documentación de la API.

Buenas prácticas

Recomendación	Detalle
Respaldos regulares	Exporta la configuración del bot antes de cada cambio importante
Nombres descriptivos	Renombra los archivos exportados con fecha (ej: `bot-config-2026-04-22.json`)
Verificar después de importar	Siempre revisa la configuración importada antes de activar el bot
API para automatización	Si necesitas reportes recurrentes, usa la API REST con un script programado en lugar de exportaciones manuales

¿Esta página fue útil?

En esta página