Analitica

Metricas agregadas, KPIs, tendencias y exportaciones de datos. Accede a resumenes de rendimiento de campanas, call centers y ejecutivos.

Endpoints

Metodo	Endpoint	Descripcion	Scope
GET	/analytics/summary	Obtener metricas y KPIs agregados	analytics:read
GET	/analytics/campaigns	Obtener desglose de analitica por campana	analytics:read
GET	/analytics/call-centers	Obtener desglose de analitica por call center	analytics:read
GET	/analytics/executives	Obtener metricas de rendimiento por ejecutivo	analytics:read
GET	/analytics/trends	Obtener datos de tendencias en series de tiempo con granularidad	analytics:read
POST	/analytics/export	Iniciar un trabajo de exportacion de datos asincrono	analytics:export
GET	/analytics/export/{jobId}	Verificar estado del trabajo de exportacion y URL de descarga	analytics:read

Filtros Comunes

Estos parametros de consulta son compartidos por todos los endpoints GET de analitica.

Parametro	Tipo	Descripcion
dateFrom	ISO 8601	Fecha de inicio del periodo de analitica
dateTo	ISO 8601	Fecha de fin del periodo de analitica
campaignId	string	Filtrar por ID de campana
callCenterId	string	Filtrar por ID de call center
engagementId	string	Filtrar por ID de engagement

Granularidad de Tendencias

El endpoint GET /analytics/trends acepta un parametro adicional granularity.

Valor	Descripcion
daily	Un punto de datos por dia (por defecto)
weekly	Un punto de datos por semana
monthly	Un punto de datos por mes

Ejemplos de Solicitudes

Obtener metricas resumidas para un rango de fechas:

curl https://api.auralytik.com/v1/analytics/summary?dateFrom=2024-01-01&dateTo=2024-01-31 \
  -H "Authorization: Bearer YOUR_API_KEY"

Obtener tendencias semanales para una campana especifica:

curl https://api.auralytik.com/v1/analytics/trends?granularity=weekly&campaignId=camp_789 \
  -H "Authorization: Bearer YOUR_API_KEY"

Iniciar un trabajo de exportacion:

curl -X POST https://api.auralytik.com/v1/analytics/export \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "dateFrom": "2024-01-01",
    "dateTo": "2024-01-31",
    "format": "csv"
  }'

Ejemplo de Respuesta

Respuesta del endpoint de resumen:

{
  "dateFrom": "2024-01-01",
  "dateTo": "2024-01-31",
  "totalEvaluations": 1250,
  "completedEvaluations": 1180,
  "averageScore": 7.8,
  "sentimentBreakdown": {
    "positive": 620,
    "neutral": 380,
    "negative": 180
  },
  "averageDurationSeconds": 312,
  "topCampaign": "Q1 Outbound Sales",
  "topCallCenter": "Santiago Central"
}

Analitica avanzada proximamente

Definiciones de metricas personalizadas, entrega programada de reportes y analitica en tiempo real estan en desarrollo.

Solicitar Acceso API