> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/desk-hyperflow/configuracoes/parametros/relatorios.md).

# Relatórios

A aba **Relatórios** permite adicionar colunas extras e personalizadas ao arquivo exportado pelo **Relatório de Atendimentos**. Com isso, você pode incluir informações cadastradas nos contatos — como CPF, plano, segmento ou qualquer outro campo personalizado — diretamente na planilha de relatório.

## 🗂️ Como acessar

1. No menu lateral, clique em **Configurações**.
2. Clique em **Parâmetros**.
3. Selecione a aba **Relatórios**.

<figure><img src="/files/eDVNjjvi3aEJ62a0MTF0" alt=""><figcaption><p>Imagem 1 - Acessando a aba de 'Relatórios'.</p></figcaption></figure>

***

## ➕ Adicionando colunas personalizadas

### 🎯 Propósito

Enriquecer o relatório de atendimentos com dados específicos dos contatos que são relevantes para a sua operação, sem precisar cruzar planilhas manualmente.

{% stepper %}
{% step %}

### Clique em **Adicionar coluna**

Abra a área de colunas personalizadas e clique em **Adicionar coluna**.
{% endstep %}

{% step %}

### Preencha os campos

| Campo                | O que preencher                                                                                                                                                |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome da coluna**   | O título que aparecerá como cabeçalho na planilha exportada (ex: "CPF", "Plano do cliente", "Segmento").                                                       |
| **Campo do contato** | O identificador exato do campo personalizado cadastrado no contato (ex: `cpf`, `plano_saude`, `segmento`). Deve ser o mesmo nome usado no cadastro do contato. |
| {% endstep %}        |                                                                                                                                                                |

{% step %}

### Clique em **Salvar**

Salve para concluir a criação da coluna personalizada.
{% endstep %}
{% endstepper %}

### 📌 Resultado esperado

A nova coluna aparece na lista. Quando o relatório for gerado e exportado, essa coluna estará presente na planilha com os valores correspondentes de cada contato atendido.

***

## 📋 Onde as colunas aparecem na planilha

As colunas personalizadas são inseridas entre as colunas padrão do relatório, logo após o campo **Telefone sem máscara**:

> `Protocolo | Departamento | Contato | Telefone | Telefone sem máscara |` **`[suas colunas aqui]`** `| Tipo | Agente | ...`

***

## ⚙️ Como o relatório é gerado

{% stepper %}
{% step %}

### O usuário gera o relatório

O relatório é gerado no módulo **Histórico de Chats**.
{% endstep %}

{% step %}

### O sistema processa os dados

O sistema processa os dados em segundo plano.
{% endstep %}

{% step %}

### O arquivo fica disponível para download

O arquivo fica disponível para download no módulo **Relatórios**.
{% endstep %}

{% step %}

### O formato de saída é definido

* **Planilha (XLSX)** para relatórios com até 60.000 linhas.
* **CSV** para relatórios com mais de 60.000 linhas.
  {% endstep %}
  {% endstepper %}

{% hint style="warning" %}
As colunas personalizadas só aparecem no **Relatório de Atendimentos**. Outros tipos de exportação (histórico de chats, contatos, pesquisas) não são afetados por essa configuração.
{% endhint %}

{% hint style="info" %}
O campo do contato precisa existir no cadastro do contato para que o valor apareça na planilha. Se o campo não estiver preenchido no contato, a célula ficará vazia para aquele atendimento.
{% endhint %}

***

## 📌 Resumo

* Adicione colunas personalizadas para incluir dados dos contatos no relatório de atendimentos.
* Cada coluna tem um nome visível (para a planilha) e um campo do contato (de onde vem o valor).
* As colunas aparecem entre "Telefone sem máscara" e "Tipo" na planilha exportada.
* O relatório é gerado em XLSX (até 60 mil linhas) ou CSV (acima disso).
* Apenas o Relatório de Atendimentos usa essas colunas.