API de Reportes

Cómo consultar por API los reportes de conversaciones, agentes y horas pico de Omnifox.

Jul 11, 2026

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 preset o from/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/funnel y /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 mandás `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

Programá una tarea (cron, n8n, Zapier) que llame /reports/overview cada mañana y te lo mande por email o Slack como resumen diario.
Usá /reports/heatmap antes 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: revisá que workspace_id y el rango de fechas (preset o from/to) sean exactamente los mismos que estás mirando en el panel.
from/to no tienen efecto: si mandaste preset en la misma consulta, este tiene prioridad y las fechas manuales se ignoran.

¿Te fue útil?