Report Builder
O Report Builder é o editor visual de relatórios: você escolhe os campos, define os agrupamentos e o produto calcula o resultado em tempo real.
A tela
Depois de escolher o tipo de relatório na primeira etapa, o editor abre em três áreas:
| Área | O que faz |
|---|---|
| Barra lateral de campos | Todos os campos disponíveis daquele tipo, com busca |
| Painel do meio | As abas Grupos, Colunas e Filtros |
| Pré-visualização | A grade de resultado, atualizada automaticamente |
Passo a passo
- Escolha o tipo de relatório — contatos, conversas, usuários ou canais.
- Adicione colunas — arraste os campos da barra lateral para a área de colunas. A ordem é a ordem de exibição.
- Defina os grupos — arraste campos para a área de grupos para criar níveis aninhados. Cada nível gera subtotais.
- Configure os agregadores — por coluna, escolha a função: contagem, soma, média, mínimo ou máximo.
- Aplique filtros — os mesmos operadores e a lógica combinável das listas de exibição.
- Pré-visualize — a grade atualiza sozinha conforme você edita.
- Salvar e executar ou Salvar e fechar.
Barra de ferramentas
| Botão | O que faz |
|---|---|
| Desfazer / Refazer | Volta e refaz alterações da montagem, na memória da sessão |
| Salvar e executar | Grava o relatório e abre o resultado |
| Salvar e fechar | Grava e volta para a tela anterior |
| Propriedades | Nome, descrição e demais atributos do relatório |
Como o resultado é calculado
O motor agrupa os dados com ROLLUP: além das linhas de cada grupo, ele produz os subtotais de cada nível e o total geral. Os resultados respeitam os limites de linhas — relatórios muito detalhados são cortados, e o agregado continua correto.
Gráficos
O mesmo relatório que você monta na grade pode ser apresentado como gráfico — é o que transforma "quantos atendimentos por fila" em uma leitura de dois segundos. O gráfico reusa os agrupamentos do relatório como eixos.
Tipos disponíveis
| Gráfico | Como lê os dados |
|---|---|
Barras (bar) | Compara categorias; aceita séries |
Colunas (column) | Igual às barras, na vertical; aceita séries |
Linhas (line) | Tendência ao longo do tempo; aceita séries |
Área (area) | Tendência com volume; aceita séries |
Rosca (donut) | Composição do todo em uma volta; aceita total no centro |
Pizza (pie) | Composição do todo |
Funil (funnel) | Queda entre etapas, na ordem do relatório ou por valor |
Mapa de calor (heatmap) | Cruza dois agrupamentos mostrando onde a concentração está |
Os gráficos de composição (rosça, pizza, funil) mostram um valor por categoria; os de comparação (barras, colunas, linhas, área, mapa de calor) aceitam a segunda coluna de agrupamento como série.
Montando o gráfico
| Ajuste | O que define |
|---|---|
| Tipo | Um dos oito acima |
| Agrupar por | O eixo das categorias |
| Série | A segunda dimensão, quando o gráfico aceita |
| Medida | Contagem de registros ou uma coluna agregada (soma, média, mínimo, máximo) |
| Empilhamento | Nada, empilhado ou 100% |
| Mostrar valores | Escreve o número em cada ponto |
| Mostrar porcentagens | Fatia em percentual (composição) |
| Agrupar menores em "Outros" | Junta as categorias pequenas numa só |
| Mostrar total | Total no centro, na rosca |
| Ordenação do funil | Ordem do relatório, do maior para o menor ou o contrário |
| Legenda | Sem legenda, no topo, à esquerda, à direita ou embaixo |
Regras que o produto aplica
- O gráfico exige um relatório com agrupamento.
- Os eixos são o primeiro agrupamento — ou o primeiro e o segundo, em qualquer ordem; e não podem ser a mesma coluna.
- O mapa de calor exige série.
- Empilhamento (empilhado ou 100%) só em barras, colunas e área, e sempre com série.
- Porcentagens e "Outros" só em rosça, pizza ou funil, e só sobre uma medida que some — contagem ou soma. Média, mínimo e máximo não somam, então uma fatia delas não significa nada.
- Total só na rosça, e também só com contagem ou soma.
- Empilhamento 100% exige contagem ou soma.
Um gráfico inválido é recusado com o motivo da falha, apontando a coluna ou o ajuste com problema — inclusive quando a configuração chega por API ou MCP.
Qual gráfico usar
| Pergunta | Gráfico |
|---|---|
| Quem atende mais? | Barras ou colunas |
| Como o volume evolui no mês? | Linhas |
| Qual canal responde pela maior parte dos atendimentos? | Rosça |
| Onde o cliente desiste no funil? | Funil |
| Em que dia e horário a fila enche? | Mapa de calor com série |
| Quanto cada fila representa do total, com o total à vista? | Rosça com total e porcentagens |
Mobile
Em telas estreitas (abaixo de 768 px) o arrastar e soltar é substituído pela busca do campo, que adiciona o item com um toque. É o mesmo editor, sem gesto de arrastar.
Quando usar o Report Builder
| Situação | Caminho |
|---|---|
| Medir a operação de atendimento | Relatório do tipo conversas, agrupado por fila e por atendente |
| Acompanhar o funil comercial | Relatório de contatos ou oportunidades, agrupado por etapa |
| Auditar uso por usuário | Relatório do tipo usuários |
| Comparar canais | Relatório do tipo canais |
| Extrair uma lista para campanha | Relatório de contatos marcado como público de campanha |
Um relatório salvo é um contrato: o mesmo recorte que a diretoria vê na tela pode ser o mesmo que abastece uma campanha. Se o critério mudar, mude o relatório — não crie um segundo.