Visão geral
O Cérebro da Conta traz duas formas de enxergar a operação a partir dos dados que a plataforma já tem:
- Matriz de análise consultiva — uma aba com KPIs reais dos módulos nativos (conversas abertas, tempo de primeira resposta, tempo de resolução, CSAT, MRR, valor de pipeline do CRM, follow-ups ativos, pedidos do Catálogo e métricas de Vendas como metas, atingimento, moedas e comissões) mais séries (volume de conversas dos últimos dias e distribuição por status), cada gráfico com uma leitura consultiva de uma linha.
- Dashboards generativos — você descreve em linguagem natural o painel que quer e o Maestro monta uma especificação declarativa (cards de KPI, gráficos, tabelas e um texto-resumo) já com os valores reais sobrepostos.
A matriz é só leitura e está sempre disponível; os dashboards generativos você cria, revisa, salva e organiza do seu jeito.
Pré-requisitos
- Conta com o Cérebro da Conta habilitado.
- Permissão de administrador para gerar, salvar, reordenar e descartar dashboards. Qualquer membro da conta pode ver a matriz e os dashboards salvos (leitura).
- Módulos nativos ativos e com dados para os KPIs aparecerem com valores reais (por exemplo, Pagamentos para MRR, CRM para o pipeline, Catálogo para pedidos, Vendas para metas e comissões).
Passo a passo
Ver as análises (matriz)
- Abra o Cérebro da Conta e vá até a aba Análises.
- Acompanhe os cards de KPI e os gráficos (volume e status).
- Onde houver um relatório nativo correspondente, clique no KPI para abrir o relatório com o detalhe.
- Se aparecer o selo em cache, o motor de análise estava fora no momento e a aba mostrou um cálculo nativo de fallback — os dados continuam válidos e a aba nunca quebra.
Criar um dashboard generativo
- Vá até a aba Dashboards.
- No campo de geração, descreva em linguagem natural o painel que quer (você também pode ditar por voz). Exemplo: "mostre CSAT, MRR e o volume de conversas das últimas duas semanas".
- Clique em Gerar. O Maestro devolve uma especificação declarativa com cards e gráficos, já com os valores reais dos KPIs nativos sobrepostos.
Revisar, salvar e organizar
- Revise a proposta na tela (ela ainda não fica salva).
- Clique em Salvar para mantê-la — ela vira um dashboard nativo da conta, persistido por conta.
- Reordene os widgets (mover para cima/baixo) para ajustar o layout.
- Salvar de novo atualiza o dashboard existente; gerar sem um
idcria um novo. - Para remover, use o descartar (com confirmação) — é uma exclusão suave (soft-delete).
Configurações & opções
- KPIs nativos: conversas abertas, tempo de primeira resposta, tempo de resolução, resoluções, CSAT, MRR, valor de pipeline, follow-ups ativos, pedidos do Catálogo e métricas de Vendas. Cada um retorna 0 quando o módulo está inativo ou ainda não tem dados.
- Drill-down: KPIs com relatório nativo viram link para o relatório (os demais ficam como card).
- Filtros declarativos: chips (por exemplo, período/intervalo) que ajustam e regeneram o painel — disponíveis para administradores.
- Layout por conta: a ordem dos widgets é personalizada por conta e espelhada no dashboard salvo ao salvar.
- Proveniência (fontes): quando o resumo é embasado na sua base de conhecimento, aparecem chips de fonte; clicar abre o Corpus.
- Comportamento cache-first: a aba sempre devolve um formato estável; com o motor fora, usa o cálculo nativo (selo em cache). Conta nova rende KPIs zerados e séries vazias — nunca um erro.
Casos de uso
- Ter uma visão recorrente da operação (CSAT, MRR, pipeline) em um dashboard salvo.
- Montar rapidamente um painel para uma pergunta específica ("quero ver pedidos do Catálogo por semana").
- Combinar período com métricas para comparar janelas de tempo.
- Abrir o relatório nativo direto de um KPI para investigar um número.
Dicas, limites e boas práticas
- Peça métricas específicas e combine com filtros (ex.: período) para painéis mais úteis.
- Use dashboards salvos como a visão padrão da equipe — eles persistem por conta.
- A especificação gerada só é mantida depois de salvar; se você regenerar ou sair, uma proposta não salva é perdida.
- KPIs em 0 geralmente significam módulo inativo ou ainda sem dados, não erro.
Solução de problemas
- KPI em 0: o módulo correspondente está inativo ou ainda não há dados (por exemplo, sem assinaturas → MRR 0; sem negócios no CRM → pipeline 0).
- Ação bloqueada: gerar, salvar, reordenar e descartar são só para administradores — membros têm acesso de leitura.
- Perdi o dashboard gerado: a proposta não fica salva até você clicar em Salvar.
- Selo "em cache": o motor de análise estava fora no momento; a aba usou o cálculo nativo de fallback e segue funcional.