Estado de Aircall
Ayuda para iniciar sesiónLa API de Analytics, disponible para los clientes de Analytics+, te permite extraer métricas de llamadas y usuarios directamente a tus propias herramientas de informes, sin exportar manualmente los datos desde el Panel de control de Aircall. Puedes automatizar extracciones recurrentes con una frecuencia diaria, semanal o mensual y usar los datos para crear informes personalizados adaptados a tu negocio.
En este artículo se explica lo que ofrece la API de Analytics, cómo funciona y qué debes tener en cuenta al configurar exportaciones automatizadas.
Importante: La API de Analytics está disponible exclusivamente para clientes con el complemento A+. Si no estás seguro de si tu plan incluye A+, contacta con el equipo de customer success.
Qué puedes exportar
La API te da acceso a tres categorías de datos:
- Historial de llamadas: Registros detallados de llamadas entrantes y salientes.
- User Status History+: Un registro del estado de disponibilidad de los agentes a lo largo del tiempo.
- Actividad de usuario: Un conjunto de métricas de rendimiento por usuario, incluidos volúmenes de llamadas, tiempo en llamada, tiempo de trabajo posllamada, intentos de timbrado y tiempo dedicado a cada estado.
Cada categoría se corresponde con los informes disponibles en tu Panel de control de Aircall. Para ver la lista completa de informes exportables y sus correspondientes valores de parámetros de la API, consulta la documentación de la API de Analytics.
Filtros y parámetros
Toda solicitud a la API requiere los siguientes parámetros:
- Tipo de informe: El informe específico que quieres exportar. Consulta la lista completa en la documentación de la API de Analytics.
- Intervalo de fechas: El período de tiempo que debe cubrir la exportación.
- Zona horaria: La zona horaria aplicada a los datos. Si no se especifica, el valor predeterminado es UTC.
También puedes pasar filtros opcionales para acotar los resultados, en línea con los filtros disponibles para cada informe en el Panel de control de Aircall. Los filtros opcionales disponibles varían según el tipo de informe. Consulta la documentación de la API de Analytics para ver la lista completa por informe.
Importante: Las solicitudes a las que les falte un parámetro obligatorio fallarán. Prueba cada tipo de informe con todos los parámetros requeridos antes de programar exportaciones automatizadas.
Cómo funciona la API
La API sigue un flujo sencillo de solicitud y descarga:
Pasos:
- Autentica tu solicitud con tus credenciales de API. Puedes encontrarlas en tu Panel de control de Aircall, en Integraciones & API.
- Llama al único endpoint, pasando como parámetros el tipo de informe elegido, un intervalo de fechas obligatorio y una zona horaria.
- Recibe una respuesta que contiene un enlace prefirmado a un archivo CSV.
- Descarga el CSV desde ese enlace. El enlace caduca 1 hora después de generarse, así que diseña tu flujo de trabajo para descargarlo inmediatamente después de cada respuesta correcta.
La programación no está incorporada en la API. Si quieres exportaciones diarias, semanales o mensuales, debes configurar esa automatización por tu cuenta usando tu propia infraestructura o una herramienta de programación de terceros.
Para ver la autenticación, los detalles del endpoint y la referencia completa de parámetros, consulta la documentación de la API de Analytics.
Retención de datos
Los datos disponibles a través de la API siguen los mismos límites de retención que el Panel de control de Aircall:
| Categoría de datos | Período de retención |
|---|---|
| Historial de llamadas | 6 meses |
| User Status History+ | 7 días |
| Actividad de usuario | Ilimitado |
Buenas prácticas
Las siguientes recomendaciones se aplican tanto si ejecutas exportaciones puntuales como si estás creando una canalización totalmente automatizada.
Programa las exportaciones fuera del horario de atención
Siempre que sea posible, activa las exportaciones automatizadas fuera del horario de atención. Esto reduce el riesgo de retrasos durante períodos de alta carga de la API y ayuda a garantizar una disponibilidad de datos constante.
Descarga inmediatamente después de cada solicitud
El enlace de descarga caduca al cabo de 1 hora. Diseña tu automatización para descargar el archivo en cuanto se reciba la respuesta de la API, en lugar de guardar el enlace para recuperarlo más tarde.
Comprueba los límites de filas de tu sistema de destino
La API no impone un límite de filas en las exportaciones. Sin embargo, algunas herramientas de importación y aplicaciones de hojas de cálculo limitan el número de filas que pueden procesar. Verifica los límites de tu sistema de destino antes de ejecutar exportaciones grandes en producción.
Haz pruebas antes de automatizar
Ejecuta manualmente cada tipo de informe antes de programar exportaciones recurrentes. Esto te ayuda a detectar pronto parámetros ausentes o incorrectos, antes de que provoquen fallos silenciosos en un flujo de trabajo automatizado.
Preguntas frecuentes
¿La API incluye un programador integrado?
No. La API devuelve datos a petición. Tú eres responsable de configurar cualquier automatización recurrente (diaria, semanal, mensual) por tu cuenta.
¿Por qué el enlace de descarga caduca al cabo de 1 hora?
La corta duración de validez es una medida de seguridad para proteger tus datos. Asegúrate de que tu flujo de trabajo descargue el archivo inmediatamente después de recibir una respuesta correcta de la API.
¿Puedo usar la API de Analytics sin el complemento A+?
No. A+ es obligatorio. Ponte en contacto con nuestro equipo de customer success para hablar sobre tus opciones. También puedes solicitar una prueba para explorar el complemento.
Los datos que necesito no aparecen en mi exportación. ¿Qué debo comprobar?
Primero, confirma que el complemento correspondiente (User Status History+ o Actividad de usuario) está activo en tu cuenta. Después, verifica tu intervalo de fechas, zona horaria y cualquier filtro opcional con la documentación de la API de Analytics.