> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial/analises-e-registros/relatorios.md).

# Relatórios

Relatórios Gerais

{% hint style="warning" %}
**Disponível para o perfil: Administrador e Supervisor**
{% endhint %}

A página de **Relatórios** é a central de inteligência de dados do sistema Z-PRO. Ela permite a extração de informações detalhadas sobre a base de clientes e a performance operacional da equipe. Através de filtros avançados, o gestor pode gerar visões específicas e exportar os dados para planilhas (Excel/CSV), facilitando a tomada de decisão estratégica e a execução de campanhas de marketing direcionadas.

#### Principais funções

* **Extração de Base:** Download de listas de contatos com dados cadastrais completos.
* **Segmentação Geográfica e Comportamental:** Relatórios baseados em DDD (Estados) e Etiquetas.
* **Acompanhamento de Funil:** Análise de contatos distribuídos por colunas de Kanban.
* **Auditoria de Performance:** Métricas de produtividade individual por atendente.

#### Caso de uso

O gestor de uma empresa deseja realizar um pós-venda apenas com clientes do estado de São Paulo que foram atendidos pelo setor de "Suporte" e marcados com a etiqueta "Upgrade". Ele utiliza o relatório de **Contatos por Estado** para filtrar o DDD 11, cruza com o relatório de **Contatos por Etiqueta** e exporta a lista para o Excel para realizar um Envio em Massa.

#### Como acessar a página

Clique no Menu **Gestão Comercial** e selecione a aba **Relatórios**.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FdHfWpnW8vBLZnLbV7Myg%2Fimage.png?alt=media&amp;token=8d6daad8-9664-49ca-bce4-ab2e51832b3c" alt="" width="252"><figcaption></figcaption></figure>

***

#### Visão Geral dos Relatórios

Ao acessar a página, você verá cards que direcionam para cada modalidade de análise:

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FDYCKgD9Ylw9hjp0u1DFl%2Fimage.png?alt=media&amp;token=ea380341-0fdf-4a78-b77c-60817fd8edf7" alt=""><figcaption></figcaption></figure>

Abaixo, detalhamos cada tipo de relatório disponível e como utilizá-los:

**1. Relatório de Contatos**

Gera a lista completa de Contatos criados no sistema dentro de um intervalo de tempo.

* **Como usar:** Defina a **Data Início** e **Data Fim** do período de criação e clique em **Gerar Relatório**.
* **Dados exibidos:** Nome, WhatsApp, e-mail e informações cadastradas nos campos extras.
* **Finalidade:** Auditoria de crescimento da base e backup de cadastros.
*

```
<figure><img src="/files/vMVk4gMjYJf6vTEjVAgQ" alt=""><figcaption></figcaption></figure>
```

**2. Contatos por Etiqueta**

Segmenta a base de clientes conforme as marcações atribuídas.

* **Como usar:** Selecione uma ou mais Etiquetas no filtro suspenso e gere o relatório.
* **Dados exibidos:** Nome, WhatsApp e a lista de etiquetas vinculadas ao contato.
* **Finalidade:** Ideal para segmentação de campanhas de marketing e identificação de perfis de consumo.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FgHc0yZo7w7WArl7CcPNp%2Fimage.png?alt=media&amp;token=ee61ef41-6405-4a20-8215-5ced0bc0f2b3" alt=""><figcaption></figcaption></figure>

**3. Contatos por Estado (UF)**

Identifica a localização geográfica dos contatos baseando-se no código de área (DDD) do WhatsApp.

* **Como usar:** Selecione o estado (UF) desejado no filtro.
* **Dados exibidos:** Listagem de contatos pertencentes à região filtrada.
* **Finalidade:** Análise de alcance regional e campanhas sazonais por estado.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FHJ4FDCfsVVCkT7Zk6Ih4%2Fimage.png?alt=media&amp;token=ac03d277-7044-4e57-9c78-f156dc792e18" alt=""><figcaption></figcaption></figure>

**4. Contatos por Kanban**

Relatório focado na progressão dos leads ou processos dentro do fluxo comercial.

* **Como usar:** Selecione o quadro Kanban específico para analisar a distribuição dos cards.
* **Dados exibidos:** Nome do contato e em qual etapa (lane) do funil ele se encontra.
* **Finalidade:** Identificar gargalos no processo de vendas e volume de oportunidades em cada estágio.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FdVL6SMklZfS8BACNYY1x%2Fimage.png?alt=media&amp;token=ab398f33-c64c-4de7-9845-aa70d979aa2e" alt=""><figcaption></figcaption></figure>

**5. Contatos por Carteira**

Filtra os clientes com base no Usuário responsável pelo relacionamento (atendimento fixo).

* **Como usar:** Selecione uma ou mais **Carteiras** (atendentes).
* **Dados exibidos:** Lista de contatos vinculados aos usuários selecionados.
* **Finalidade:** Avaliação de distribuição de carga de trabalho e gestão de carteira de clientes por vendedor.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FoT1LfkGJx5UXvuneNsVG%2Fimage.png?alt=media&amp;token=3ddea71c-7cd2-40ac-914f-1aa874dd41c5" alt=""><figcaption></figcaption></figure>

