Gestão · Atualizado em 06/10/2026
Como usar o Gerenciador de relatórios (extração de dados)
Conheça o Gerenciador de relatórios do Pipe: tipos de relatório, período de até 90 dias e as regras do histórico completo de conversa.
O Gerenciador de relatórios é a página onde você escolhe um bot, um período e um tipo de dado para extrair. Ele reúne relatórios sobre mensagens ativas, rastreamento de eventos, métricas de usuários e dados do atendimento.
Quando usar
Use quando precisar dos dados brutos para analisar fora do Pipe, ou quando uma auditoria exigir o histórico completo de um contato. Na Loja Girassol, o time jurídico pede o histórico de um cliente específico.
Pré-requisitos
- Acesso à Gestão do projeto.
- Para relatórios de atendimento, um bot com atendimento ativo.
- Para o histórico completo, o nome, o telefone, o e-mail, o BSUID ou o ID do contato, com pelo menos 5 caracteres.
Passo a passo
- Abra o fluxo na Gestão e entre em Análise.
- Abra a aba Gerenciador de Relatórios. No relatório de atendimento, o botão Gerenciador de Relatórios leva direto para esta página.
- Em Escolha um chatbot para extrair os dados, selecione o Bot.
- Em Selecione o período do relatório, informe a Data Inicial e a Data Final, ou use os atalhos 7 dias, 30 dias, 60 dias e 90 dias.
- Em Defina o tipo de relatório, escolha um dos tipos.
- Se escolheu Histórico completo de conversa, preencha Contato.
- Clique em Gerar Relatório.
- Confira a linha em Meus relatórios, com Gerado em, Relatório, Bot, Período, Início e Fim.
Tipos de relatório
| Tipo | O que traz |
|---|---|
| Mensagens ativas | Dados sobre mensagens ativas enviadas e as pessoas que as receberam. |
| Rastreamento de eventos | Todos os trackings da operação. |
| Métricas de chatbots e usuários | Usuários mensais (MAUs) e detalhes das conversas. |
| Histórico completo de conversa | PDF com o histórico completo, para auditorias e documentação jurídica. |
| Status dos atendentes | A atuação dos atendentes no Desk. |
| Métricas de atendimento | Atendente, abertura, encerramento, tempos de resposta e outros dados. |
| Histórico de atendimento (Desk) | Mensagens e dados das conversas do Desk, com transcrição. |
Os três últimos são os Relatórios de atendimento e exigem um bot com atendimento ativo.
Histórico completo de conversa
O link Saiba como gerar corretamente, ao lado de Contato, resume as regras:
- Buscas genéricas retornam no máximo 5 contatos.
- O relatório é gerado para um contato por vez.
- Links de fotos, vídeos e áudios ficam disponíveis por 72 horas.
- E-mail, BSUID e ID usam busca exata; nome e telefone aceitam busca aproximada.
- Confirme o bot e o período em que a conversa ocorreu.
Regras do formulário
| Regra | Mensagem quando não cumprida |
|---|---|
| Bot é obrigatório | Campo obrigatório |
| Tipo de relatório é obrigatório | Campo obrigatório |
| Período de no máximo 90 dias | O período deve ser de no máximo 90 dias |
| Contato com ao menos 5 caracteres (histórico completo) | O filtro de contato deve ter pelo menos 5 caracteres |
Termo de responsabilidade
O botão Termo de responsabilidade abre o texto que informa que a solicitação de relatórios é uma interação com a plataforma e que o cliente, controlador dos dados pessoais, assume a responsabilidade por eventual incidente de vazamento que causar.
Resultado esperado
O relatório pedido aparece na lista Meus relatórios com a indicação Pendente.... A lista mostra os arquivos gerados nos últimos 7 dias; sem nenhum, aparece "Nenhum arquivo gerado nos últimos 7 dias."
Limitações
- O período é de até 90 dias, dentro dos últimos 5 anos.
- Relatórios de atendimento não existem para roteador nem para bot sem atendimento ativo.
- Nesta versão da página, o relatório fica na situação Pendente... e a lista não oferece download.
Problemas comuns
- O formulário não gera o relatório: leia as mensagens em vermelho; falta bot, tipo, período válido ou contato.
- Quero relatórios de atendimento e a página avisa que não é possível: o bot não tem atendimento ativo.
- Não entendo as colunas de um relatório: consulte o Dicionário de Dados.
Próximos passos
Perguntas frequentes
Qual o período máximo de um relatório?
Até 90 dias, em qualquer intervalo dos últimos 5 anos.
Posso gerar relatórios de atendimento para um roteador?
Não. A página avisa que não é possível gerar relatórios de atendimento para um roteador ou chatbot sem atendimento ativo.
O que é o histórico completo de conversa?
Um relatório em PDF, voltado a auditoria e documentação, gerado para um contato por vez.
Onde entendo o que cada relatório contém?
No Dicionário de Dados, com o link na própria página.
Esse artigo foi útil?
Obrigado pelo retorno!