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

# Painéis Personalizados

> Crie painéis personalizados com widgets para rastrear suas métricas de chamadas e desempenho

Os Painéis Personalizados permitem que você construa visualizações de análise personalizadas com widgets de arrastar e soltar. Rastreie as métricas mais importantes para o seu negócio com estatísticas, gráficos e tabelas.

## O Que São Painéis Personalizados?

Páginas de análise personalizadas que você cria com widgets exibindo seus dados de chamadas. Cada painel contém múltiplos widgets mostrando diferentes visualizaçõ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áficos (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 Painel

1. Clique em **"Criar Painel Personalizado"** na barra lateral
2. Insira o nome (ex: "Desempenho de Vendas")
3. Escolha um ícone
4. Clique em **"Criar Painel"**

### Adicionar Widgets

**Opção 1: Usar Predefinições** (21 widgets prontos)

1. Clique em **"Desbloquear para personalizar"**
2. Clique no botão **"Adicionar"**
3. Selecione widget predefinido (marcado com emoji 📊📈📋)
4. Clique em **"Salvar"**

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

1. Clique em **"Gerenciar Widgets"** → **"Criar Novo 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 painel

## Tipos de Widget

### Widget de Estatística 📊

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

**Exemplos de uso:**

* Total de chamadas este mês
* Duração média de chamadas
* Porcentagem de taxa de sucesso

**Opções principais:**

* 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 (Cinza)
* Texto de rótulo e descrição
* Mostrar mini gráfico (tendência diária)
* Comparar com período anterior (mudança percentual)
* Intervalo de data: Today, Yesterday, Last 7/14/30/60/90 days, Last 6 months, Last year
* Condições (filtros)

### Widget de Gráfico 📈

Visualize tendências e distribuições.

**Tipos de gráfico:**

* **Linha** - Tendências ao longo do tempo
* **Barra** - Comparar categorias ou períodos de tempo
* **Área** - Gráfico de tendência preenchido
* **Pizza** - Proporções (requer Agrupar Por)
* **Rosca** - Pizza com centro vazio (requer Agrupar Por)
* **Área Polar** - Circular com raio variável (requer Agrupar Por)
* **Radar** - Comparação multi-eixo
* **Barra Radial** - Indicador único de progresso/porcentagem

**Opções principais:**

* 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 (Cinza)
* 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
* Mostrar linhas de grade, legenda, dicas de ferramenta, rótulos de dados, barra de ferramentas
* Curva da linha: smooth, straight, stepline
* Largura da linha: 1-10px
* Gradiente (somente radialBar)
* Intervalo de data: Today, Yesterday, Last 7/14/30/60/90 days, Last 6 months, Last year
* Condições (filtros)

### Widget de Tabela 📋

Registros detalhados com colunas classificáveis.

**Exemplos de uso:**

* Chamadas recentes com detalhes
* Chamadas falhadas para revisão
* Histórico de contato de leads

**Opções principais:**

* Fonte de dados: calls, leads, campaigns, assistants, phone\_numbers, sms
* Filtro de campanha (para leads - habilita colunas de variáveis)
* Filtro de assistente (para chamadas - habilita colunas de campo de avaliação)
* Seleção de coluna: básica, relacionamentos, campos de avaliação, variáveis de lead
* Ordenar por: qualquer coluna básica
* Direção de ordenação: desc (mais recente primeiro), asc (mais antigo primeiro)
* Linhas por página: 1-100
* Intervalo de data: 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 poderosos:

**Intervalos de data:** 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 **"Desbloquear para personalizar"**
2. Arraste widgets para reordenar
3. Redimensione widgets (1-12 colunas de largura)
4. Remova widgets com botão X
5. Clique em **"Salvar"** para persistir
6. Clique em **"Bloquear"** para sair do modo de edição

### Melhores Práticas

**Dimensionamento de 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
* Coloque tabelas na parte inferior

## Casos de Uso Comuns

### Painel de Vendas

* Estatística: Chamadas bem-sucedidas (filtrar 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 de chamadas
* Gráfico: Detalhamento de status de chamadas (gráfico de pizza)
* Tabela: Chamadas recentes com pontuações de avaliação

### Desempenho de Campanha

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

## Solução de Problemas

**Widget mostra "Sem dados":**

* Expanda o intervalo de data
* Verifique se os filtros não estão muito restritivos
* Verifique se você tem registros

**Carregamento lento:**

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

**Painel 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 de tipos de widget individuais.
</Note>
