API de Reportes
Cómo consultar por API los reportes de conversaciones, agentes y horas pico de Omnifox.
Mira este paso en el video · CRM y calendario por API
La API de Reportes te da acceso a las mismas métricas que ves en la sección de Reportes del panel, para alimentar tu propio dashboard de BI o exportarlas a una hoja de cálculo periódicamente.
Requisitos
- Token Bearer del workspace.
- Definir un rango de fechas (con
presetofrom/to).
Endpoints principales
GET /api/v1/reports/overview— resumen general (volumen, tiempos de respuesta, resolución).GET /api/v1/reports/conversations— métricas de conversaciones por canal/estado.GET /api/v1/reports/agents— desempeño por agente (asignadas, cerradas, tiempo de primera respuesta).GET /api/v1/reports/heatmap— mapa de calor de volumen de mensajes por hora/día, útil para dimensionar turnos.GET /api/v1/crm/reports/funnely/forecast— reportes específicos del CRM (ver artículo de API del CRM).
Parámetros comunes a todos los reportes
| Parámetro | Descripción |
|---|---|
workspace_id |
Workspace a consultar (opcional; usa el actual del token) |
preset |
Rango predefinido: today, yesterday, 7d, 30d, 90d, this_month, last_month |
from / to |
Rango manual YYYY-MM-DD (se ignora si mandas preset) |
Ejemplo: desempeño de agentes en los últimos 30 días
curl -X GET "https://app.omnifox.io/api/v1/reports/agents?preset=30d" \
-H "Authorization: Bearer TU_TOKEN"
Consejos
- Programa una tarea (cron, n8n, Zapier) que llame
/reports/overviewcada mañana y te lo mande por email o Slack como resumen diario. - Usa
/reports/heatmapantes de rediseñar turnos de agentes: te muestra en qué horas realmente entra más volumen.
Solución de problemas
- Los números no coinciden con lo que ves en pantalla: revisa que
workspace_idy el rango de fechas (presetofrom/to) sean exactamente los mismos que estás mirando en el panel. from/tono tienen efecto: si mandastepreseten la misma consulta, este tiene prioridad y las fechas manuales se ignoran.
Artículos relacionados
-
Cómo conectar integraciones y apps externas
Conecta Omnifox con tus herramientas favoritas desde el catálogo de integraciones en pocos pasos.
-
Guía completa de integraciones y API
Integraciones y API a fondo, en 30 capítulos: claves API, llamadas reales, webhooks firmados, n8n, MCP y SDK, todo funcionando de verdad.
-
Integrar Omnifox con Azur, Siigo, Alegra, QuickBooks u otro sistema contable o ERP
Omnifox no tiene hoy un conector nativo con sistemas contables o ERP. Te explicamos cómo conectarlos igual con workflows, el nodo HTTP, n8n, Make, Zapier o la API, con ejemplos.
-
Generar y usar API keys y webhooks
Crea claves de API para acceder a Omnifox por código y configura webhooks para recibir eventos en tiempo real.
-
Introducción a las integraciones (webhook / OAuth / API key)
Conecta Omnifox con tus otras herramientas: qué está disponible hoy, qué llega pronto y cuándo usar un webhook, una conexión OAuth o una clave de API.