Relatórios

Tela onde você gera relatórios prontos ou customizados pra exportar e analisar offline ou compartilhar com gerência.

Onde fica

/inteligencia/relatorios. Permissão: relatorios:view.

Templates prontos

Cada template é um relatório pré-configurado que você só clica e gera:

Template	O que inclui
Fechamento mensal	KPIs do mês, comparativo com anterior, tópicos quentes, distribuições
Operacional semanal	Volume, resolução, picos, alertas
Qualidade	Scorecards, top 5 melhores e piores
Sentimento	Distribuição, top causas de raiva, risco-churn
Financeiro	Custo por canal, MRR, excedentes
Compliance LGPD	Erasure executado, consentimentos, exports

Criar relatório customizado

Vá em /inteligencia/relatorios → Botão + Novo relatório.
Defina o escopo:
- Período (datas)
- Filtros (canal, agente, tópico, sentimento)
- Métricas a incluir (multi-select)
- Formato (tabela / gráficos / ambos)
Visualize o preview antes de gerar.
Gerar relatório. Pode ser:
- Imediato (download direto)
- Salvar template (para usar de novo)
- Agendar recorrente (gera todo dia/semana/mês e manda por e-mail)

Formatos de export

Formato	Uso típico
PDF	Compartilhar com gerência
CSV	Análise no Excel / BI
JSON	Integração com sistema próprio
Imagem (gráfico)	Apresentações

Server actions disponíveis

createReportTemplate — cria novo template
toggleReportTemplateStatus — ativa/desativa template salvo

(Documentação interna pra integradores.)

Agendamento recorrente

Configure relatório pra rodar automaticamente:

Diário (todo dia às 9h, por exemplo)
Semanal (toda segunda)
Mensal (todo dia 1)

Recipientes: lista de e-mails. Cada e-mail recebe link pra baixar (token único, expira em 7 dias).

Filtros avançados

Em qualquer relatório:

Período — qualquer intervalo
Canal — multiselect
Agente — específico
Tópico — específico
Sentimento — específico
Tags — incluir / excluir
Score range — entre X e Y
Comparativo — vs período anterior, vs ano anterior

Templates customizados (engenharia interna)

Para casos específicos não cobertos pelos templates default, sua equipe pode pedir templates customizados ao seu Account Manager. Templates ficam salvos no seu painel e qualquer usuário com permissão pode rodar.

Roadmap

Editor visual de templates (sem precisar pedir AM)
Compartilhar template entre orgs (template público)
Dashboard customizado (BI lite no painel)
Integração nativa com Looker / Metabase

Boas práticas

Configure relatório mensal recorrente — gerência recebe automaticamente
Use comparativos — números absolutos não dizem nada sem contexto
Inclua narrativa quando exportar PDF — preencha o campo “Observações” antes de gerar

Próximo passo

→ SLA
→ Mapa

Previsões SLA