> ## 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

> Explore indicadores-chave, construa dashboards e compartilhe insights em um único lugar para entender o que está acontecendo nos seus projetos.

A nova versão de **Métricas** concentra a análise do projeto em um só lugar. A partir de [apps.jelou.ai/metrics/v2](https://apps.jelou.ai/metrics/v2) você pode revisar os indicadores, montar dashboards com as métricas mais importantes, gerar insights executivos e compartilhar gráficos com sua equipe — tudo com os mesmos filtros globais.

<Info>
  O **Administrador de Métricas** pode criar, editar e excluir dashboards, insights e métricas personalizadas. O papel de **somente visualização** pode abrir o painel e consultar os dados, mas não modificar nada. As permissões são atribuídas em **Configurações → Gestão de usuários**.
</Info>

## Visão geral

O painel se divide em três áreas:

* **Barra global de filtros** — intervalo de datas e filtros compartilhados por todos os gráficos da seção ativa.
* **Barra lateral esquerda** — alterna entre **Dashboards** e **Insights**. O dashboard **Resumo Geral** vem pré-carregado; os demais dashboards e insights são criados por você.
* **Conteúdo** — gráficos de métricas que você pode reordenar e redimensionar.

## Resumo Geral

É o dashboard padrão. Consolida os indicadores mais consultados do projeto:

<AccordionGroup>
  <Accordion title="Cards de KPI">
    Quatro indicadores fixos: **usuários ativos**, **workflows**, **conversas** e **HSM**. Cada um mostra o valor do período e a variação. Ao selecionar um, o gráfico de volume abaixo é atualizado para esse indicador.
  </Accordion>

  <Accordion title="Gráfico de volume">
    Série temporal do KPI selecionado, no intervalo de datas ativo. Quando o intervalo passa de 90 dias, a série é agrupada por mês automaticamente.
  </Accordion>

  <Accordion title="Fluxo de usuários do projeto">
    Mostra como os usuários se movem entre os workflows do projeto e qual proporção abandona ou completa cada ramo.
  </Accordion>

  <Accordion title="Desempenho por workflow">
    Tabela com as métricas de desempenho de cada workflow no período. Um filtro permite incluir ou excluir os **workflows compartilhados** com outros projetos.
  </Accordion>

  <Accordion title="Top de palavras por workflow">
    Tabela com os termos mais frequentes, detalhados por workflow.
  </Accordion>
</AccordionGroup>

## Filtros globais

A barra superior aplica os filtros a todos os gráficos da seção ativa.

<AccordionGroup>
  <Accordion title="Intervalo de datas">
    Escolha um intervalo rápido (hoje, últimos 7 dias, últimos 30 dias, este mês etc.) ou defina um intervalo personalizado. A data é sempre global e não aparece no seletor de filtros adicionais — ela se aplica a todas as métricas.
  </Accordion>

  <Accordion title="Filtros adicionais">
    A partir de **Filtros** você pode adicionar ou remover dimensões da barra global: **canal**, **equipe**, **provedor**, **moeda**, **ambiente**, **tipo de biometria**, **critério**, **workflow**, **nó** e **nome do workflow**. Cada dashboard lembra quais filtros estão promovidos à barra global e quais permanecem disponíveis por gráfico.
  </Accordion>

  <Accordion title="Promover um filtro a partir de um gráfico">
    Cada gráfico expõe os próprios filtros e você pode **promover** qualquer um deles para a barra global. Ao promovê-lo, o filtro passa para a barra superior e se aplica apenas aos gráficos que já o têm entre suas dimensões — os demais não são afetados. Abaixo do filtro aparece quantos gráficos do dashboard ele afeta.
  </Accordion>

  <Accordion title="Janela máxima">
    Algumas métricas têm um limite de dias para proteger o desempenho; quando você atinge esse limite, o painel exibe um aviso com o máximo permitido.
  </Accordion>
</AccordionGroup>

<Tip>
  O fuso horário do navegador é enviado em cada consulta para que os cortes diários reflitam seu horário local.
</Tip>

## Dashboards personalizados

Além do **Resumo Geral**, você pode criar seus próprios dashboards para agrupar as métricas relevantes de uma equipe, canal ou iniciativa.

<Steps>
  <Step title="Criar um dashboard">
    Na barra lateral, na aba **Dashboards**, pressione **+ Criar dashboard**. Escolha começar em branco ou a partir de um [modelo](#modelos-disponiveis), digite um nome e confirme.
  </Step>

  <Step title="Adicionar métricas">
    Pressione **Adicionar métrica** para abrir o catálogo. As métricas estão organizadas em categorias: **Inbox**, **E-commerce**, **Pagamentos**, **Voz**, **Biometria**, **Brain**, **IA** e **Geral**. É possível buscar por nome ou filtrar por categoria.
  </Step>

  <Step title="Organizar o dashboard">
    Cada dashboard aceita até **10 métricas**. Arraste os gráficos para reordenar e use as bordas para redimensioná-los.
  </Step>

  <Step title="Renomear, duplicar ou excluir">
    Você pode **renomear** cada dashboard, **duplicá-lo** para partir de uma cópia ou **excluí-lo** de forma permanente.
  </Step>
</Steps>

### Modelos disponíveis

Ao criar um dashboard você pode partir de um modelo com as métricas essenciais de uma área:

| **Dashboard**            | O que inclui                                                                                                                                                                            |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Resumo Geral**         | Dashboard de sistema: usuários ativos, workflows, conversas, HSM, volume, fluxo de usuários, desempenho por workflow e top de palavras. Não pode ser renomeado, duplicado nem excluído. |
| **Operadores e Tickets** | Métricas essenciais da Inbox.                                                                                                                                                           |
| **Biometria**            | Métricas essenciais de verificação biométrica e KYC.                                                                                                                                    |
| **Ecommerce**            | Métricas essenciais de Ecommerce: vendas, produtos e clientes.                                                                                                                          |
| **Brain Studio**         | Métricas essenciais de Brain: avaliações do agente e palavras mais usadas.                                                                                                              |
| **Pagamentos**           | Cobranças, taxa de sucesso, provedores e moedas.                                                                                                                                        |
| **Consumos de IA**       | Custos e consumo de tokens de IA.                                                                                                                                                       |
| **Mensageria Outbound**  | Desempenho dos envios de modelos de WhatsApp: KPIs de entrega, tendência diária, origem dos envios e funil.                                                                             |

## Tipos de gráfico

As métricas do catálogo são desenhadas com um destes tipos. Ao criar uma [métrica personalizada](#metricas-personalizadas) você escolhe entre o subconjunto que essa fonte admite.

<AccordionGroup>
  <Accordion title="Indicadores">
    * **Número** — um único valor comparado com o período anterior: atual, crescimento e um detalhamento opcional no rodapé. Uso típico: totais principais — conversas, usuários, mensagens enviadas.
    * **Grupo de números** — vários indicadores no mesmo card, cada um com o próprio formato (inteiro, decimal, percentual, duração ou moeda) e a variação. Uso típico: taxas do mesmo processo.
  </Accordion>

  <Accordion title="Séries temporais">
    * **Linha** — evolução de um valor no intervalo de datas, com um ponto por data.
    * **Área** — a mesma série, com preenchimento sob a curva. Uso típico: volumes acumuláveis, como mensagens ou sessões por dia.
    * **Multilinha** — várias séries no mesmo plano, com legenda para mostrar ou ocultar cada uma. Uso típico: comparar categorias ao mesmo tempo (por canal, por status).
  </Accordion>

  <Accordion title="Comparação e composição">
    * **Barras** — barras verticais por categoria ou por data. Uso típico: contagens com poucos rótulos.
    * **Barras horizontais** — ranking ordenado; funciona melhor quando os rótulos são longos. Uso típico: top de workflows, motivos ou agentes.
    * **Barras empilhadas** — cada barra se divide em segmentos para ver a composição do total. Uso típico: sessões por canal por dia, status de HSM por data.
    * **Pizza** — distribuição percentual entre poucas categorias. Uso típico: percentual por canal ou por tipo de sessão.
  </Accordion>

  <Accordion title="Distribuição e intensidade">
    * **Histograma** — distribuição de uma variável em faixas (buckets). Uso típico: duração de sessões ou tempos de resposta.
    * **Mapa de calor** — matriz de intensidade por cor. Uso típico: conversas por hora e dia da semana.
  </Accordion>

  <Accordion title="Fluxos e funis">
    * **Funil** — conversão clássica: cada nível mostra quantos chegaram em relação à etapa anterior.
    * **Funil por etapas** — colunas com percentual, denominador próprio e alerta quando uma etapa cai em zona de risco. Uso típico: verificação de identidade ou checkout.
    * **Sankey** — fluxo entre nós proporcional ao volume, com pontos de abandono. Uso típico: percursos entre workflows.
    * **Sankey de percursos** — variante em largura total para um journey passo a passo.
  </Accordion>

  <Accordion title="Tabelas, texto e geografia">
    * **Tabela** — colunas de texto, número ou percentual, com badges de status, barras de progresso, filtros e paginação. Uso típico: detalhe por workflow, agente ou modelo.
    * **Nuvem de palavras** — termos dimensionados pela frequência. Uso típico: palavras mais usadas em conversas ou buscas.
    * **Mapa de bolhas** — bolhas cujo tamanho representa o volume em cada localização. Uso típico: resultados por cidade ou região.
  </Accordion>
</AccordionGroup>

## Métricas personalizadas

Se o catálogo não cobre seu caso, você pode registrar métricas próprias sem sair do painel.

<Tabs>
  <Tab title="Baseadas em eventos">
    Transforme os eventos que você emite nos workflows em gráficos. Cada métrica compara **até 5 eventos no mesmo gráfico**, rotulados A–E. Cada evento é configurado separadamente com:

    * **Evento** que deseja medir.
    * **Medida** a calcular: total de eventos, usuários únicos, sessões totais ou soma de um valor numérico.
    * **Filtros** por propriedade do evento.
    * **Desgloces (breakdowns)** para segmentar a série por propriedade — recomendamos no máximo 2 desgloces.

    Os tipos de gráfico disponíveis são **Gráfico de linhas**, **Gráfico de barras**, **Indicador**, **Árvore de detalhamento** e **Gráfico de pizza**. O editor inclui um painel de pré-visualização em tempo real com o intervalo escolhido.

    Para gerar os eventos, abra o nó no Brain Studio, entre na aba **Eventos** e registre o nome em snake\_case mais as propriedades que quiser filtrar ou detalhar. Você pode configurar até 10 eventos por nó, cada um com até 5 propriedades.

    <Card title="Como gerar eventos" icon="chart-line" href="/pt/guias/observabilidade/eventos">
      Configure eventos de rastreamento nos seus nós para alimentar as métricas personalizadas.
    </Card>
  </Tab>

  <Tab title="Baseadas em Bases de Dados">
    Construa métricas sobre as suas próprias bases de dados sem escrever SQL. Escolha um modelo:

    * **Contagem total** — quantidade de registros na coleção.
    * **Contagem por grupo** — total agrupado por um campo (canal, status, país…).
    * **Contagem ao longo do tempo** — evolução diária, semanal ou mensal.
    * **Agregado numérico** — soma, média, mínimo, máximo ou contagem distinta de um campo.
    * **Funil** — sequência de etapas para medir conversão.

    Cada modelo define quais tipos de gráfico suporta entre **Indicador**, **Gráfico de barras**, **Barras horizontais**, **Gráfico de linhas**, **Gráfico de pizza**, **Tabela** e **Funil**. Você pode aplicar filtros com operadores **igual a**, **diferente de**, **maior que** e **menor que**, e escolher um intervalo próprio para a métrica quando ela não deve seguir o global.
  </Tab>
</Tabs>

<Warning>
  Excluir uma métrica personalizada a remove de todos os dashboards em que estiver publicada. Se precisar ajustar, use **Editar** em vez de recriá-la.
</Warning>

## Insights

Os **Insights** são documentos executivos gerados por meio do **Jelou Agent** que resumem a evolução do projeto em um intervalo de datas. Ao contrário dos dashboards, um insight:

* É salvo como HTML enriquecido com **texto**, **tabelas** e **gráficos embutidos**.
* Pode ser **impresso** ou **baixado** para compartilhar fora da plataforma.
* Mantém o intervalo de datas com o qual foi gerado, para comparar entregas mensais.

Os insights são **altamente personalizáveis**: ao pedir ao Jelou Agent você pode indicar como estruturar o relatório, quais **tipos de gráfico** incluir, qual **paleta de cores** usar ou quais seções destacar. Se quiser que essas preferências valham sempre, salve-as na **memória do agente** e elas serão respeitadas automaticamente em cada insight gerado — inclusive as cores e os estilos de todos os gráficos.

Na aba **Insights** da barra lateral você pode buscar, renomear e excluir insights existentes.

## Compartilhar gráficos

Em cada gráfico estão disponíveis três ações úteis para o trabalho em equipe:

* **Compartilhar gráfico** — gera um link público somente de leitura para que qualquer pessoa com o link veja o gráfico com seus filtros atuais.
* **Usar via API** — abre um drawer lateral com o snippet pronto para consumir a métrica pelo seu backend ou notebook, na linguagem que você escolher: **cURL**, **JavaScript**, **Python** ou **PHP**. Cada snippet inclui os filtros aplicados, o fuso horário e o `companyId`.
* **Configurar filtros** — fixa filtros específicos daquele gráfico, diferentes dos globais, quando a métrica permite.

## Boas práticas

<AccordionGroup>
  <Accordion title="Comece pelo Resumo Geral">
    Antes de criar dashboards, revise o **Resumo Geral** para identificar quais indicadores influenciam decisões e merecem um dashboard próprio.
  </Accordion>

  <Accordion title="Um dashboard por decisão">
    Os melhores dashboards respondem a uma única pergunta operacional (por exemplo, "como está a campanha da Black Friday?"). Divida em vários dashboards quando começar a misturar audiências muito diferentes.
  </Accordion>

  <Accordion title="Documente suas métricas personalizadas">
    Ao criar uma métrica baseada em eventos ou em bases de dados, use um nome descritivo — o mesmo que aparecerá em dashboards e insights. Evite abreviações internas que outros usuários não consigam interpretar.
  </Accordion>

  <Accordion title="Compartilhe links, não capturas">
    O **link público** de um gráfico sempre reflete os dados atualizados, enquanto uma captura fica desatualizada assim que o filtro ou o intervalo muda.
  </Accordion>
</AccordionGroup>