> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meetzy.es/llms.txt
> Use this file to discover all available pages before exploring further.

# Sistema de Reportes

> Analiza el rendimiento de tus agentes conversacionales con reportes detallados y análisis de métricas avanzadas

El sistema de reportes de Meetzy proporciona análisis completos y detallados del rendimiento de tus agentes conversacionales, permitiendo optimizar estrategias y mejorar resultados.

## Características Principales

<Info>
  El sistema de reportes está disponible para usuarios con permisos administrativos y editores avanzados
</Info>

### Métricas Disponibles

* **Llamadas totales** y tasas de finalización
* **Conversiones** y tasas de conversión
* **Tiempo de conversación** promedio y desviación estándar
* **Minutos facturables** por agente y llamada
* **Puntuaciones NPS** cuando está activado
* **Análisis temporal** por días y horas
* **Distribución de estados** de llamadas

## Tipos de Reportes

### Reporte por Agente

Analiza el rendimiento individual de cada agente:

<Steps>
  <Step title="Seleccionar Agentes">
    Elige uno o varios agentes para incluir en el análisis
  </Step>

  <Step title="Definir Período">
    Establece el rango de fechas para el reporte
  </Step>

  <Step title="Aplicar Filtros">
    Configura filtros adicionales según tus necesidades
  </Step>

  <Step title="Generar Reporte">
    El sistema procesará los datos y generará el análisis
  </Step>
</Steps>

### Análisis Temporal

Examina tendencias y patrones a lo largo del tiempo:

* **Datos diarios**: Evolución de métricas día a día
* **Análisis horario**: Identificación de picos de actividad
* **Comparativas de períodos**: Rendimiento entre diferentes fechas

### Distribución de Estados

Visualiza cómo se distribuyen los estados de las llamadas:

<Tabs>
  <Tab title="Estados Exitosos">
    * `closed`: Llamadas finalizadas exitosamente
    * `transferred`: Llamadas transferidas a agentes humanos
    * `voicemail`: Mensajes dejados en buzón de voz
  </Tab>

  <Tab title="Estados Fallidos">
    * `no-answer`: Llamadas sin respuesta
    * `busy`: Línea ocupada
    * `failed`: Fallos técnicos
    * `wrong-phone-format`: Formato de teléfono incorrecto
  </Tab>

  <Tab title="Estados en Proceso">
    * `open`: Llamadas en curso
    * `ringing`: Timbrando
    * `scheduled-call`: Llamadas programadas
  </Tab>
</Tabs>

## Filtros Avanzados

### Filtros de Estado

Filtra las llamadas por su estado final:

```typescript theme={null}
filters: {
  status: ['closed', 'transferred', 'voicemail']
}
```

### Filtros de Duración

Establece rangos de duración para las llamadas:

```typescript theme={null}
filters: {
  min_duration: 30, // segundos
  max_duration: 600 // segundos
}
```

### Filtros de NPS

Para agentes con NPS activado:

```typescript theme={null}
filters: {
  min_nps_score: 7,
  max_nps_score: 10
}
```

## Métricas Clave

### Tasas de Rendimiento

* **Tasa de finalización**: Porcentaje de llamadas completadas exitosamente
* **Tasa de conversión**: Porcentaje de llamadas que resultan en conversión
* **Tasa de contacto**: Porcentaje de leads contactados exitosamente
* **Tasa de transferencia**: Porcentaje de llamadas transferidas a humanos

### Métricas de Tiempo

* **Duración promedio**: Tiempo medio de conversación
* **Tiempo total de conversación**: Suma de todos los minutos hablados
* **Minutos facturables**: Tiempo que genera costo
* **Desviación estándar**: Variabilidad en la duración de llamadas

<Warning>
  Los minutos facturables pueden diferir del tiempo total de conversación debido a redondeos y configuraciones de facturación
</Warning>

### Análisis de Leads

