> ## Documentation Index
> Fetch the complete documentation index at: https://doc.omnitechsolucoes.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Dashboards Personalizados

> Crie dashboards personalizados com widgets para acompanhar métricas de chamadas e desempenho

Os Dashboards Personalizados permitem criar visualizações analíticas sob medida com widgets de arrastar e soltar. Acompanhe as métricas mais importantes para o seu negócio com estatísticas, gráficos e tabelas.

## O que são Dashboards Personalizados?

Páginas analíticas personalizadas que você cria com widgets exibindo seus dados de chamadas. Cada dashboard contém vários widgets mostrando diferentes visões de dados.

<CardGroup cols={3}>
  <Card title="Widgets de Estatística" icon="chart-simple">
    Métricas únicas como total de chamadas, médias ou taxas de sucesso
  </Card>

  <Card title="Widgets de Gráfico" icon="chart-line">
    Tendências visuais com 8 tipos de gráfico (linha, barra, pizza, etc.)
  </Card>

  <Card title="Widgets de Tabela" icon="table">
    Registros detalhados com colunas e filtros personalizados
  </Card>
</CardGroup>

## Início Rápido

### Criar um Dashboard

1. Clique em **"Create Custom Dashboard"** na barra lateral
2. Informe o nome (ex.: "Desempenho de Vendas")
3. Escolha o ícone
4. Clique em **"Create Dashboard"**

### Adicionar Widgets

**Opção 1: Usar Presets** (21 widgets prontos)

1. Clique em **"Unlock to customize"**
2. Clique no botão **"Add"**
3. Selecione o widget preset (marcado com emoji 📊📈📋)
4. Clique em **"Save"**

**Opção 2: Criar Widget Personalizado**

1. Clique em **"Manage Widgets"** → **"Create New Widget"**
2. Escolha o tipo: Estatística, Gráfico ou Tabela
3. Configure a fonte de dados e opções
4. Salve o widget
5. Adicione ao dashboard

## Tipos de Widget

### Widget de Estatística 📊

Número único com comparação opcional e mini-gráfico.

**Exemplos de uso:**

* Total de chamadas no mês
* Duração média das chamadas
* Percentual de sucesso

**Principais opções:**

* Fonte de dados: calls, leads, campaigns, assistants, phone\_numbers, sms
* Agregação: COUNT, SUM, AVG, MAX, MIN
* Cor: Primary (Azul), Success (Verde), Warning (Laranja), Danger (Vermelho), Info (Ciano), Gray
* Texto de rótulo e descrição
* Mostrar mini-gráfico (tendência diária)
* Comparar com período anterior (variação percentual)
* Intervalo de datas: Today, Yesterday, Last 7/14/30/60/90 days, Last 6 months, Last year
* Condições (filtros)

### Widget de Gráfico 📈

Visualização de tendências e distribuições.

**Tipos de gráfico:**

* **Line** - Tendências ao longo do tempo
* **Bar** - Comparação de categorias ou períodos
* **Area** - Gráfico de tendência preenchido
* **Pie** - Proporções (requer Group By)
* **Donut** - Pizza com furo central (requer Group By)
* **Polar Area** - Circular com raio variável (requer Group By)
* **Radar** - Comparação multi-eixo
* **Radial Bar** - Indicador único de progresso/percentual

**Principais opções:**

* Fonte de dados: calls, leads, campaigns, assistants, phone\_numbers, sms
* Agregação: COUNT, SUM, AVG, MAX, MIN
* Tipo de gráfico: Line Chart, Bar Chart, Area Chart, Pie Chart, Donut Chart, Polar Area, Radar, Radial Bar
* Cor: Primary (Azul), Success (Verde), Warning (Laranja), Danger (Vermelho), Info (Ciano), Gray
* Agrupar por período: Hourly, Daily, Weekly, Monthly (para séries temporais)
* Agrupar por campo: status, campaign, assistant, qualquer coluna (para categorias)
* Altura do gráfico: 200-800px
* Exibir linhas de grade, legenda, tooltips, rótulos de dados, barra de ferramentas
* Curva da linha: smooth, straight, stepline
* Espessura da linha: 1-10px
* Gradiente (apenas radialBar)
* Intervalo de datas: Today, Yesterday, Last 7/14/30/60/90 days, Last 6 months, Last year
* Condições (filtros)

