> For the complete documentation index, see [llms.txt](https://academy.vambe.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.vambe.ai/analitica-de-datos/analitica-de-datos-pt-br/analise-dashboards-personalizados-e-relatorios.md).

# Análise: Dashboards Personalizados e Relatórios

## Analítica: Dashboards Personalizados e Relatórios

A seção de **Analítica** te permite construir seus próprios dashboards para visualizar e cruzar as informações da sua operação no Vambe: vendas, conversas, satisfação, cumprimento de SLA e automação do Instagram. Você pode montá-los do zero, partir de um template ou simplesmente pedir para **PandAI** em linguagem natural.

{% hint style="info" %}
Está buscando a análise automática semanal com recomendações? Essa é a seção **Insights**, diferente dos Dashboards Personalizados que são explicados aqui.
{% endhint %}

> Para entrar: no menu lateral, vá para **Analítica**.

***

### Como funciona

Cada dashboard é montado com **widgets**: blocos de visualização que você escolhe e configura um por um. Um dashboard pode combinar quantos widgets você precisar, e cada widget tem seu próprio tipo de gráfico, suas métricas e seus filtros.

Existem **5 tipos de dashboard**, cada um focado em uma área diferente do negócio:

1. **Tickets** (funil/pipeline de vendas e atendimento)
2. **Conversas** (mensageria e atividade do assistente)
3. **Nível de Serviço** (CSAT / NPS)
4. **SLA** (cumprimento de acordos de serviço)
5. **Instagram** (automação de comentários)

Você pode criar um dashboard **do zero** ou partir de um **template** já montado com widgets predefinidos, e depois ajustá-lo do seu jeito.

#### Como criar um dashboard: passo a passo

{% stepper %}
{% step %}
**Escolha o tipo de dashboard**

Escolha primeiro o tipo: **Tickets**, **Conversas**, **Nível de Serviço**, **SLA** ou **Instagram**. Essa decisão é a que determina quais widgets e filtros você vai ter disponíveis depois, então esse é o ponto de partida.
{% endstep %}

{% step %}
**Dê um nome e defina o filtro obrigatório**

Dê um nome ao dashboard. De acordo com o tipo escolhido, há um filtro de entrada obrigatório:

* **Tickets:** você deve escolher o funil (pipeline).
* **Nível de Serviço:** você deve escolher o tipo de pesquisa (CSAT ou NPS) e o(s) funil(is).
* **SLA:** você deve escolher o(s) funil(is).
* **Conversas** e **Instagram** não pedem um filtro obrigatório de entrada.

Se você não definir um intervalo de datas, o dashboard começa mostrando por padrão os **últimos 30 dias** (você pode mudar quando quiser).
{% endstep %}

{% step %}
**Crie em branco ou a partir de template**

Você pode deixá-lo **vazio** e adicionar widgets um por um, ou partir de um **template** que já vem preenchido com um conjunto de widgets predefinidos para esse tipo de dashboard.
{% endstep %}

{% step %}
**Adicione widgets um por um**

Para cada widget: escolha o tipo dele (ex.: "Tráfego de etapas", "Conversas por canal"), dê um nome e configure seus próprios filtros (métricas, intervalo de tempo, tipo de visualização se aplicável, etapas, canais, campos personalizados etc.). Se você não definir filtros próprios, o widget herda os filtros gerais do dashboard. O widget se posiciona sozinho no layout; você não precisa organizá-lo manualmente.

{% hint style="warning" %}
Adicione os widgets **um por vez**. Criar vários ao mesmo tempo pode desorganizar o layout do dashboard.
{% endhint %}
{% endstep %}
{% endstepper %}

As alterações são salvas imediatamente ao confirmá-las: não existe um botão separado de "salvar" nem um estado de rascunho.

***

### 1. Dashboard de Tickets

Esse tipo exige escolher um **funil específico** e é o mais completo em widgets disponíveis.

**Métricas gerais**

* **Métricas de negócio** (cards numéricos): total de oportunidades, tickets criados, resolvidos, ganhos, perdidos, fechados, taxa de sucesso, tempo médio de resolução, total vendido, preço médio de venda. É possível comparar contra o período anterior.

**Funil e fluxo**

* **Conversão do funil:** visão em estilo pipeline com entradas, % de conversão, acumulado e % de abandono por etapa. Inclui a opção de "transições estritas" (conta apenas avanços diretos) e de contar os criados diretamente na etapa inicial.
* **Tráfego de etapas** (barras): entradas, saídas, criados/ganhos/perdidos/resolvidos/fechados por etapa, valor de entrada, tempo médio de permanência e tempo médio até chegar à etapa. Ao clicar em uma etapa, abre-se o detalhamento do fluxo: de onde vêm e para onde vão os tickets.
* **Trajeto dos tickets** (diagrama de Sankey): rotas que os tickets seguem desde uma etapa inicial em diante, com profundidade configurável e filtro de ruído para ocultar rotas de baixo volume.
* **Procedência dos tickets** (Sankey reverso): de onde vieram os tickets que chegaram a uma etapa-alvo, traçado para trás.

**Séries temporais**

* **Tickets no tempo** (linhas): evolução de criados/ganhos/perdidos, com intervalo configurável (hora, dia, semana, mês, ano).
* **Vendas no tempo** (linhas): evolução do valor vendido.
* **Taxa de sucesso no tempo** (linhas ou áreas empilhadas 100%): tendência do % de tickets ganhos sobre resolvidos.
* **Lead score no tempo** (linhas): evolução do lead score médio.

**Distribuições e detalhamentos**

* **Tickets por canal** (barras): criados, ganhos e perdidos por canal de comunicação.
* **Distribuição de etiquetas** (barras): quantos tickets têm cada tag.
* **Distribuição de lead score** (barras): como os tickets se distribuem de acordo com sua pontuação.
* **Resolução humano vs. IA** (rosca ou tabela): compara tickets resolvidos apenas por IA vs. com intervenção humana, com ganhos/perdas/pendentes/taxa de conversão.
* **Mapa de calor de tickets** (dia da semana × hora): conforme resolução (ganho/perdido), fechamento ou criação.

**Campos personalizados**

* **Distribuição de campo de opções** (pizza ou tabela): distribuição de valores de um campo personalizado do tipo opções, com ganhos/perdidos/pendentes/taxa de sucesso por valor.
* **Distribuição de campo sim/não** (pizza ou tabela): o mesmo, para campos booleanos.
* **Distribuição de campo de texto** (pizza ou tabela): distribuição de valores de um campo de texto livre.
* **Estatísticas de campo numérico** (boxplot): mínimo, máximo, média, mediana, moda, soma, desvio padrão, variância, quartis, contagem e contagem nula, para campos numéricos de ticket ou de contato.

**Filtros disponíveis:** etapa, status do ticket (ganho/perdido/pendente), executivo, canal, intervenção humana e qualquer campo personalizado de ticket ou contato.

{% hint style="info" %}
Um dashboard de Tickets fica vinculado a **um único funil**: não é possível que um widget desse tipo compare ou misture dados de dois funis diferentes no mesmo gráfico. Se você precisar comparar dois funis, crie um dashboard de Tickets para cada um e revise-os em paralelo.
{% endhint %}

**Templates:** *Dashboard Ecommerce* (14 widgets: receita, conversão, trajeto, desempenho por canal) e *Dashboard de Pós-venda* (10 widgets: tickets, trajeto, campos personalizados, resoluções).

***

### 2. Dashboard de Conversas

Abrange toda a mensageria e a atividade do assistente, em nível de todo o workspace.

**Métricas gerais**

* **Métricas conversacionais** (cards): mensagens enviadas, mensagens de IA, mensagens humanas, mensagens recebidas, contatos criados, contatos ativos, conversas com IA, conversas totais, conversas com humano.
* **Economia:** dinheiro e tempo economizados pelas conversas atendidas por IA, de acordo com o custo da hora humana, moeda (CLP, USD, MXN, BRL, UF, ARS, COP, UYU, PEN, EUR e outras) e quantas conversas um executivo pode atender por dia.

**Volume e atividade**

* **Mensagens no tempo / Conversas no tempo** (linhas): agrupável por remetente, tipo (Humano/IA) ou canal, com intervalo configurável.
* **Contatos no tempo** (linhas): ativos ou criados.
* **Contatos atendidos no tempo** (linhas): por remetente ou tipo.
* **Mensagens por agente / Conversas por agente / Mensagens por canal / Conversas por canal** (barras ou pizza): com opção de detalhar Humano/IA dentro de cada barra.
* **Mapa de calor de mensagens** (dia × hora): volume de entrada ou saída.
* **Cobertura de IA:** distribuição de carga entre IA e humanos.
* **Carga fora do horário:** mensagens recebidas dentro vs. fora do horário comercial configurado.

**Qualidade e desempenho da IA**

* **Chamadas de funções no tempo / contagem** (linhas, barras ou pizza): uso de funções do assistente, agrupável por função ou por status (bem-sucedido/falho).
* **Latência de resposta da IA** (linhas): percentis de latência.
* **Alertas de latência da IA** (por motivo, por assistente, por função, no tempo): alta latência do modelo, timeout, erro do modelo, alta latência de função.
* **Taxa de alucinações no tempo** (linhas): % de respostas marcadas como alucinação.
* **Alucinações por tipo de guardrail / por assistente** (pizza, barras).
* **Casos capturados por juiz personalizado** (tabela).
* **Detalhe de alucinações** (tabela): listagem com link direto para o chat, filtrável por pendentes/resolvidas/todas.

**Agendamento**

* **Reuniões de calendário no tempo** (linhas): agrupável por status, canal, origem do agendamento (IA/não IA), pipeline, etapa ou assistente.
* **Reuniões de calendário (total)** (número), com comparação de período.

**Filtros disponíveis:** canal, tipo de remetente (humano/IA), remetentes específicos.

**Templates:** *Analíticas gerais* (6 widgets), *Analíticas de um canal* (3 widgets, um por canal), *Comparação de canais* (visão lado a lado).

***

### 3. Dashboard de Nível de Serviço (CSAT / NPS)

Requer escolher o tipo de pesquisa (CSAT ou NPS) e o(s) funil(is) a analisar.

* **Pontuação de satisfação** (número): NPS ou CSAT do período, com método de cálculo padrão ou média simples.
* **Satisfação do cliente no tempo** (linhas): evolução da pontuação.
* **Taxa de resposta** (número): % de pesquisas respondidas.
* **Distribuição de pontuações** (barras).
* **Distribuição por categoria** (pizza): promotores, passivos, detratores (aplica-se ao NPS).
* **Total de respostas** (número).
* **Respostas de feedback** (tabela): listagem individual com contato, ticket e atribuição humano/IA.

**Filtros disponíveis:** canal, intervenção humana.

{% hint style="info" %}
Ao contrário de Tickets, aqui você pode escolher **vários funis ao mesmo tempo**. Os dados são exibidos agregados em conjunto (não lado a lado, um contra o outro).
{% endhint %}

**Templates:** *Analíticas CSAT* (8 widgets), *Analíticas NPS* (7 widgets).

***

### 4. Dashboard de SLA

Mede o cumprimento dos seus acordos de nível de serviço.

* **Taxa de cumprimento de SLA** (número): % cumprido, por tipo de métrica (primeira resposta, próxima resposta, resolução) e atribuição (humano/IA).
* **Mapa de calor de SLA** (dia × hora): cumprimento ou quantidade de eventos.
* **Tendência de SLA** (linhas): cumprimento ao longo do tempo.
* **Inadimplências vs. cumpridos** (pizza).
* **Tempo de resolução de SLA** (número): média, P50 (mediana) ou P90.
* **Tempo de resposta da resolução** (número): tempo total de resolução, tempo de gestão interna ou tempo de espera do cliente.
* **Detalhamento do tempo de resolução** (pizza): gestão interna vs. espera do cliente.
* **Tendência de tempo de resolução / de resposta** (linhas).
* **Inadimplências de SLA** (tabela): detalhamento de inadimplências ativas ou concluídas.

**Filtros disponíveis:** pipeline, canal, agente, tipo de métrica, atribuição (humano/IA), percentil.

{% hint style="info" %}
Assim como em Nível de Serviço, aqui você pode escolher **vários funis ao mesmo tempo**, e os dados são agregados em conjunto, não comparados lado a lado.
{% endhint %}

**Templates:** *Cumprimento de serviço* (10 widgets, focado em resultado) e *Controle de níveis de serviço* (16 widgets, focado em gestão ativa e detecção de onde intervir).

***

### 5. Dashboard de Instagram

Focado na automação de comentários.

* **KPIs gerais** (número): métricas-chave da automação.
* **Atividade de automação** (linhas): respostas por tipo de ação.
* **Mapa de calor de atividade**: distribuição horária do processamento de comentários.
* **Posts em destaque** (tabela): posts com mais respostas automatizadas.

**Filtro:** conta específica do Instagram.

**Template:** *Estatísticas de Instagram* (4 widgets).

***

### Configuração comum a todos os dashboards

* **Criar do zero ou a partir de template:** os templates trazem widgets já configurados que você pode editar livremente.
* **Adicionar, editar ou remover widgets** de um dashboard existente: altere nome, tipo de visualização (ex.: barra ↔ pizza, pizza ↔ tabela) e filtros a qualquer momento.
* **Filtros em dois níveis:** em nível de todo o dashboard (aplicam-se a todos os widgets) ou em nível de cada widget individual. Em Tickets, alguns filtros são "universais" —status do ticket, executivo, canal e campos personalizados— e funcionam em qualquer widget, mesmo que não apareçam listados explicitamente.
* **Intervalo de datas e comparação automática** com o período anterior nos widgets numéricos.
* **Intervalos de agregação temporal:** hora, dia, semana, mês ou ano, nos widgets de séries temporais.
* **Cruzamento com campos personalizados:** qualquer campo de ticket ou de contato (texto, número, opções, sim/não) pode ser analisado em sua própria visualização.
* **Renomear e atualizar** filtros ou configuração de um dashboard já criado, a qualquer momento.

**Compartilhar dashboards**

Cada dashboard tem uma **visibilidade** geral —pública ou privada— que só quem o criou pode alterar. Além disso, ele pode ser compartilhado explicitamente com pessoas específicas da equipe, com dois níveis de acesso:

* **Leitura:** a pessoa só pode ver o dashboard.
* **Escrita:** além disso, também pode editá-lo.

Para que alguém convidado possa abrir um dashboard compartilhado, o cargo dessa pessoa dentro da conta precisa ter a permissão correspondente habilitada; se não tiver, o compartilhamento fica registrado, mas ela não poderá abri-lo até que seu cargo seja atualizado. Quem tiver permissão geral para ver análises pode ver todos os dashboards marcados como públicos, sem necessidade de um compartilhamento explícito.

***

### Como pedir para o PandAI criar análises para você

Você não precisa construir cada widget manualmente: você pode pedir para **PandAI** montar o gráfico, a tabela ou o dashboard completo em linguagem natural. Quanto mais específico você for, melhor ele entende o que você precisa.

#### Como formular um bom pedido

Um bom pedido ao PandAI normalmente inclui:

1. **O que você quer ver** (a métrica ou pergunta de negócio).
2. **Sobre quais dados** (funil, canal, etapa, campo personalizado).
3. **Em que período** (última semana, últimos 3 meses, comparado ao período anterior).
4. **Como você quer visualizar** (se tiver preferência: barras, linha do tempo, tabela).

{% hint style="success" %}
**Exemplos de bons pedidos:**

* "Mostre-me um gráfico de linhas com os tickets ganhos e perdidos do funil Vendas Chile, por semana, dos últimos 3 meses."
* "Monte uma tabela com a taxa de sucesso por executivo no funil de Suporte, ordenada do maior para o menor."
* "Quero um dashboard com: tráfego de etapas do funil Vendas, tickets por canal e taxa de sucesso no tempo."
* "Crie um mapa de calor de mensagens recebidas por dia e hora, para ver em quais horários preciso de mais pessoas disponíveis."
  {% endhint %}

{% hint style="warning" %}
Pedidos muito genéricos como "mostre-me como está tudo" obrigam o PandAI a adivinhar o que é importante para você. Seja específico sobre a métrica e o recorte de dados de que você precisa.
{% endhint %}

#### O que o PandAI pode fazer (e o que não pode)

O PandAI pode, diretamente do chat:

* Criar um novo dashboard, do zero ou a partir de um template.
* Adicionar widgets a um dashboard existente, um de cada vez.
* Editar o nome ou os filtros de um widget ou de um dashboard já criado.

Por enquanto, **não pode**:

* Excluir um widget existente (exclua-o diretamente pela interface).
* Duplicar ou clonar um dashboard completo.
* Exportar uma análise para PDF, Excel ou imagem a partir do chat.

{% hint style="warning" %}
Se você pedir ao PandAI para adicionar vários widgets de uma vez, é melhor pedir um por um ou confirmar que ele vá adicionando em etapas — adicionar muitos em paralelo pode desorganizar o layout do dashboard.
{% endhint %}

#### Exemplos por tipo de negócio

**Ecommerce / varejo**

* "Mostre-me o trajeto dos tickets desde 'Carrinho' até 'Compra confirmada', para ver onde mais os clientes desistem."
* "Compare as vendas no tempo dos últimos 2 meses com o mesmo período anterior."
* "Me dê a distribuição do meu campo personalizado 'Categoria de produto' com sua taxa de sucesso, para saber qual categoria vende mais."

**Imobiliária / serviços com ciclo de venda longo**

* "Mostre-me o tempo médio de permanência por etapa no meu funil de Vendas; quero saber onde os leads ficam parados."
* "Monte um boxplot do campo 'Orçamento do cliente' para entender a faixa de preços mais consultada."
* "Me dê a taxa de sucesso por executivo nos últimos 6 meses."

**Atendimento ao cliente / suporte**

* "Quero a taxa de cumprimento de SLA de primeira resposta do último mês, comparada com o mês anterior."
* "Mostre-me a resolução humano vs. IA do meu funil de Suporte, com sua taxa de conversão."
* "Me dê o detalhamento das alucinações pendentes de revisão das últimas 2 semanas."

**Agências / equipes comerciais com vários executivos**

* "Monte uma tabela de tickets ganhos e taxa de sucesso por executivo, do mês atual."
* "Mostre-me as conversas por canal, detalhadas por humano e IA."
* "Me dê o mapa de calor de mensagens por dia e hora, para planejar os turnos da minha equipe."

#### Situações e o que observar para obter feedback acionável

| O que te preocupa                                                | O que pedir ao PandAI                                                                                      |
| ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| "Sinto que estou perdendo leads, mas não sei onde"               | Fluxo de tickets + tráfego das etapas do funil, para ver em qual etapa a maioria desiste.                  |
| "Não sei se minha equipe está respondendo a tempo"               | Taxa de cumprimento do SLA de primeira resposta e tempo de resolução, comparado com o período anterior.    |
| "Quero saber se a IA está funcionando bem ou falhando"           | Taxa de alucinações ao longo do tempo + detalhe das alucinações pendentes + latência de resposta da IA.    |
| "Não sei em quais horários preciso de mais pessoas"              | Mapa de calor de mensagens recebidas por dia e hora.                                                       |
| "Quero saber se vale a pena ter IA atendendo"                    | Widget de Economia (dinheiro e tempo economizados) + resolução por humano vs. IA com taxa de conversão.    |
| "Não sei o que meus clientes mais perguntam"                     | Distribuição de um campo personalizado de texto ou de opções relacionado ao motivo do contato.             |
| "Quero saber se meus clientes estão satisfeitos"                 | Pontuação de satisfação (CSAT/NPS) ao longo do tempo + distribuição por categoria (promotores/detratores). |
| "Quero comparar o desempenho dos meus executivos"                | Tabela de taxa de sucesso e tickets ganhos por executivo, com filtro de período.                           |
| "Quero saber se minhas campanhas do Instagram estão funcionando" | KPIs gerais + posts destacados do painel do Instagram.                                                     |

***

### Em resumo

A Analítica da Vambe te permite construir o relatório exato que o seu negócio precisa: desde cartões simples até Sankeys de jornada de tickets, mapas de calor e cruzamentos com seus próprios campos personalizados. Se não souber por onde começar, use um modelo ou simplesmente peça ao PandAI em linguagem natural, sendo específico sobre a métrica, o recorte dos dados e o período que importa para você.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://academy.vambe.ai/analitica-de-datos/analitica-de-datos-pt-br/analise-dashboards-personalizados-e-relatorios.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
