> ## Documentation Index
> Fetch the complete documentation index at: https://docs.robbu.global/llms.txt
> Use this file to discover all available pages before exploring further.

# Relatórios

> Gere, visualize, baixe e agende relatórios no Invenio Center: 30+ modelos prontos em 7 categorias, filtros personalizáveis, exportação CSV e envio automático por e-mail ou FTP/SFTP.

A seção de **Relatórios** do Invenio Center centraliza e consolida dados da operação para monitoramento de atendimentos, KPIs, campanhas e desempenho da equipe — com modelos prontos, filtros personalizáveis e visualização detalhada.

**Caminho:** Invenio Center > Analisar > **Relatórios**

<Tip>
  **Acesso direto:** [Relatórios no Invenio Center](https://inveniocenter.robbu.global/painel/relatorios)
</Tip>

<Frame caption="Tela principal do módulo de Relatórios">
  <img src="https://storage.robbu.global/v2/file/C1B058E419FE84E3649C103F3F41918E" />
</Frame>

A tela principal exibe duas seções:

| Seção            | O que mostra                                    |
| ---------------- | ----------------------------------------------- |
| **Relatórios**   | Lista de relatórios gerados ou em processamento |
| **Agendamentos** | Relatórios programados para execução automática |

<Frame caption="Lista de relatórios com status, usuário solicitante e período">
  <img src="https://storage.robbu.global/v2/file/54CCA55563A510FA3BBC2304ADB66B52" />
</Frame>

Cada relatório listado exibe: **Nome** · **Status** · **Usuário solicitante** · **Data/hora** · **Período** · **Total de registros**

**Status possíveis:** `Aguardando` · `Em processamento` · `Finalizado` · `Falha`

Alterne entre **Todos os relatórios** e **Meus relatórios** para filtrar por usuário logado.

***

## Gerar um Relatório

<Steps>
  <Step title="Iniciar criação">
    Clique em **"+ Gerar relatório"** na tela do módulo.

    **Caminho:** Invenio Center > Analisar > Relatórios > **+ Gerar relatório**

    <Frame caption="Tela de seleção de modelo e filtros para geração de relatório">
      <img src="https://storage.robbu.global/v2/file/0922AD1BFE162486F35B99CAE7A3BD6F" />
    </Frame>
  </Step>

  <Step title="Selecionar o modelo">
    Escolha o **modelo de relatório** desejado entre os disponíveis no ambiente (30+ modelos em 7 categorias).
  </Step>

  <Step title="Aplicar filtros">
    Configure os filtros conforme a análise desejada:

    * **Período** (data início/fim)
    * **Segmento / Carteira**
    * **Canal** (WhatsApp, E-mail, SMS etc.)
    * **Usuário / Operador**
    * **Evento / Status**
  </Step>

  <Step title="Confirmar e aguardar">
    Clique em **"Gerar relatório"** para confirmar. O relatório entra na fila de processamento.

    <Note>
      Quando mais de um relatório da mesma carteira é solicitado, o sistema processa na **fila sequencial** — o segundo aguarda o primeiro ser concluído.
    </Note>
  </Step>
</Steps>

***

## Visualizar e Baixar

Após gerado, clique nos **três pontos** à direita do relatório para ver as opções de acesso.

<Frame caption="Opções de visualização e download do relatório gerado">
  <img src="https://storage.robbu.global/v2/file/A59426B5CD2C85ED7A9C03D22940DB88" />
</Frame>

<Tabs>
  <Tab title="📊 Visualizar no Center" icon="eye">
    Exibe o relatório diretamente na tela do Invenio Center:

    * Limite de **até 100 linhas** por relatório
    * Campo de **pesquisa** para localizar informações rapidamente
    * Ideal para consultas rápidas e verificação de dados

    <Frame caption="Visualização do relatório na tela do Invenio Center">
      <img src="https://storage.robbu.global/v2/file/3D21FD22B041191F7D85DE198F884221" />
    </Frame>
  </Tab>

  <Tab title="📥 Download em CSV" icon="download">
    Exporta o relatório completo em formato CSV:

    * **Sem limitação** de linhas — todos os registros incluídos
    * Compatível com **Excel**, **Power BI** e demais ferramentas analíticas
    * Ideal para análises avançadas e cruzamento de dados externos

    <Tip>
      Para volumes grandes de dados, prefira sempre o **download CSV** para garantir acesso a todos os registros sem truncamento.
    </Tip>
  </Tab>
</Tabs>

***

## Agendar Relatórios

Programe a geração e envio automático de relatórios por **e-mail** ou **FTP/SFTP**.

<Frame caption="Tela de agendamentos de relatórios">
  <img src="https://storage.robbu.global/v2/file/AEF82F18D1C977CD2A14853C5585EF36" />
</Frame>

**Envio por e-mail:** Selecione a opção ao criar/editar o agendamento, informe os endereços de destino e confirme.

<Frame caption="Configuração de envio do relatório agendado por e-mail">
  <img src="https://storage.robbu.global/v2/file/C46C7F77528C772DE4F630D7543C798A" />
</Frame>

**Editar ou excluir um agendamento:** Clique nos **três pontos** à direita do agendamento.

<Frame caption="Opções de edição e exclusão de agendamentos">
  <img src="https://storage.robbu.global/v2/file/AEF82F18D1C977CD953C3CAA8BB3A2C9" />
</Frame>

Para envio via FTP/SFTP, consulte: [Agendamento de Relatório via FTP](https://docs.robbu.global/docs/center/agendamento-relatorio-ftp)

***

## Tipos de Relatórios Disponíveis

### 👥 Contatos

| Relatório                               | Descrição                                                               |
| --------------------------------------- | ----------------------------------------------------------------------- |
| **Contatos Atendidos**                  | Todos os contatos atendidos por usuário ou automação no período         |
| **Contatos Atendidos por Usuário**      | Volume de contatos atendidos por cada operador                          |
| **Contatos por Usuário (por Carteira)** | Agrupado por carteira e operador                                        |
| **Contatos Fidelizados por Usuário**    | Contatos fidelizados de cada operador no momento da extração            |
| **Contatos Recebidos no WebChat**       | Dados do canal WebChat no período                                       |
| **Contatos com Agendamentos Pendentes** | Contatos com agendamentos em aberto no período                          |
| **Contatos Novos por Data de Inclusão** | Novos contatos inseridos no período                                     |
| **Contatos Totais**                     | Todos os contatos (entrantes, saintes, com/sem atendimento, humano/bot) |

### 📊 KPIs e Desempenho

| Relatório                             | Descrição                                      |
| ------------------------------------- | ---------------------------------------------- |
| **KPI Eventos**                       | KPIs de eventos registrados no período         |
| **Fluxo IDR – KPIs**                  | KPIs da IDR e atendimentos por chatbot         |
| **Nível de Serviço (SL)**             | Desempenho e qualidade do atendimento          |
| **Taxa de Abandono**                  | % de chamadas abandonadas antes do atendimento |
| **Tempo Médio p/ Chamada Abandonada** | Tempo médio de espera até abandono             |
| **Tempo Médio de Espera em Fila**     | Tempo médio de espera até ser atendido         |
| **Tempo Médio Falado**                | Duração média de interações por chamadas       |
| **Analítico de Chamadas Abandonadas** | Análise de pontos de falha em abandono         |

### 🔐 Acesso e Sessões

| Relatório                          | Descrição                                          |
| ---------------------------------- | -------------------------------------------------- |
| **Controle de Sessão por Usuário** | Logins, logouts e acessos por usuário no período   |
| **Sessões WhatsApp**               | Sessões abertas pelo contato ou empresa no período |
| **Status de Linhas WhatsApp**      | Atualizações de status das linhas no ambiente      |
| **Status de Templates WhatsApp**   | Atualizações de status dos templates HSM           |

### 📤 Extração de Dados

| Relatório                            | Restrições                               |
| ------------------------------------ | ---------------------------------------- |
| **Extração de Telefones do Contato** | Limite de 10.000 registros               |
| **Extração de E-mails do Contato**   | Limite de 10.000 registros, máx. 30 dias |
| **Extração de Cartões do Pipeline**  | Todos os cartões do Pipeline selecionado |

### 🤖 Automação e Campanhas

| Relatório                               | Descrição                                     |
| --------------------------------------- | --------------------------------------------- |
| **Envios Ativos de HSM (WhatsApp API)** | Disparos de templates HSM via API no período  |
| **Campanhas Realizadas**                | Dados consolidados das campanhas no período   |
| **Envios de HSM por Usuário**           | Templates enviados manualmente por operadores |
| **Cancelamento de Inscrição**           | Pessoas que optaram por não receber campanhas |

### ⚖️ Auditoria e Compliance

| Relatório                   | Descrição                                                              |
| --------------------------- | ---------------------------------------------------------------------- |
| **Auditoria (GDPR e LGPD)** | Ações dos usuários na plataforma no período — rastreabilidade completa |

### 🗂️ Atendimento e Documentação

| Relatório                                  | Descrição                                          |
| ------------------------------------------ | -------------------------------------------------- |
| **Carteiro Digital – Envio de Documentos** | Documentos enviados por usuários ou API no período |
| **WebChat – NPS**                          | Classificações, NPS e comentários pós-atendimento  |
| **Protocolos de Atendimentos**             | Todos os protocolos gerados no período             |

***

## Relatórios Customizados

Solicite **relatórios personalizados** junto ao time comercial mediante avaliação técnica.

<Warning>
  Relatórios customizados estão sujeitos a **custos adicionais** e **prazos específicos**, a serem definidos pelo time comercial Robbu.
</Warning>

***

## Links Relacionados

<CardGroup cols={2}>
  <Card title="Agendamento via FTP/SFTP" icon="server" href="https://docs.robbu.global/docs/center/agendamento-relatorio-ftp">
    Envio automático de relatórios por FTP
  </Card>

  <Card title="Tipos de KPI" icon="chart-bar" href="https://docs.robbu.global/docs/center/tipos-de-kpi">
    Referência de KPIs disponíveis
  </Card>

  <Card title="Protocolos de Atendimento" icon="file-lines" href="https://docs.robbu.global/docs/center/como-habilitar-protocolos-de-atendimento">
    Habilitar e usar protocolos
  </Card>

  <Card title="Pausas no Atendimento" icon="circle-pause" href="https://docs.robbu.global/docs/center/pausas-no-atendimento">
    Relatório de pausas por usuário
  </Card>
</CardGroup>

***

## ⁉️ Perguntas Frequentes (FAQ)

<AccordionGroup>
  <Accordion title="📍 Como acessar os relatórios?">
    **Caminho:** Invenio Center > Analisar > Relatórios

    **Acesso direto:** [Relatórios](https://inveniocenter.robbu.global/painel/relatorios)

    O acesso depende das **Permissões de Página** configuradas no perfil do usuário.
  </Accordion>

  <Accordion title="⚙️ Como gerar um relatório?">
    **Caminho:** Invenio Center > Analisar > Relatórios > + Gerar relatório > Selecionar modelo > Aplicar filtros > Gerar relatório

    O relatório entra na fila de processamento e fica disponível com status **Finalizado** quando pronto.
  </Accordion>

  <Accordion title="📊 Qual a diferença entre visualizar no Center e baixar o CSV?">
    | Modo                     | Limite             | Uso ideal                            |
    | ------------------------ | ------------------ | ------------------------------------ |
    | **Visualizar no Center** | 100 linhas + busca | Consultas rápidas                    |
    | **Download CSV**         | Sem limite         | Análises completas em Excel/Power BI |

    Para volumes grandes, sempre prefira o **CSV** para evitar truncamento de dados.
  </Accordion>

  <Accordion title="📅 Posso agendar relatórios para envio automático?">
    **Sim!** Agendamentos são suportados por **e-mail** e **FTP/SFTP**.

    **Caminho:** Invenio Center > Analisar > Relatórios > Agendamentos > + Agendar

    Consulte: [Agendamento via FTP/SFTP](https://docs.robbu.global/docs/center/agendamento-relatorio-ftp)
  </Accordion>

  <Accordion title="❌ O que fazer quando um relatório mostra status 'Falha'?">
    1. Verifique se os **filtros aplicados** são válidos (período, segmento, canal)
    2. Confirme se o período não excede os **limites do relatório** (ex: extração de e-mails = máx. 30 dias)
    3. Tente gerar o relatório novamente

    Se o problema persistir, entre em contato com o suporte Robbu.
  </Accordion>

  <Accordion title="⏳ Por que meu relatório está demorando para processar?">
    A plataforma usa uma **fila sequencial por carteira** — quando mais de um relatório da mesma carteira é solicitado simultaneamente, o segundo aguarda o primeiro ser concluído.

    Para relatórios grandes (muitos registros), o processamento pode levar alguns minutos.
  </Accordion>

  <Accordion title="📋 Quais filtros posso aplicar?">
    Dependendo do modelo, os filtros disponíveis incluem:

    * **Período** (data início/fim — obrigatório na maioria)
    * **Segmento / Carteira**
    * **Canal** (WhatsApp, E-mail, SMS, WebChat etc.)
    * **Usuário / Operador**
    * **Evento** (para KPI Eventos)
    * **Status**
  </Accordion>

  <Accordion title="🔒 Os relatórios de Auditoria (LGPD/GDPR) cobrem todas as ações?">
    **Sim.** O relatório **Auditoria (GDPR e LGPD)** registra as ações realizadas por usuários dentro das plataformas Invenio, garantindo rastreabilidade completa para fins de compliance.

    **Caminho:** Invenio Center > Analisar > Relatórios > + Gerar relatório > Auditoria (GDPR e LGPD)
  </Accordion>
</AccordionGroup>