> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/operacao-uso-do-sistema/dashboard.md).

# Dashboard

### Finalidade

O **Dashboard** (tela **Dashboard Executivo**) é a página inicial do DigiCRM. Reúne indicadores de atendimento, produtividade, canais, NPS e desempenho da equipe, conforme o período e as filas selecionados.

Não confundir com o menu **Painel** (grupo Atendimentos), que é outra tela operacional de tickets.

**Caminho:** menu lateral → **Dashboard**

<figure><img src="/files/EOGFZ8yjb7WO409THMnw" alt=""><figcaption></figcaption></figure>

***

### O que você vê na tela

#### Cabeçalho

* Título **Dashboard Executivo** e subtítulo
* Logo da empresa (tenant)
* Botão **Editar** — personalizar layout (em telas maiores)
* Botão **Gerar análise IA** — apenas para admin/super e se a IA estiver habilitada
* Horário da última atualização

#### Banners (opcional)

Se a empresa tiver anúncios configurados, aparece um carrossel de banners clicáveis no topo.

#### Alerta de versão (admin master)

Admins master podem ver aviso de atualização disponível, com changelog expansível.

***

### Como filtrar os dados

1. Clique no ícone de filtro na barra de período.
2. Use um **filtro rápido** ou escolha o **período** manualmente.
3. (Opcional) Selecione um ou mais **setores/filas**.
4. Clique em **Filtrar** ou no ícone de atualizar.

\[\[FOTO]]

#### Filtros rápidos

| Opção          | Significado                      |
| -------------- | -------------------------------- |
| Hoje           | Dia atual                        |
| Ontem          | Dia anterior                     |
| Últimos 7 dias | Inclui hoje                      |
| Esta semana    | Semana atual (segunda a domingo) |
| Este mês       | Mês atual                        |
| Mês passado    | Mês anterior                     |
| Este ano       | Ano atual                        |
| Todo período   | Sem recorte restrito             |

#### Campos do painel de filtros

| Campo                   | Descrição                                     |
| ----------------------- | --------------------------------------------- |
| Período                 | Data inicial e final                          |
| Setores                 | Multiseleção de filas; vazio = todas as filas |
| Visibilidade das seções | Mostrar/ocultar blocos (NPS, gráficos, etc.)  |

Chips na barra superior mostram as filas ativas; dá para remover uma fila pelo “x” do chip.

#### Aviso de período longo

Se o intervalo for **maior que 30 dias**, aparece o aviso: métricas **ao vivo** continuam instantâneas e podem **não** refletir o período escolhido.

***

### Cards e indicadores

Cada card pode ter selo:

* **Período** — agregado do filtro de datas
* **Tempo real** — snapshot do momento (ou quando o período inclui o dia de hoje)

Em vários KPIs há **Ver cálculo**, que explica fórmula e fonte dos dados.

#### Visão geral (todos os perfis)

| Card                  | O que mostra                                 |
| --------------------- | -------------------------------------------- |
| Total de atendimentos | Tickets criados no período                   |
| Demanda ativa         | Tickets iniciados pela empresa               |
| Demanda receptiva     | Tickets iniciados pelo cliente               |
| Novos contatos        | Contatos criados no período                  |
| Atividade por hora    | Distribuição de atendimentos ao longo do dia |
| Desempenho da equipe  | Tabela por atendente                         |

#### Produtividade (admin / super)

| Card                  | O que mostra                       |
| --------------------- | ---------------------------------- |
| Taxa de ocupação      | Horas ocupadas ÷ horas base × 100  |
| Tickets por hora      | Total de tickets ÷ horas base      |
| Taxa de resolução     | Fechados ÷ total × 100             |
| Atendentes online     | Online agora ÷ total de atendentes |
| Ranking de atendentes | Top 5 do período                   |

**Base de cálculo** (na edição do dashboard) altera ocupação e tickets/hora:

* Jornada fixa (8h)
* Tempo logado real
* Jornada cadastrada
* Horário de atendimento (respeita horários/feriados)

#### Totais e tempos (admin / super)

| Card                | O que mostra                                                            |
| ------------------- | ----------------------------------------------------------------------- |
| Total de canais     | Canais cadastrados (tempo real)                                         |
| Total de usuários   | Usuários cadastrados (tempo real)                                       |
| Mensagens enviadas  | Total no período                                                        |
| Mensagens recebidas | Total no período                                                        |
| TMA                 | Tempo médio de atendimento (criação → fechamento, no horário útil)      |
| TME                 | Tempo médio de espera / 1ª resposta (criação → início, no horário útil) |

