La API de análisis de Live permite acceder a información detallada sobre agentes, sesiones y métricas operativas para generar reportes personalizados, automatizar análisis o integrarse con otras herramientas de monitoreo.
Importante: su uso requiere conocimientos técnicos.
Para consumir la API necesitas:
- Acceder a la documentación oficial.
- Solicitar el token y el X-token del canal a través de un Service Request en Aivo Support Center.
- Usar un usuario que:
- Esté registrado en el bot correspondiente.
- Tenga permisos habilitados para la sección de Análisis.
Datos clave:
- El token de autenticación tiene una vigencia de 10 horas. Se recomienda incluir una regla en tus servicios para la renovación automática, cuando sea posible.
- Se sugiere utilizar una cuenta de correo corporativa para registrar las credenciales (ej.: nombre@corporativo.com).
Consideraciones técnicas
- Intervalo recomendado para filtrar datos: 7 días. Se puede establecer cualquier rango de tiempo requerido. No obstante, el tiempo de respuesta de la API dependerá del volumen de datos involucrado: a mayor cantidad de información, mayor será el tiempo de procesamiento.
- X-token: debes utilizar el xtoken del bot que tiene activo. Todos los canales del bot comparten el mismo.
- Threads: nuestras APIs soportan 1 solo thread por consulta.
- Disponibilidad: la información no está disponible en tiempo real. Esta API está orientada a consultas y reportes, no a automatizaciones en tiempo real.
Obtendrás la siguiente información:
- GetConversationList: lista de conversaciones filtradas por fecha.
- GetConversationDetail: detalle de una conversación específica.
- GetSLA: nivel de cumplimiento de SLA por grupo.
- GetFeedback: resultados de encuestas.
- GetStats: estado de las conversaciones. Ejemplo: Total de atendidas, Transferidas, etc.
- GetAgentsStats: datos del reporte de agentes para el período determinado.
- GetAgent: información individual de un agente (ej.: nombre, cantidad de simultáneas).
- GetGroup: datos sobre grupos (nombre, tipo de asignación).