**6. Atendimentos por Parâmetros**

O relatório mais granular do sistema, permitindo filtrar Tickets por diversas variáveis técnicas.

* **Filtros disponíveis:** Status (Aberto, Fechado, Pendente, Agendado), Conexões, Filas, Usuário, Canal e tipo de Demanda (Ativa/Receptiva). Também permite filtrar por valor mínimo/máximo, caso utilize campos financeiros.
* **Finalidade:** Auditoria técnica detalhada e extração de histórico de conversas para conformidade.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2F5TRZfsuwhFMhovJgnFf4%2Fimage.png?alt=media&amp;token=9722b1d0-19ad-4047-9dbb-93e993ab3e87" alt=""><figcaption></figcaption></figure>

**7. Produtividade Diária**

Mostra quanto cada atendente produziu em cada dia, considerando a data em que o atendimento aconteceu — e não a data em que o ticket foi criado.

* **Como usar:** Defina o período (ou use os atalhos **Hoje**, **7 dias**, **30 dias**, **90 dias**) e, se quiser, filtre por um **Atendente** específico. Clique em **Gerar**.
* **Dados exibidos:** 4 indicadores no topo — **Atendimentos** (com resposta do atendente no período), **Iniciados** (que receberam a primeira resposta no período), **Resolvidos** (encerrados no período) e **Mensagens** (enviadas manualmente pelos atendentes); um gráfico de **Atendimentos por dia**; uma tabela de **Resumo por atendente** (Atendimentos, Iniciados, Resolvidos, Mensagens, Dias ativos, Média por dia); e uma tabela de **Detalhe por dia**, cruzando atendente e data.
* **Finalidade:** Acompanhar a produtividade diária da equipe, inclusive em atendimentos abertos em dias anteriores que só receberam resposta dentro do período filtrado.

{% hint style="info" %}
**Por que os números podem diferir do "Resumo por Usuário":** este relatório considera a data em que a interação aconteceu, não a data de criação do ticket — um atendimento aberto ontem e respondido hoje entra na contagem de hoje. Mensagens automáticas (robô, campanha, agendadas) e notas internas não entram na contagem. Um mesmo atendimento respondido por dois atendentes diferentes conta para os dois.
{% endhint %}

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2Fv0H8yuJsB3pDHrvbfadW%2Fimage.png?alt=media&amp;token=9048ef18-406d-4b00-b825-47f6e795b54e" alt=""><figcaption></figcaption></figure>

**8. Resumo de Atendimentos por Usuário**

Relatório focado em produtividade e indicadores de desempenho (KPIs) da equipe.

* **Como usar:** Defina o período desejado e gere o relatório.
* **Dados exibidos:** Total de atendimentos por agente, divididos entre pendentes, em atendimento e resolvidos.
* **Finalidade:** Comparar a performance entre membros da Equipe e identificar a eficiência na resolução de demandas.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FYiPIhG7Ku9Eb35CJyLMk%2Fimage.png?alt=media&amp;token=2aab4ae6-4de3-4973-9cad-ed78e1291042" alt=""><figcaption></figcaption></figure>

***

#### Ações Disponíveis

Em cada modalidade de relatório, o sistema disponibiliza botões específicos para o processamento e extração dos dados:

* **Gerar Relatório:** Botão utilizado para processar os filtros selecionados (como intervalo de datas ou etiquetas) e carregar a lista de resultados na tabela de visualização. É necessário clicar neste botão sempre que os filtros forem alterados.
* **Exportar Excel:** Realiza o download imediato dos dados exibidos na tabela para um arquivo no formato `.xlsx`. Este formato é recomendado para análises que exijam fórmulas e formatação avançada em planilhas.
* **Exportar CSV:** Gera um arquivo de texto com os dados brutos separados por vírgulas. Este formato é ideal para importação manual em outros sistemas, CRMs ou ferramentas de tratamento de dados que não suportam arquivos Excel nativos.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FZyLNPMG6prlKvbltc7ni%2Fimage.png?alt=media&amp;token=be073bf1-2d2c-4f2d-b3b0-befc539ab9de" alt=""><figcaption></figcaption></figure>

***

#### Avisos e precauções

{% hint style="warning" %}
**Volume de Dados:** Ao gerar relatórios de períodos muito longos (ex: superior a 1 ano) com muitos filtros, o processamento pode levar alguns segundos. Aguarde a mensagem de conclusão antes de tentar exportar.
{% endhint %}

{% hint style="info" %}
**Exportação:** Todos os relatórios possuem o botão **Exportar Excel**. Recomenda-se aplicar os filtros antes de exportar para garantir que o arquivo contenha apenas os dados relevantes.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ajuda.zdg.com.br/configuracao-administrador/gestao-comercial/analises-e-registros/relatorios.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.