Reportes de Sellia
Esta API permite a los desarrolladores y analistas acceder a métricas detalladas, tiempos de respuesta y volúmenes de mensajería a través del "Conversation Insights".
Objetivo Principal
El objetivo de esta API es ofrecer una visión granular y cuantitativa del rendimiento de las operaciones de comunicación. A diferencia de la API Central (que gestiona el flujo de mensajes en tiempo real), el propósito de este servicio es la consulta histórica y el análisis de datos. Su función principal es proveer métricas clave —como tiempos de espera, duración de las interacciones y conteo de mensajes por tipo— permitiendo evaluar la eficiencia de los agentes, el impacto de las campañas y la salud de los canales de comunicación.
Utilidad Práctica
La utilidad de esta guía está orientada a desarrolladores que construyen paneles de control (dashboards), sistemas de reporte automatizado o integraciones con herramientas de Business Intelligence (BI). Es ideal para:
Monitoreo de KPIs de Atención Medir la calidad del servicio a través de métricas precisas como
seconds_first_response(tiempo de primera respuesta),seconds_inqueue(tiempo en cola) yseconds_inprogress(duración de la atención).Auditoría de Productividad Analizar el desempeño de los agentes y bots mediante el desglose de mensajes enviados (texto, imágenes, plantillas) y el tiempo total que una conversación estuvo asignada a un responsable.
Análisis de Campañas y Canales Filtrar y comparar el rendimiento de diferentes estrategias de marketing (
campaign) o puntos de contacto (channel), identificando cuáles generan mayor volumen de interacción o cierres exitosos.Exportación de Datos Servir como fuente de datos estructurados para alimentar sistemas externos de almacenamiento de datos o generar reportes periódicos de actividad.
Tokens de Acceso
Al igual que la API Central, este servicio utiliza tokens de acceso JWT (JSON Web Token) bajo el esquema HTTPBearer. El token debe ser incluido en la cabecera Authorization de todas las solicitudes. Ejemplo: Authorization: Bearer <tu_token_jwt>. Es fundamental asegurar que el usuario asociado al token tenga los permisos necesarios para visualizar los datos de la empresa solicitada.
Paginación
El endpoint principal de listado (GET /api/reports/conversation-insights) utiliza paginación basada en número de página. A diferencia de la paginación por cursor, aquí debes especificar:
page: El número de la página que deseas consultar (por defecto 1).page_size: La cantidad de registros por página (por defecto 20, con un máximo de 100).
La respuesta incluirá metadatos (PaginationMeta) indicando el total de ítems, el total de páginas y si existen páginas siguientes o anteriores (has_next, has_prev).
Secciones
Esta es la funcionalidad central de la API para la inteligencia de negocios. Permite consultar un listado paginado y detallado de las conversaciones.
Consulta de Insights: A través de este recurso es posible obtener métricas específicas de cada interacción, como quién la inició, tiempos desglosados (en bot, en cola, asignado) y conteo de tipos de mensajes.
Filtrado Avanzado: Soporta filtros por rangos de fecha (
start_date,end_date), así como por contexto de negocio: campaña, canal y estado de la conversación.
La documentación de la API de Reportes ofrece una solución analítica integral que centraliza la inteligencia operativa de las interacciones omnicanal. Permite a los desarrolladores construir herramientas de monitoreo y análisis de rendimiento de forma eficiente, fundamentando la toma de decisiones estratégicas sobre una única plataforma de datos unificada.
Last updated