### Widget de Tabela 📋

Registros detalhados com colunas ordenáveis.

**Exemplos de uso:**

* Chamadas recentes com detalhes
* Chamadas com falha para revisão
* Histórico de contato do lead

**Principais opções:**

* Fonte de dados: calls, leads, campaigns, assistants, phone\_numbers, sms
* Filtro de campanha (para leads – habilita colunas de variáveis)
* Filtro de assistente (para calls – habilita colunas de campos de avaliação)
* Seleção de colunas: básicas, relacionamentos, campos de avaliação, variáveis do lead
* Ordenar por: qualquer coluna básica
* Direção de ordenação: desc (mais recentes primeiro), asc (mais antigas primeiro)
* Linhas por página: 1-100
* Intervalo de datas: Today, Yesterday, Last 7/14/30/60/90 days, Last 6 months, Last year
* Condições (filtros)

## Filtragem de Dados

Todos os widgets suportam filtros avançados:

**Intervalos de datas:** Today, Yesterday, Last 7/14/30/60/90 days, Last 6 months, Last year

**Condições:** Múltiplos filtros AND

* Status igual a "completed"
* Duração maior que 60 segundos
* Nome do assistente igual a "Sales Bot"

**Campos de avaliação:** Filtrar por valores de avaliação pós-chamada

* Coluna: Extracted Variables
* Nome da Variável Extraída: Variável personalizada
* Nome da Variável Personalizada: appointment\_booked
* Operador: =
* Valor da Variável: true

## Gerenciamento de Layout

### Modo de Edição

1. Clique em **"Unlock to customize"**
2. Arraste os widgets para reorganizar
3. Redimensione widgets (1-12 colunas de largura)
4. Remova widgets com o botão X
5. Clique em **"Save"** para salvar
6. Clique em **"Lock"** para sair do modo de edição

### Melhores Práticas

**Tamanho dos widgets:**

* Estatísticas: 3-4 colunas (cabem 3-4 por linha)
* Gráficos: 6-12 colunas
* Tabelas: 12 colunas (largura total)

**Dicas de layout:**

* Coloque KPIs no topo
* Agrupe métricas relacionadas
* Posicione tabelas na parte inferior

## Casos de Uso Comuns

### Dashboard de Vendas

* Estatística: Chamadas bem-sucedidas (filtro por campo de avaliação "appointment\_booked")
* Gráfico: Tendência diária de chamadas bem-sucedidas
* Tabela: Chamadas recentes bem-sucedidas com detalhes de agendamento

### Qualidade de Suporte

* Estatística: Duração média das chamadas
* Gráfico: Distribuição de status das chamadas (gráfico de pizza)
* Tabela: Chamadas recentes com pontuações de avaliação

### Desempenho de Campanha

* Estatística: Total de chamadas da campanha
* Gráfico: Chamadas por campanha (gráfico de barras)
* Tabela: Campanhas com melhor desempenho

## Solução de Problemas

**Widget exibindo "No data":**

* Amplie o intervalo de datas
* Verifique se os filtros não estão restritivos demais
* Confirme se existem registros

**Carregamento lento:**

* Reduza a quantidade de widgets (mantenha abaixo de 20)
* Utilize filtros de intervalo de datas
* Limpe o cache do navegador

**Dashboard não aparece na barra lateral:**

* Atualize a página
* Verifique se o plano inclui o recurso

<Note>
  Para configuração detalhada, consulte os guias individuais de cada tipo de widget.
</Note>
