# 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:48:48.873Z

## Página

- Título: Filtros, períodos e agregações
- URL humana: https://agilize.app/docs/usuarios/relatorios-bi/relatorios-insights-bi-filtros-periodos-agregacoes
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Como usar período global, filtros por campo, agrupamentos de data e agregações no BI da Agilize sem distorcer a leitura dos relatórios.

## Seções

- Antes de começar
- Como o recorte é aplicado
- Período global
- Filtros de data
- Qual data usar
- Agrupamento temporal
- Filtros por texto
- Filtros por número

## Conteúdo da página

# Filtros, períodos e agregações

Filtros, períodos e agregações definem o recorte real de um relatório. Eles respondem a três perguntas: **quais registros entram**, **qual data define o período** e **como o valor será calculado**.

Use este guia ao configurar relatórios em [https://my.agilize.app/report/](https://my.agilize.app/report/), principalmente quando o mesmo painel precisa comparar atendimento, CRM, suporte, tarefas, ligações e campanhas. 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

Antes de aplicar filtros, confirme:

- qual pergunta o relatório precisa responder;
- qual fonte de dados representa essa pergunta;
- qual campo de data deve controlar o período;
- se o relatório precisa contar registros, somar valores ou calcular média;
- se filtros de usuário, equipe, canal, funil, etapa, origem, tag ou status são necessários para evitar mistura de contextos.

Um relatório sem recorte pode parecer completo, mas normalmente mistura operações diferentes. Um relatório filtrado demais pode esconder gargalos reais.

## Como o recorte é aplicado

---
title: "Como o BI recorta os dados"
caption: "A leitura correta depende da sequência: fonte, período, filtros, agrupamento e agregação."
definition: |
  flowchart LR
    A[Fonte de dados] --> B[Campo de data]
    B --> C[Período global ou filtro de data]
    C --> D[Filtros adicionais]
    D --> E[Eixo ou categoria]
    E --> F[Agregação do valor]
    F --> G[Gráfico, número ou tabela]
---

## Período global

O **período global** é o seletor de período do painel ou do relatório. Ele permite alterar rapidamente o intervalo analisado sem editar cada item individualmente.

Opções comuns:

| Período | Quando usar |
| --- | --- |
| Hoje | Acompanhamento operacional do dia. |
| Últimas 24 horas | Operações que atravessam virada de dia ou precisam de janela móvel. |
| Ontem | Fechamento do dia anterior. |
| Esta semana | Gestão semanal em andamento. |
| Últimos 7 dias | Janela móvel recente, útil para comparar tendência. |
| Este mês | Acompanhamento mensal corrente. |
| Mês passado | Fechamento mensal anterior. |
| Últimos 30 dias | Janela móvel de volume e produtividade. |
| Últimos 3 meses | Tendência trimestral curta. |
| Últimos 6 meses | Tendência semestral. |
| Este ano | Visão acumulada do ano. |
| Último ano | Comparação anual fechada. |
| Personalizado | Intervalo específico com data inicial e final. |

O período global só controla um item quando existe um **filtro de data marcado como Global**. Se o relatório tiver uma data fixa sem essa marcação, alterar o período do painel não muda aquele filtro.

## Filtros de data

Campos de data podem usar:

| Opção | Como funciona | Quando usar |
| --- | --- | --- |
| Período | Usa opções como hoje, últimos 7 dias, este mês ou últimos 30 dias. | Para relatórios recorrentes. |
| Personalizado | Usa uma data inicial e uma data final. | Para auditoria, fechamento ou análise pontual. |
| É nulo | Mantém registros sem valor naquele campo de data. | Para encontrar pendências, ausência de conclusão ou dados incompletos. |
| Não é nulo | Mantém registros que já têm valor naquele campo de data. | Para analisar eventos concluídos ou registros com etapa preenchida. |
| Global | Permite que o período do painel controle aquele filtro. | Para painéis que precisam mudar de período de forma centralizada. |

Ao selecionar uma fonte de dados, o BI normalmente cria um filtro de data padrão para a data principal daquela fonte. Revise esse filtro antes de salvar: a data padrão ajuda no início, mas nem sempre é a data certa para a pergunta.

## Qual data usar

Datas diferentes respondem perguntas diferentes. A maior causa de leitura errada em BI é usar a data errada.

| Tipo de data | O que mede | Exemplo de uso |
| --- | --- | --- |
| Data de criação | Quando o registro entrou na base. | Leads criados, tickets abertos, salas iniciadas ou tarefas criadas no período. |
| Início | Quando um atendimento, chamada ou tarefa começou. | Volume iniciado por dia, semana ou mês. |
| Fim ou conclusão | Quando um atendimento, chamada ou tarefa foi encerrado. | Produtividade concluída no período. |
| Primeira resposta | Quando o cliente recebeu a primeira resposta operacional. | Análise de tempo de resposta e SLA. |
| Prazo ou alerta de SLA | Quando o ticket vence ou entra em risco. | Priorização de suporte. |
| Resolução ou finalização | Quando o suporte foi resolvido ou finalizado. | Fechamento de demandas e produtividade de suporte. |
| Última interação | Quando houve a interação mais recente. | Registros parados, salas sem movimentação ou tickets sem atualização. |
| Mudança de etapa | Quando uma oportunidade passou de uma etapa para outra. | Evolução do funil e tempo por etapa. |
| Próxima tarefa | Quando a próxima ação está prevista. | Oportunidades com follow-up vencido ou futuro. |

Exemplo: para saber quantos leads foram criados no mês, use **Data de Criação**. Para saber quantos leads avançaram de etapa no mês, use **Eventos do Lead** e **Data da Mudança**.

## Agrupamento temporal

Quando o eixo principal usa um campo de data, o BI permite agrupar a data.

| Agrupamento | Quando usar | Cuidado |
| --- | --- | --- |
| Valor padrão | Quando a data já está na granularidade adequada. | Pode gerar categorias demais se houver muitos dias ou horários. |
| Por dia | Rotina diária, volume recente e operação. | Evite em períodos muito longos. |
| Por mês | Gestão mensal, tendência e comparação gerencial. | Pode esconder picos diários relevantes. |
| Por ano | Histórico longo e visão executiva. | Fica amplo demais para decisões operacionais. |

Use **linha** ou **área** para evolução temporal. Use **coluna** quando a intenção for comparar períodos fechados, como meses ou anos.

## Filtros por texto

Campos de texto aceitam operadores úteis para busca, auditoria e segmentação por valores livres.

| Operador | Uso recomendado |
| --- | --- |
| Contém | Buscar parte de um texto, como campanha, URL, origem, termo ou ramal. |
| Não contém | Remover um padrão indesejado. |
| É igual a | Filtrar valor exato quando há padronização. |
| É diferente de | Excluir um valor específico. |
| Começa com | Filtrar prefixos, códigos, campanhas ou padrões de nome. |
| Termina com | Filtrar sufixos ou padrões finais. |
| É nulo | Encontrar registros sem preenchimento. |
| Não é nulo | Considerar apenas registros preenchidos. |

Prefira filtros de texto quando o campo não tem lista controlada. Para status, canal, responsável, equipe, funil ou etapa, use os campos de seleção ou relacionamento sempre que disponíveis.

## Filtros por número

Campos numéricos aceitam comparação direta.

| Operador | Exemplo |
| --- | --- |
| Igual | Nota de avaliação igual a 5. |
| Diferente | Status numérico diferente de determinado valor, quando aplicável. |
| Maior que | Duração maior que 300 segundos. |
| Maior ou igual a | Ticket maior ou igual a R$ 1.000. |
| Menor que | Tempo menor que 60 segundos. |
| Menor ou igual a | Reaberturas menor ou igual a 1. |
| É nulo | Registros sem valor numérico preenchido. |
| Não é nulo | Registros com valor numérico preenchido. |

Para campos de duração, lembre que o valor base pode estar em segundos, mesmo que a tela mostre a duração formatada.

## Filtros por seleção e relacionamento

Campos ligados a cadastros ou listas controladas devem ser filtrados por seleção. Isso inclui usuário, equipe, departamento, funil, etapa, origem, canal, status, prioridade, categoria, anúncio e campos semelhantes.

| Operador | Quando usar |
| --- | --- |
| É | Um valor específico, como um responsável ou uma etapa. |
| Não é | Excluir um valor específico. |
| Contém um | Campos que aceitam múltiplos valores, como tags. |
| Não contém nenhum | Remover registros com determinados valores. |
| É nulo | Encontrar registros sem vínculo, sem responsável ou sem classificação. |
| Não é nulo | Considerar apenas registros classificados ou vinculados. |

Em campos de tags e classificações múltiplas, use filtros com cuidado. Se você filtra por uma tag e usa a mesma tag como agrupamento, a leitura tende a mostrar apenas a parte do universo que já passou por esse recorte.

## Agregações do valor

A agregação define como o campo de valor será calculado.

| Agregação | O que faz | Quando usar | Cuidado |
| --- | --- | --- | --- |
| Contagem | Conta registros. | Quantidade de leads, conversas, tickets, tarefas, ligações ou eventos. | Se a fonte representa eventos, o mesmo cliente pode aparecer mais de uma vez. |
| Soma | Soma valores numéricos. | Ticket total, duração total ou total acumulado de um campo numérico. | Só faz sentido para campos numéricos que podem ser acumulados. |
| Média | Calcula valor médio. | Tempo médio, nota média, ticket médio, reaberturas médias. | Médias escondem extremos; combine com tabela quando houver dúvida. |
| Mínimo | Mostra o menor valor. | Menor tempo, menor ticket ou menor nota no recorte. | Pouco útil sozinho em painéis executivos. |
| Máximo | Mostra o maior valor. | Maior duração, maior ticket ou maior tempo em etapa. | Um valor extremo pode distorcer a percepção. |

Soma, média, mínimo e máximo só devem ser usados em campos numéricos. Para campos de texto, data, seleção ou relacionamento, a leitura mais segura é **Contagem**.

## Contagem não é sempre cliente único

Contagem significa quantidade de registros da fonte escolhida.

| Fonte | O que a contagem representa |
| --- | --- |
| Salas de Conversa | Salas. |
| Conversas | Atendimentos/conversas registradas. |
| Leads | Oportunidades. |
| Eventos do Lead | Movimentações de etapa. |
| Tarefas | Tarefas. |
| Tickets de Suporte | Tickets. |
| Eventos de Suporte | Eventos registrados no ticket. |
| Ligações | Chamadas. |
| Eventos de Marketing (WA) | Eventos de campanha. |

Se você precisa contar clientes únicos, contatos únicos ou empresas únicas, confirme se a fonte e o campo escolhidos representam esse universo. Não use contagem de eventos como se fosse contagem de pessoas.

## Comparação com período anterior

Em relatórios do tipo **Valor numérico**, é possível comparar o valor atual com o período anterior quando o item usa um filtro de data controlado pelo período global.

Use para:

- leads criados versus período anterior;
- conversas concluídas versus período anterior;
- tickets abertos ou finalizados versus período anterior;
- média de tempo de resposta versus período anterior;
- valor total de oportunidades versus período anterior.

Evite quando:

- o período atual ainda está incompleto e será comparado com um período fechado;
- o campo de data usado não representa o evento que você quer comparar;
- o volume é muito baixo e qualquer variação pequena vira percentual exagerado;
- a métrica é sazonal, como campanhas ou datas comemorativas.

## Combinações recomendadas

| Pergunta | Fonte | Data | Agregação | Filtros úteis |
| --- | --- | --- | --- | --- |
| Quantas conversas foram concluídas por canal? | Conversas | Fim do Atendimento ou Início do Atendimento, conforme a regra de gestão | Contagem | Tipo de canal, conta, departamento, atendente. |
| Qual foi o TPA médio por departamento? | Conversas | Início do Atendimento | Média | Departamento, canal, período global. |
| Quantos leads entraram por origem? | Leads | Data de Criação | Contagem | Origem, funil, campanha, responsável. |
| Qual é o ticket total por etapa? | Leads | Data de Criação ou Data do Estágio | Soma | Funil, etapa, responsável, origem. |
| Quanto tempo os leads ficam em cada etapa? | Eventos do Lead | Data da Mudança | Média | Funil, etapa anterior, etapa destino. |
| Quais tickets estão próximos do SLA? | Tickets de Suporte | Prazo ou Alerta de SLA | Contagem | Status, prioridade, equipe, responsável. |
| Quantas tarefas foram concluídas por usuário? | Tarefas | Data de Conclusão | Contagem | Responsável, tipo, finalizada. |
| Quantas ligações foram perdidas? | Ligações | Início da Chamada | Contagem | Status, usuário, chamada de saída. |

## Erros comuns

- Usar **Data de Criação** para medir conclusão.
- Usar **Leads** para medir movimentação de etapa, quando a pergunta pede **Eventos do Lead**.
- Comparar semana atual incompleta com semana anterior completa.
- Usar **Soma** em um campo que deveria ser contado.
- Usar **Média** sem verificar valores extremos.
- Aplicar período global, mas esquecer de marcar o filtro de data como global.
- Misturar canais, equipes ou funis que têm regras operacionais diferentes.
- Filtrar por texto livre quando existe um campo controlado.
- Usar tags sem padronização e interpretar o resultado como classificação confiável.
- Criar dimensão demais e transformar o gráfico em várias séries difíceis de ler.

## Checklist antes de salvar

- A fonte de dados responde à pergunta?
- O campo de data representa o momento correto?
- O período global está ligado ao filtro de data certo?
- A agregação combina com o tipo do campo?
- Os filtros excluem apenas o que realmente deve ficar fora?
- A dimensão melhora a análise ou só aumenta ruído?
- O relatório continua legível no painel?
- O nome do relatório deixa claro período, métrica ou recorte?

## Próximos passos

Para completar a configuração do BI, revise também:

- [Criar item de relatório](/docs/usuarios/relatorios-bi/relatorios-insights-bi-criacao-item-relatorio);
- [Fontes de dados e campos](/docs/usuarios/relatorios-bi/relatorios-insights-bi-fontes-dados-campos);
- [Exemplos prontos](/docs/usuarios/relatorios-bi/relatorios-insights-bi-exemplos-prontos);
- [Relatórios e indicadores](/docs/usuarios/relatorios-bi/relatorios-e-indicadores);
- [Padronizar indicadores da operação](/docs/configuracao/relatorios-governanca/padronizar-indicadores-operacao).
- [CRM e oportunidades](/docs/usuarios/crm-relacionamento/crm-e-oportunidades);
- [Suporte e registros de atendimento](/docs/usuarios/crm-relacionamento/suporte-e-registros-de-atendimento).