# Agilize Docs para IA - Página atual Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize. Use esta versão quando a pergunta do usuário estiver restrita ao documento atual. Última geração: 2026-05-28T23:47:07.649Z ## Página - Título: Criar item de relatório - URL humana: https://agilize.app/docs/usuarios/relatorios-bi/relatorios-insights-bi-criacao-item-relatorio - Leitura completa para IA: https://agilize.app/docs/llms.txt - Descrição: Como criar um item de relatório no BI da Agilize, escolhendo fonte de dados, visualização, eixos, agregações, filtros, configuração visual e painel. ## Seções - Antes de começar - Fluxo recomendado - Crie ou selecione o item - Escolha a fonte de dados principal - Escolha o tipo de visualização - Configure colunas, eixos e dimensão - Aplique filtros e período - Ajuste a configuração visual ## Conteúdo da página # Criar item de relatório Um item de relatório é um gráfico, número ou tabela criado dentro de **Relatórios e Insights**. Ele pode ser usado sozinho para análise pontual ou adicionado a um painel para acompanhamento recorrente. Use este guia para criar um item do zero em [https://my.agilize.app/report/](https://my.agilize.app/report/), entendendo o impacto de cada escolha. Acesso pela tela: barra superior **Relatórios** > **Relatórios e Insights**. Pela lateral, troque para **Hub/CRM** e abra **Relatórios**. ## Antes de começar Defina primeiro a pergunta de negócio. Isso evita criar gráficos bonitos que não ajudam na decisão. Exemplos de boas perguntas: - quantas conversas chegaram por canal nesta semana? - quais origens geraram mais leads nos últimos 30 dias? - quais agentes têm mais tickets próximos do SLA? - qual departamento está com maior tempo de primeira resposta? - quais etapas do funil concentram mais oportunidades paradas? Também confirme se você tem permissão para criar ou editar relatórios. As fontes de dados disponíveis podem variar conforme acesso, projeto, configuração da conta e escopo de dados do usuário. Para usuários não administradores, a leitura do BI pode ser limitada por responsável e equipe organizacional. Supervisores configurados em uma equipe organizacional podem consultar dados do time e das subequipes quando a fonte de dados suporta esse recorte. Se o relatório estiver vazio ou menor do que o esperado, revise **Registros próprios**, equipe organizacional, supervisores e filtros de usuário antes de alterar o gráfico. ## Fluxo recomendado --- title: "Criação de um item de BI" caption: "Comece pela pergunta, escolha a fonte correta e só depois ajuste visual, filtros e painel." definition: | flowchart LR A[Pergunta de negócio] --> B[Fonte de dados] B --> C[Tipo de visualização] C --> D[Eixos, valor e dimensão] D --> E[Filtros e período] E --> F[Configuração visual] F --> G[Prévia e dados] G --> H[Salvar e adicionar ao painel] --- ## Crie ou selecione o item Em [https://my.agilize.app/report/](https://my.agilize.app/report/), a tela separa dois conceitos. Acesso pela tela: barra superior **Relatórios** > **Relatórios e Insights**. | Conceito | Para que serve | | --- | --- | | Painel | Agrupa vários itens de relatório em uma mesma visão de gestão. | | Relatório individual | Representa um item específico: gráfico, número ou tabela. | Para criar um item novo, use a seção de relatórios individuais. Depois de salvo, ele pode ser adicionado a um painel. Use nomes claros e orientados à decisão. Prefira **Leads por origem - últimos 30 dias** em vez de nomes como **Teste**, **Relatório novo** ou **Gráfico 1**. ## Escolha a fonte de dados principal A fonte de dados define quais campos estarão disponíveis para montar o relatório. Se a fonte estiver errada, filtros e gráficos podem até funcionar, mas responderão à pergunta errada. | Fonte | Use quando quiser analisar | | --- | --- | | Salas de Conversa | Estado das salas, pendências, arquivamento, canal, departamento, usuário atribuído, tags e dados de campanha. | | Conversas | Atendimentos iniciados ou concluídos, duração, avaliação, tempo de primeira resposta, canal e atendimento ativo ou receptivo. | | Tickets de Suporte | Demandas de suporte por status, prioridade, categoria, responsável, SLA, primeira resposta, resolução e reabertura. | | Eventos de Suporte | Histórico de mudanças e eventos registrados nos tickets. | | Ligações | Chamadas recebidas, realizadas, perdidas, status, duração, ramal, agente e número de origem. | | Leads | Oportunidades por funil, etapa, responsável, origem, valor, temperatura, tags e dados de campanha. | | Tarefas | Tarefas criadas, concluídas, pendentes, tipo, responsável, início, fim e data de conclusão. | | Eventos do Lead | Mudanças de etapa, etapa anterior, etapa destino, funil e duração na etapa anterior. | | Eventos de Marketing (WA) | Eventos relacionados a campanhas, anúncios e interações de marketing no WhatsApp. | Se estiver em dúvida entre duas fontes, volte à pergunta inicial. Para medir atendimento concluído, use conversas. Para medir oportunidades no funil, use leads. Para medir movimentação entre etapas, use eventos do lead. ## Escolha o tipo de visualização O tipo de visualização muda a leitura do relatório. A mesma fonte pode gerar uma tabela operacional, um gráfico de tendência ou um número executivo. | Visualização | Melhor uso | Cuidado | | --- | --- | --- | | Coluna vertical | Comparar categorias com poucos itens, como canais, origens, etapas ou responsáveis. | Evite quando houver muitas categorias ou nomes muito longos. | | Coluna horizontal | Rankings e categorias com nomes maiores, como agentes, departamentos ou motivos. | Ordene e filtre para não gerar listas extensas demais. | | Linha | Evolução no tempo, como volume por dia, mês ou ano. | Use campo de data no eixo principal. | | Pizza | Participação percentual de poucas categorias. | Não use com muitas fatias; a leitura fica imprecisa. | | Área | Evolução de volume ao longo do tempo, com ênfase na tendência. | Evite comparar muitas séries ao mesmo tempo. | | Valor numérico | Indicadores consolidados, como total de leads, média de tempo ou tickets abertos. | Funciona melhor com uma métrica objetiva e período bem definido. | | Tabela | Listagens, auditoria, análise detalhada e exportação. | Defina colunas e filtros para não virar uma base grande demais. | Quando usar **Valor numérico**, você pode comparar com o período anterior. Essa opção é útil para acompanhar crescimento, queda ou variação de um indicador simples. ## Configure colunas, eixos e dimensão ![Configuração de item de relatório com fonte de dados, tipo de visualização e seleção de campos](/docs/screenshots/bi-configuracao-item-selecao-campos.png) Depois de escolher a fonte, o construtor mostra as **colunas disponíveis**. Arraste ou selecione os campos conforme o tipo de visualização. | Campo de configuração | O que significa | | --- | --- | | Eixo X ou categoria | Campo usado para agrupar o resultado. Exemplos: canal, etapa, origem, responsável, data ou departamento. | | Eixo Y ou valor | Campo usado para calcular o número exibido. Pode ser uma contagem, soma, média, mínimo ou máximo. | | Dimensão ou agrupamento | Segundo recorte do relatório. Exemplos: leads por origem separados por funil, ou conversas por canal separadas por departamento. | | Campo para agrupar | No valor numérico, define o campo que será contado ou agregado. | | Coluna | Na tabela, define quais campos aparecerão na listagem. | Para campos de data no eixo principal, escolha o agrupamento temporal: | Agrupamento | Quando usar | | --- | --- | | Valor padrão | Quando o campo já tem a granularidade adequada. | | Agrupar por dia | Para rotina diária, volume recente e acompanhamento operacional. | | Agrupar por mês | Para leitura gerencial e tendência mensal. | | Agrupar por ano | Para histórico longo ou comparação anual. | Para campos numéricos, escolha a agregação correta: | Agregação | Quando usar | | --- | --- | | Contagem | Quantidade de registros, como número de leads, conversas, tickets ou tarefas. | | Soma | Total acumulado de um valor numérico, como valor de oportunidades. | | Média | Tempo médio, nota média ou média de valores. | | Mínimo | Menor valor registrado no recorte. | | Máximo | Maior valor registrado no recorte. | Se o campo de valor não for numérico, a contagem costuma ser a leitura mais segura. ## Aplique filtros e período Filtros reduzem o relatório ao recorte correto. Sem filtros, você pode misturar equipes, canais, períodos, funis e status que não deveriam ser comparados. Use filtros como: - período ou campo de data relevante; - usuário, responsável ou equipe; - canal, conta conectada ou departamento; - funil, etapa, origem ou tags; - status, prioridade, SLA, categoria ou subcategoria; - campanha, mídia, origem de campanha ou UTM, quando disponíveis. Ao escolher período, valide qual data está sendo usada. Data de criação, data de conclusão, início da conversa, primeira resposta, resolução e mudança de etapa podem representar momentos diferentes. ## Ajuste a configuração visual A configuração visual ajuda o relatório a ficar legível no painel. | Opção | Quando usar | | --- | --- | | Rótulos no gráfico | Quando os valores precisam aparecer diretamente no gráfico. | | Conteúdo dos rótulos | Use só valor para gráficos limpos; use item + valor quando houver espaço e poucos pontos. | | Colorir itens individuais | Bom para gráficos sem dimensão, em que cada barra ou fatia representa uma categoria. | | Paleta de cores | Use a paleta padrão para consistência; personalize apenas quando precisar destacar uma leitura. | | Tabela padrão ou cartões | Use tabela para análise densa; use cartões para leitura mais visual de poucos registros. | | Ordenação operacional | Use quando a categoria tem ordem de negócio, como etapas do funil. | Evite excesso de cores, dimensões e rótulos. Um painel bom deve permitir leitura rápida. ## Revise a prévia e os dados Antes de salvar, confirme: - se o título comunica o objetivo; - se a fonte de dados responde à pergunta; - se o período está correto; - se os filtros não estão amplos ou restritos demais; - se o usuário tem escopo de dados para consultar aquela equipe ou responsável; - se o eixo, valor e dimensão fazem sentido; - se a agregação não distorce a leitura; - se o gráfico fica legível no tamanho em que será usado no painel. Você também pode alternar para a visão de dados quando precisar conferir a tabela por trás do gráfico. Para análises externas, use exportação para Excel quando disponível. ## Adicione o item ao painel Depois de salvar o relatório individual, adicione-o ao painel correto. Em painéis com muitos indicadores, organize por finalidade: - visão executiva no topo; - indicadores de atendimento em um grupo; - indicadores de CRM em outro; - suporte e SLA em outro; - tabelas detalhadas no fim. Se o painel for usado em reunião recorrente, mantenha um padrão de período e nomes. Isso reduz dúvidas e evita comparações inconsistentes. ## Exemplos rápidos | Pergunta | Configuração sugerida | | --- | --- | | Quais origens geraram mais leads? | Fonte **Leads**, visualização **Coluna vertical**, eixo X **Origem**, eixo Y **Contagem**, filtro por período. | | Como evoluiu o volume de conversas? | Fonte **Conversas**, visualização **Linha**, eixo X com data agrupada por dia ou mês, eixo Y **Contagem**. | | Qual departamento tem maior tempo de resposta? | Fonte **Conversas**, visualização **Coluna horizontal**, eixo X **Departamento**, eixo Y com média do tempo de primeira resposta. | | Quais tickets estão em risco? | Fonte **Tickets de Suporte**, visualização **Tabela**, colunas de status, prioridade, responsável, prazo e alerta de SLA. | | Qual etapa concentra oportunidades? | Fonte **Leads**, visualização **Coluna vertical**, eixo X **Etapa**, eixo Y **Contagem**, ordenação operacional quando disponível. | ## Erros comuns - Criar o relatório sem uma pergunta de negócio. - Usar conversas quando a pergunta é sobre salas abertas ou pendentes. - Usar leads quando a pergunta é sobre mudança de etapa. - Comparar períodos incompletos com períodos fechados. - Usar soma quando deveria usar contagem. - Usar pizza com muitas categorias. - Adicionar dimensão demais e tornar o gráfico ilegível. - Confiar em origem, tag ou etapa sem padronização operacional. - Esquecer que atendimento concluído não significa, sozinho, oportunidade ganha ou problema resolvido. ## Próximos passos Para evoluir seus relatórios, revise também: - [Fontes de dados e campos](/docs/usuarios/relatorios-bi/relatorios-insights-bi-fontes-dados-campos); - [Filtros, períodos e agregações](/docs/usuarios/relatorios-bi/relatorios-insights-bi-filtros-periodos-agregacoes); - [Exemplos prontos](/docs/usuarios/relatorios-bi/relatorios-insights-bi-exemplos-prontos); - [Configurar painéis de BI](/docs/configuracao/relatorios-governanca/configurar-paineis-bi); - [Relatórios e indicadores](/docs/usuarios/relatorios-bi/relatorios-e-indicadores); - [Escopo de dados por equipe organizacional](/docs/configuracao/acessos-seguranca/escopo-dados-equipe-organizacional); - [CRM e oportunidades](/docs/usuarios/crm-relacionamento/crm-e-oportunidades); - [Suporte e registros de atendimento](/docs/usuarios/crm-relacionamento/suporte-e-registros-de-atendimento); - [Tags e classificação operacional](/docs/usuarios/crm-relacionamento/tags-e-classificacao-operacional); - [Rotina recomendada do gestor](/docs/usuarios/rotinas-por-perfil/rotina-recomendada-do-gestor).