#### Gráficos e seções (admin / super)

| Seção                    | Conteúdo                                            |
| ------------------------ | --------------------------------------------------- |
| NPS                      | Score, respostas, média e gráficos por fila/usuário |
| Distribuição por fila    | Donut / pizza por setor                             |
| Distribuição por canal   | Donut / pizza por canal                             |
| Mensagens por período    | Enviadas × recebidas                                |
| Evolução por canal       | Barras empilhadas                                   |
| Evolução de atendimentos | Linha no tempo                                      |
| Nuvem de palavras        | Termos mais frequentes nas conversas                |

#### Tempo real (admin / super — cards opcionais no catálogo)

| Card                   | Conteúdo                                              |
| ---------------------- | ----------------------------------------------------- |
| Operação agora         | Pendentes, em atendimento, finalizados hoje, TMA hoje |
| SLA em tempo real      | Dentro / atenção / fora do SLA                        |
| Carga por atendente    | Em atendimento × finalizados hoje                     |
| Fila ao vivo           | Tickets aguardando                                    |
| Em atendimento ao vivo | Tickets em andamento                                  |

#### Tabela Desempenho da equipe

Colunas: Usuário, Pendentes, Atendendo, Finalizados, Total, T.M.E, T.M.A.

***

### Personalizar o dashboard

As preferências são **por usuário** (salvas na configuração do usuário).

1. Clique em **Editar**.
2. Arraste cards para reordenar.
3. Remova cards ou use **Adicionar card** para trazer de volta.
4. Ajuste tema:
   * Presets de cor / cor destaque
   * Modo Auto, Claro ou Escuro
   * Cabeçalho Gradiente ou Sólido
   * Densidade Confortável ou Compacto
   * Base de cálculo de produtividade
5. **Salvar**, **Cancelar** ou **Resetar** (volta ao layout padrão).

***

### Análise operacional com IA

1. Defina um período válido e (opcional) filas.
2. Clique em **Gerar análise IA**.
3. O sistema gera um resumo com score (0–100), alertas, ações recomendadas, riscos e oportunidades.
4. Use **Ver relatório completo** para abrir o detalhe, se disponível.

***

### Permissões

| Perfil        | O que vê                                                                               |
| ------------- | -------------------------------------------------------------------------------------- |
| Usuário       | KPIs básicos, atividade por hora, desempenho da equipe                                 |
| Admin / Super | Cards de produtividade, totais, TMA/TME, NPS, gráficos, nuvem, tempo real e análise IA |

***

### Regras importantes

* Filtros de **período** e **fila** valem para a maioria dos indicadores agregados.
* Cards de **tempo real** (online, ocupação, canais, usuários, blocos “ao vivo”) não seguem o intervalo histórico da mesma forma.
* Período **> 30 dias** dispara aviso sobre métricas ao vivo.
* Personalização do layout é individual; não altera o dashboard dos outros usuários.
* TMA e TME consideram horário de atendimento e feriados (hierarquia WhatsApp → Usuário → Fila → Global).

***

### Mensagens e erros comuns

| Situação                     | O que acontece                                                   |
| ---------------------------- | ---------------------------------------------------------------- |
| Atualização ok               | Notificação “Dashboard atualizado”                               |
| Personalização salva         | “Dashboard personalizado salvo”                                  |
| Falha ao salvar layout       | “Erro ao salvar personalização”                                  |
| Análise IA sem período       | “Defina um período válido…”                                      |
| Poucos dados no período      | Aviso de dados insuficientes                                     |
| IA desligada / falhou        | Mensagem de IA indisponível                                      |
| Sem dados no gráfico/ranking | Estados vazios (“Sem dados aqui!”, “Sem dados no período”, etc.) |

***

### Dicas de uso

* Use **Hoje** ou **Últimos 7 dias** no dia a dia; reserve períodos longos para análises pontuais.
* Filtre por fila antes de olhar ranking e TMA/TME.
* Use **Ver cálculo** quando houver dúvida sobre um número.
* Em operação ao vivo, adicione os cards do grupo **tempo real** pelo modo Editar.