* **Leads únicos**: Número de contactos diferentes
* **Leads contactados**: Contactos que respondieron la llamada
* **Leads convertidos**: Contactos que completaron el objetivo
* **Tasa de conversión desde contactados**: Conversiones / Contactados

## Rangos de Fechas Predefinidos

El sistema incluye rangos de fechas comunes:

* **Hoy**: Datos del día actual
* **Ayer**: Datos del día anterior completo
* **Últimos 7 días**: Semana deslizante
* **Últimos 30 días**: Mes deslizante
* **Este mes**: Desde el primer día del mes actual
* **Mes pasado**: Mes anterior completo

## Exportación de Datos

### Formatos Disponibles

<Tabs>
  <Tab title="CSV">
    Ideal para análisis en Excel o herramientas de BI

    ```typescript theme={null}
    await reportingService.exportReport(reportData, 'csv', 'reporte-agentes.csv');
    ```
  </Tab>

  <Tab title="JSON">
    Perfecto para integración con otros sistemas

    ```typescript theme={null}
    await reportingService.exportReport(reportData, 'json', 'reporte-agentes.json');
    ```
  </Tab>

  <Tab title="PDF">
    Para presentaciones y reportes ejecutivos

    ```typescript theme={null}
    await reportingService.exportReport(reportData, 'pdf', 'reporte-agentes.pdf');
    ```
  </Tab>
</Tabs>

### Contenido de la Exportación

Los archivos exportados incluyen:

* **Resumen ejecutivo** con métricas principales
* **Datos por agente** con métricas individuales
* **Análisis temporal** con datos diarios y horarios
* **Distribución de estados** con porcentajes
* **Filtros aplicados** para referencia

## Plantillas de Reportes

### Plantillas Predefinidas

El sistema incluye plantillas listas para usar:

* **Reporte Semanal**: Análisis de la semana anterior
* **Reporte Mensual**: Resumen del mes completo
* **Análisis de Conversión**: Enfoque en métricas de conversión
* **Reporte de Calidad**: Análisis de duración y NPS

### Crear Plantillas Personalizadas

```typescript theme={null}
const plantilla = {
  name: "Mi Reporte Personalizado",
  description: "Análisis específico de agentes de ventas",
  filters: {
    agent_ids: ["agent1", "agent2"],
    start_date: "2024-01-01",
    end_date: "2024-01-31",
    filters: {
      status: ["closed", "transferred"],
      min_duration: 60
    }
  }
};
```

## Análisis Avanzado

### Patrones Temporales

Identifica los mejores momentos para realizar llamadas:

* **Picos de actividad** por hora del día
* **Días de mejor rendimiento** de la semana
* **Tendencias estacionales** a lo largo del mes

### Análisis de Intentos

Comprende el comportamiento de los leads:

* **Ratios de primer intento**: Éxito en la primera llamada
* **Intentos múltiples**: Distribución hasta el noveno intento
* **Estrategias de reintento**: Optimización de seguimiento

<Info>
  Los datos de intentos múltiples ayudan a optimizar las estrategias de follow-up y mejorar las tasas de contacto
</Info>

## Interpretación de Datos

### Métricas de Referencia

* **Tasa de finalización**: >70% se considera buena
* **Tasa de conversión**: Varía por industria (5-25%)
* **Duración promedio**: 2-5 minutos para calls efectivas
* **NPS promedio**: >7 indica satisfacción alta

### Identificación de Problemas

Señales de alerta en los reportes:

* **Baja tasa de finalización**: Problemas de configuración o calidad
* **Alta desviación estándar**: Inconsistencia en el rendimiento
* **Muchas llamadas fallidas**: Issues técnicos o de configuración
* **NPS bajo**: Problemas de calidad o experiencia del usuario

El sistema de reportes es una herramienta fundamental para optimizar el rendimiento de tus agentes conversacionales y maximizar el retorno de inversión en automatización de llamadas.