Analytics

Endpoints de análisis y Business Intelligence. Proporcionan datos agregados sobre llamadas, agentes y tendencias. Requiere rol de manager o superior.

Endpoints

Método	Endpoint	Descripción	Rol Mínimo
GET	/api/v1/analytics/overview	Visión general (KPIs)	manager
GET	/api/v1/analytics/hourly	Distribución por hora	manager
GET	/api/v1/analytics/agents	Rendimiento de los agentes	manager
GET	/api/v1/analytics/trends	Tendencias temporales	manager
POST	/api/v1/analytics/refresh-views	Actualizar vistas materializadas	manager

---

Visión General

Devuelve los KPIs (Key Performance Indicators) del período.

GET /api/v1/analytics/overview

Query Parameters

Parámetro	Tipo	Predeterminado	Descripción
date_from	string	30 días atrás	Fecha inicio (ISO 8601)
date_to	string	hoy	Fecha fin (ISO 8601)
department_id	uuid	-	Filtro por departamento

Ejemplo de Request

curl -X GET "https://voki.avanter.com.br/api/v1/analytics/overview?date_from=2026-02-01&date_to=2026-02-18" \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter"

Respuesta Exitosa (200)

{
  "data": {
    "total_calls": 342,
    "completed_calls": 298,
    "missed_calls": 28,
    "cancelled_calls": 16,
    "avg_duration": 285,
    "avg_wait_time": 18,
    "avg_rating": 4.6,
    "total_customers": 215,
    "new_customers": 48,
    "completion_rate": 87.1,
    "satisfaction_rate": 92.0
  }
}

---

Distribución por Hora

Devuelve la distribución de llamadas por hora del día.

GET /api/v1/analytics/hourly

Query Parameters

Parámetro	Tipo	Predeterminado	Descripción
date_from	string	7 días atrás	Fecha inicio
date_to	string	hoy	Fecha fin
department_id	uuid	-	Filtro por departamento

Ejemplo de Request

curl -X GET "https://voki.avanter.com.br/api/v1/analytics/hourly?date_from=2026-02-11&date_to=2026-02-18" \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter"

Respuesta Exitosa (200)

{
  "data": [
    { "hour": 8, "total": 12, "completed": 10, "missed": 2 },
    { "hour": 9, "total": 25, "completed": 23, "missed": 2 },
    { "hour": 10, "total": 38, "completed": 35, "missed": 3 },
    { "hour": 11, "total": 42, "completed": 40, "missed": 2 },
    { "hour": 12, "total": 15, "completed": 13, "missed": 2 },
    { "hour": 13, "total": 20, "completed": 18, "missed": 2 },
    { "hour": 14, "total": 45, "completed": 42, "missed": 3 },
    { "hour": 15, "total": 40, "completed": 37, "missed": 3 },
    { "hour": 16, "total": 35, "completed": 33, "missed": 2 },
    { "hour": 17, "total": 22, "completed": 20, "missed": 2 }
  ]
}

---

Rendimiento de los Agentes

Devuelve métricas de rendimiento por agente.

GET /api/v1/analytics/agents

Query Parameters

Parámetro	Tipo	Predeterminado	Descripción
date_from	string	30 días atrás	Fecha inicio
date_to	string	hoy	Fecha fin
department_id	uuid	-	Filtro por departamento
sort_by	string	total_calls	Ordenamiento: total_calls, avg_duration, avg_rating
sort_order	string	desc	Dirección

Ejemplo de Request

curl -X GET "https://voki.avanter.com.br/api/v1/analytics/agents?date_from=2026-02-01" \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter"

Respuesta Exitosa (200)

{
  "data": [
    {
      "user_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "user_name": "João Silva",
      "total_calls": 85,
      "completed_calls": 78,
      "missed_calls": 5,
      "avg_duration": 312,
      "avg_wait_time": 15,
      "avg_rating": 4.8,
      "total_duration": 24336,
      "satisfaction_rate": 95.0
    },
    {
      "user_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "user_name": "Maria Santos",
      "total_calls": 72,
      "completed_calls": 68,
      "missed_calls": 3,
      "avg_duration": 278,
      "avg_wait_time": 12,
      "avg_rating": 4.7,
      "total_duration": 18904,
      "satisfaction_rate": 93.0
    }
  ]
}

---

Tendencias

Devuelve datos agregados a lo largo del tiempo para visualización de tendencias.

GET /api/v1/analytics/trends

Query Parameters

Parámetro	Tipo	Predeterminado	Descripción
date_from	string	30 días atrás	Fecha inicio
date_to	string	hoy	Fecha fin
granularity	string	day	Granularidad: day, week, month
department_id	uuid	-	Filtro por departamento

Ejemplo de Request

curl -X GET "https://voki.avanter.com.br/api/v1/analytics/trends?date_from=2026-02-01&granularity=day" \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter"

Respuesta Exitosa (200)

{
  "data": [
    {
      "date": "2026-02-01",
      "total_calls": 18,
      "completed_calls": 16,
      "avg_duration": 290,
      "avg_rating": 4.5,
      "new_customers": 3
    },
    {
      "date": "2026-02-02",
      "total_calls": 22,
      "completed_calls": 20,
      "avg_duration": 310,
      "avg_rating": 4.7,
      "new_customers": 5
    }
  ]
}

---

Actualizar Vistas Materializadas

Fuerza la actualización de las vistas materializadas de analytics. Útil cuando los datos recientes no aparecen en las consultas.

POST /api/v1/analytics/refresh-views

Ejemplo de Request

curl -X POST https://voki.avanter.com.br/api/v1/analytics/refresh-views \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter"

Respuesta Exitosa (200)

{
  "data": {
    "message": "Views materializadas atualizadas com sucesso",
    "refreshed_at": "2026-02-18T17:30:00Z"
  }
}