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

# Métricas

> Explora indicadores clave, construye dashboards y comparte insights desde un solo lugar para entender qué está pasando en tus proyectos.

La nueva versión de **Métricas** concentra el análisis del proyecto en un solo lugar. Desde [apps.jelou.ai/metrics/v2](https://apps.jelou.ai/metrics/v2) puedes revisar los indicadores, armar dashboards con las métricas que más te importan, generar insights ejecutivos y compartir gráficos con tu equipo — todo con los mismos filtros globales.

<Info>
  El **Administrador de Métricas** puede crear, editar y eliminar dashboards, insights y métricas personalizadas. El rol de **solo visualización** puede abrir el panel y consultar los datos, pero no modificar nada. Los permisos se asignan desde **Configuración → Gestión de usuarios**.
</Info>

## Vista general

El panel se divide en tres áreas:

* **Barra global de filtros** — rango de fechas y filtros compartidos por todos los gráficos de la sección activa.
* **Barra lateral izquierda** — cambia entre **Dashboards** e **Insights**. El dashboard **Resumen General** viene precargado; los demás dashboards e insights los creas tú.
* **Contenido** — gráficos de métricas que puedes reordenar y redimensionar.

## Resumen General

Es el dashboard por defecto. Consolida los indicadores más consultados del proyecto:

<AccordionGroup>
  <Accordion title="Tarjetas KPI">
    Cuatro indicadores fijos: **usuarios activos**, **workflows**, **conversaciones** y **HSM**. Cada uno muestra el valor del período y su variación. Al seleccionar uno, el gráfico de volumen inferior se actualiza para ese indicador.
  </Accordion>

  <Accordion title="Gráfico de volumen">
    Serie temporal del KPI seleccionado, sobre el rango de fechas activo. Cuando el rango supera los 90 días, la serie se agrupa por mes automáticamente.
  </Accordion>

  <Accordion title="Flujo de usuarios del proyecto">
    Muestra cómo se mueven los usuarios entre los workflows del proyecto y qué proporción abandona o completa cada rama.
  </Accordion>

  <Accordion title="Rendimiento por workflow">
    Tabla con las métricas de desempeño de cada workflow en el período. Un filtro permite incluir o excluir los **workflows compartidos** con otros proyectos.
  </Accordion>

  <Accordion title="Top de palabras por workflow">
    Tabla con los términos más frecuentes, desglosados por workflow.
  </Accordion>
</AccordionGroup>

## Filtros globales

La barra superior aplica los filtros a todos los gráficos de la sección activa.

<AccordionGroup>
  <Accordion title="Rango de fechas">
    Selecciona rangos rápidos (hoy, últimos 7 días, últimos 30 días, este mes, etc.) o define un rango personalizado. La fecha es siempre global y no aparece en el selector de filtros adicionales — se aplica a todas las métricas.
  </Accordion>

  <Accordion title="Filtros adicionales">
    Desde **Filtros** puedes añadir o quitar dimensiones a la barra global: **canal**, **equipo**, **proveedor**, **moneda**, **entorno**, **tipo de biometría**, **criterio**, **workflow**, **nodo** y **nombre del workflow**. Cada dashboard recuerda qué filtros están promovidos a la barra global y cuáles quedan disponibles en cada gráfico.
  </Accordion>

  <Accordion title="Promover un filtro desde un gráfico">
    Cada gráfico expone sus propios filtros y puedes **promover** cualquiera de ellos a la barra global. Al hacerlo, el filtro pasa a la barra superior y se aplica únicamente a los gráficos que ya lo tienen entre sus dimensiones — el resto no se ve afectado. Debajo del filtro se muestra a cuántos gráficos del dashboard afecta.
  </Accordion>

  <Accordion title="Ventana máxima">
    Algunas métricas tienen un límite de días para proteger el rendimiento; cuando lo alcanzas, el panel muestra un aviso indicándote el máximo permitido.
  </Accordion>
</AccordionGroup>

<Tip>
  La zona horaria del navegador se envía en cada consulta para que los cortes diarios reflejen tu horario local.
</Tip>

## Dashboards personalizados

Además del **Resumen General**, puedes crear tus propios dashboards para agrupar las métricas relevantes de un equipo, canal o iniciativa.

<Steps>
  <Step title="Crear un dashboard">
    Desde el panel lateral, en la pestaña **Dashboards**, presiona **+ Crear dashboard**. Elige empezar en blanco o desde una [plantilla](#plantillas-disponibles), ingresa un nombre y confirma.
  </Step>

  <Step title="Agregar métricas">
    Presiona **Agregar métrica** para abrir el catálogo. Las métricas se organizan en categorías: **Inbox**, **E-commerce**, **Pagos**, **Voz**, **Biometría**, **Brain**, **IA** y **General**. Puedes buscar por nombre o filtrar por categoría.
  </Step>

  <Step title="Organizar el dashboard">
    Cada dashboard admite hasta **10 métricas**. Arrastra los gráficos para reordenarlos y usa las esquinas para redimensionarlos.
  </Step>

  <Step title="Renombrar, duplicar o eliminar">
    Puedes **renombrar** cada dashboard, **duplicarlo** para partir de una copia o **eliminarlo** de forma permanente.
  </Step>
</Steps>

### Plantillas disponibles

Al crear un dashboard puedes partir de una plantilla con las métricas esenciales de un área:

| **Dashboard**            | Qué incluye                                                                                                                                                                                  |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Resumen General**      | Dashboard de sistema: usuarios activos, workflows, conversaciones, HSM, volumen, flujo de usuarios, rendimiento por workflow y top de palabras. No se puede renombrar, duplicar ni eliminar. |
| **Operadores y Tickets** | Métricas esenciales de Bandeja de entrada.                                                                                                                                                   |
| **Biometría**            | Métricas esenciales de verificación biométrica y KYC.                                                                                                                                        |
| **Ecommerce**            | Métricas esenciales de Ecommerce: ventas, productos y clientes.                                                                                                                              |
| **Brain Studio**         | Métricas esenciales de Brain: evaluaciones del agente y palabras más usadas.                                                                                                                 |
| **Pagos**                | Cobros, tasa de éxito, proveedores y monedas.                                                                                                                                                |
| **Consumos de IA**       | Costos y consumo de tokens de IA.                                                                                                                                                            |
| **Mensajería Outbound**  | Rendimiento de envíos de plantillas de WhatsApp: KPIs de entrega, tendencia diaria, origen de los envíos y embudo.                                                                           |

## Tipos de gráfico

Las métricas del catálogo se dibujan con uno de estos tipos. Al crear una [métrica personalizada](#métricas-personalizadas) eliges entre el subconjunto que admite esa fuente.

<AccordionGroup>
  <Accordion title="Indicadores">
    * **Número** — un solo valor con comparación contra el período anterior: actual, crecimiento y un desglose opcional al pie. Uso típico: totales principales — conversaciones, usuarios, mensajes enviados.
    * **Grupo de números** — varios indicadores en una sola tarjeta, cada uno con su formato (entero, decimal, porcentaje, duración o moneda) y su variación. Uso típico: tasas de un mismo proceso.
  </Accordion>

  <Accordion title="Series temporales">
    * **Línea** — evolución de un valor en el rango de fechas, con un punto por fecha.
    * **Área** — la misma serie, con relleno bajo la curva. Uso típico: volúmenes acumulables, como mensajes o sesiones por día.
    * **Multilínea** — varias series en el mismo plano, con leyenda para mostrar u ocultar cada una. Uso típico: comparar categorías a la vez (por canal, por estado).
  </Accordion>

  <Accordion title="Comparación y composición">
    * **Barras** — barras verticales por categoría o por fecha. Uso típico: conteos con pocas etiquetas.
    * **Barras horizontales** — ranking ordenado; funciona mejor cuando las etiquetas son largas. Uso típico: top de workflows, motivos o agentes.
    * **Barras apiladas** — cada barra se divide en segmentos para ver la composición del total. Uso típico: sesiones por canal por día, estados de HSM por fecha.
    * **Pastel** — distribución porcentual entre pocas categorías. Uso típico: porcentaje por canal o por tipo de sesión.
  </Accordion>

  <Accordion title="Distribución e intensidad">
    * **Histograma** — distribución de una variable en rangos (buckets). Uso típico: duración de sesiones o tiempos de respuesta.
    * **Mapa de calor** — matriz de intensidad por color. Uso típico: conversaciones por hora y día de la semana.
  </Accordion>

  <Accordion title="Flujos y embudos">
    * **Embudo** — conversión clásica: cada nivel muestra cuántos llegaron respecto de la etapa anterior.
    * **Embudo por etapas** — columnas con porcentaje, denominador propio y alerta cuando una etapa cae en zona de riesgo. Uso típico: verificación de identidad o checkout.
    * **Sankey** — flujo entre nodos proporcional al volumen, con puntos de abandono. Uso típico: recorridos entre workflows.
    * **Sankey de recorridos** — variante a ancho completo para un journey paso a paso.
  </Accordion>

  <Accordion title="Tablas, texto y geografía">
    * **Tabla** — columnas de texto, número o porcentaje, con badges de estado, barras de progreso, filtros y paginación. Uso típico: detalle por workflow, agente o plantilla.
    * **Nube de palabras** — términos dimensionados por frecuencia. Uso típico: palabras más usadas en conversaciones o búsquedas.
    * **Mapa de burbujas** — burbujas cuyo tamaño representa el volumen en cada ubicación. Uso típico: resultados por ciudad o región.
  </Accordion>
</AccordionGroup>

## Métricas personalizadas

Si el catálogo no cubre tu caso, puedes registrar métricas propias sin salir del panel.

<Tabs>
  <Tab title="Basadas en eventos">
    Convierte los eventos que emites desde tus workflows en gráficos. Cada métrica compara **hasta 5 eventos en el mismo gráfico**, etiquetados A–E. Cada evento se configura por separado con:

    * **Evento** que quieres medir.
    * **Métrica** a calcular: total de eventos, usuarios únicos, sesiones totales o suma de un valor numérico.
    * **Filtros** por propiedad del evento.
    * **Desgloces (breakdowns)** para segmentar la serie por propiedad — se recomienda no superar 2 desgloces.

    Los tipos de gráfico disponibles son **Gráfico de líneas**, **Gráfico de barras**, **Indicador**, **Árbol de desglose** y **Gráfico circular**. El editor incluye un panel de previsualización en tiempo real con el rango que elijas.

    Para generar los eventos, abre el nodo en Brain Studio, entra a la pestaña **Eventos** y registra el nombre en snake\_case más las propiedades que quieras filtrar o desglosar. Puedes configurar hasta 10 eventos por nodo, cada uno con hasta 5 propiedades.

    <Card title="Cómo generar eventos" icon="chart-line" href="/guides/observabilidad/eventos">
      Configura eventos de seguimiento en tus nodos para alimentar las métricas personalizadas.
    </Card>
  </Tab>

  <Tab title="Basadas en Bases de Datos">
    Construye métricas sobre tus propias bases de datos sin escribir SQL. Elige una plantilla:

    * **Conteo total** — cantidad de registros en la colección.
    * **Conteo por grupo** — total agrupado por un campo (canal, estado, país…).
    * **Conteo en el tiempo** — evolución diaria, semanal o mensual.
    * **Agregado numérico** — suma, promedio, mínimo, máximo o cuenta distinta sobre un campo.
    * **Funnel** — secuencia de etapas para medir conversión.

    Cada plantilla define qué tipos de gráfico soporta entre **Indicador**, **Gráfico de barras**, **Barras horizontales**, **Gráfico de líneas**, **Gráfico circular**, **Tabla** y **Embudo**. Puedes aplicar filtros con operadores **igual a**, **distinto de**, **mayor que** y **menor que**, y elegir un rango propio para la métrica si no debe usar el global.
  </Tab>
</Tabs>

<Warning>
  Eliminar una métrica personalizada la retira de todos los dashboards donde esté publicada. Si necesitas hacer ajustes, usa **Editar** en vez de recrearla.
</Warning>

## Insights

Los **Insights** son documentos ejecutivos generados a través del **Jelou Agent** que resumen la evolución del proyecto en un rango de fechas. A diferencia de los dashboards, un insight:

* Se guarda como HTML enriquecido con **texto**, **tablas** y **gráficos embebidos**.
* Se puede **imprimir** o **descargar** para compartirlo fuera de la plataforma.
* Mantiene el rango de fechas con el que se generó, así puedes comparar entregas mensuales.

Los insights son **altamente personalizables**: al pedírselo al Jelou Agent puedes indicarle cómo estructurar el reporte, qué **tipos de gráfico** incluir, qué **paleta de colores** usar o qué secciones destacar. Si esas preferencias las quieres aplicar siempre, puedes guardarlas en la **memoria del agente** para que se respeten automáticamente en cada insight que genere — incluidos los colores y estilos de todos los gráficos.

Desde la pestaña **Insights** del panel lateral puedes buscar, renombrar y eliminar insights existentes.

## Compartir gráficos

En cada gráfico están disponibles tres acciones útiles para el trabajo en equipo:

* **Compartir gráfico** — genera un enlace público de solo lectura para que cualquiera con el link vea el gráfico con sus filtros actuales.
* **Usar vía API** — abre un cajón lateral con el snippet listo para consumir la métrica desde tu backend o cuaderno, en el lenguaje que elijas: **cURL**, **JavaScript**, **Python** o **PHP**. Cada snippet incluye los filtros aplicados, la zona horaria y el `companyId`.
* **Configurar filtros** — permite fijar filtros específicos a ese gráfico, distintos de los globales, cuando la métrica lo admite.

## Buenas prácticas

<AccordionGroup>
  <Accordion title="Empieza por el Resumen General">
    Antes de crear dashboards, revisa el **Resumen General** para detectar qué indicadores movilizan decisiones y merecen su propio dashboard.
  </Accordion>

  <Accordion title="Un dashboard por decisión">
    Los mejores dashboards responden a una sola pregunta operativa (por ejemplo, "¿cómo va la campaña de Black Friday?"). Divide en varios dashboards cuando empieces a mezclar audiencias muy distintas.
  </Accordion>

  <Accordion title="Documenta las métricas personalizadas">
    Cuando crees una métrica basada en eventos o en bases de datos, usa un nombre descriptivo — el mismo que aparecerá en dashboards e insights. Evita abreviaciones internas que otros usuarios no puedan interpretar.
  </Accordion>

  <Accordion title="Comparte enlaces, no capturas">
    El **enlace público** de un gráfico siempre refleja los datos actualizados, mientras que una captura queda obsoleta apenas cambia el filtro o el rango.
  </Accordion>
</AccordionGroup>