For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/max/build-insights-dashboard-with-ai.md.
  • Português

      • Como pedir para a IA montar um dashboard de Insights?

      Descreva os números que você quer acompanhar e a IA monta o dashboard dentro de Comercial → Insights, com os widgets organizados em seções. O dashboard nasce salvo e você continua editando na tela: trocar o gráfico de um widget, redimensionar o card, mudar o período.

      Antes de começar:

      • Papel: Proprietário, Administrador, Editor, Visualizador, Convidado ou Atendente. Papéis de acesso somente financeiro não veem Insights.
      • Tenha em mente o que você quer ler no painel: quais indicadores, de qual pipeline e de qual período.
      • Para usar sua própria IA em vez do Max, veja Conectar sua IA à Clickmax (MCP).

      1. Diga o que o painel precisa responder

      Peça pelos números, não pelos gráficos: "quero acompanhar receita ganha, oportunidades criadas e o funil por etapa do pipeline Vendas". A IA escolhe os widgets em um catálogo fechado de indicadores — ela não inventa métrica. Se algum indicador que você pediu não existe no catálogo, ela diz e oferece o mais próximo.

      Vale pedir também:

      • Modelo pronto — "um painel pra acompanhar o comercial" entrega um dos modelos prontos ("Pace Comercial", por exemplo) em vez de uma montagem sob medida.
      • Pipeline — indicadores quebrados por etapa (funil por etapa, oportunidades por etapa, valor em aberto, tempo por etapa, motivos de perda, MQL → SQL) pertencem a um pipeline só. Diga qual: sem isso a IA pergunta em vez de escolher por você, porque um pipeline adivinhado faz o card mostrar o número de um pipeline e você ler como o número da operação inteira. Pedindo um modelo pronto, o pipeline informado (ou o mais recente, quando você não informa) fica gravado em cada card — o painel não troca de pipeline sozinho quando você criar um pipeline novo depois.
      • Período — "mês atual", "últimos 7 dias" ou datas específicas. O atalho fica salvo como atalho: quando a IA lê os números do painel depois, ela lê a janela do atalho recalculada na hora — a mesma que a tela mostra —, não o histórico inteiro.
      • Metas — pedir a comparação com a meta liga o Metas do dashboard, e cada card passa a mostrar o ritmo em relação à meta cadastrada.

      2. O painel chega montado em seções

      A IA monta o dashboard de uma vez: cria os widgets, agrupa em seções com título ("Resultado do mês", "Time e motivos") e define a largura e a altura de cada card para as fileiras fecharem — do mesmo jeito que um modelo pronto. É por isso que vale pedir o painel inteiro numa frase em vez de um widget por vez.

      Limites do dashboard: 40 widgets por dashboard (cada título de seção ocupa uma dessas 40 posições) e 25 dashboards por conta. Ao bater o teto, a IA avisa e você escolhe o que remover.

      O filtro do topo também tem limite: até 100 itens por lista (pipelines, etapas, responsáveis, origens) e até 200 condições no filtro avançado. São tetos de segurança, bem acima de qualquer seleção normal — se você esbarrar em um deles, filtre pelos itens que interessam em vez de marcar tudo.

      3. Confira os números antes de confiar no painel

      Abra o dashboard e revise:

      • O indicador é o que você pediu — o título do card diz o que ele mede; confira na engrenagem do widget se a leitura não bater.
      • Cards com "Não foi possível calcular" — o cálculo daquele widget falhou. Peça outro indicador para a IA, ou ajuste na engrenagem. Um pedido de indicador que não existe não vira card: a IA é avisada na hora e propõe a alternativa antes de salvar.
      • Cards zerados — zero também é resposta: pode ser um recorte sem resultado no período. Compare com o filtro do topo antes de concluir que o dado sumiu.
      • Avisos de filtro ignorado — alguns indicadores não usam todos os filtros do topo (atividades atrasadas são uma foto de agora, não de um período). O card diz quais filtros ele ignora.
      • Recorte que não aparece na barra — a IA não consegue salvar um recorte que a tela não mostra (situação, temperatura, prioridade, valor, origem, tipo de tarefa): esses cortes vão para o filtro avançado, que fica visível e você pode limpar. Em painéis criados antes disso, um recorte assim aparece como um selo âmbar na barra de filtros (por exemplo Situação: won) com um ✕ para remover — se os números pareciam baixos sem explicação, era ele.
      • Widgets que pedem um parâmetro — quebras por campo customizado ou por tag precisam do campo ou de até 8 tags. Pedindo pela IA, diga qual campo ou quais tags: sem isso ela não consegue criar o card e vai perguntar. Montando pela tela, você escolhe na engrenagem do widget.

      4. Ajuste o painel depois

      Você pode continuar por conversa ou pela tela:

      • Trocar o gráfico de um widget (Barras, Linha, Pizza, Ranking, Lista, Número, Tabela).
      • Redimensionar o card — largura e altura, nas alças do card.
      • Adicionar título para abrir uma seção nova.
      • Reordenar — a ordem dos cards é a ordem que aparece na tela.
      • Mudar período, Metas, filtro compartilhado e Ao vivo sem mexer nos widgets.

      O filtro é do dashboard, não do widget: um período ou um pipeline escolhido no topo vale para todos os cards ao mesmo tempo. Recortes como aberta/ganha/perdida são escolha do próprio indicador, não do filtro.

      Relacionados

      Se não funcionou

      • Não encontra o dashboard criado: ele fica em Comercial → Insights, na lista de dashboards à esquerda.
      • A IA disse que o indicador não existe: o catálogo é fechado, então peça o número por outro ângulo ("receita por responsável" em vez de "receita por cidade") ou monte a leitura pelos filtros do topo.
      • A IA disse que precisa do campo ou das tags: quebras por campo customizado e por tag só existem com esse parâmetro — responda qual campo ou quais tags e ela conclui.
      • Um card mostra "Não foi possível calcular": aquela combinação de métrica não roda — peça a alternativa para a IA em vez de tratar o zero como resultado.
      • Os números não batem com o esperado: confira o período no topo, se há algum selo âmbar de recorte na barra de filtros e se o card não está avisando que ignora algum filtro.
      • Um card de etapa fala de outro pipeline: abra a engrenagem do widget e escolha o pipeline. Cada card de etapa tem o seu — dois cards do mesmo painel podem olhar pipelines diferentes.
      • Bateu o limite de widgets ou de dashboards: remova o que não usa mais e peça de novo.
      • Uma ação foi bloqueada por um erro: veja os Códigos de erro.