For AI agents: the complete documentation index is available at https://docs.clickmax.dev/llms.txt, the full documentation bundle is available at https://docs.clickmax.dev/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.dev/features/contacts/insights-custom-field-widget.md.
  • Português
  • Como quebrar um widget do Insights por campo customizado

    No Insights de Oportunidades, um widget de leads pode separar a contagem por um campo customizado — um gráfico por plano contratado, por origem, por qualquer campo que você criou. O seletor do campo tem busca por nome e vai carregando os campos conforme você rola, então workspaces com dezenas de campos continuam navegáveis.

    Antes de começar

    • Papel do workspace: qualquer papel com acesso ao Insights de Oportunidades. Veja a tabela de permissões.
    • Ter pelo menos um campo customizado de contato criado.

    Passos

    1. No dashboard, passe o mouse sobre o widget e clique no ícone de engrenagem.
    2. Em Segmentar por, escolha Campo customizado.
    3. Clique no seletor Campo.
    4. Digite parte do nome do campo. A lista filtra enquanto você escreve — a busca acontece no servidor, então ela alcança campos que ainda não foram carregados na tela.
    5. Clique no campo desejado. O widget recarrega já quebrado por ele.
    6. Salve o dashboard.

    Bom saber

    • O campo escolhido aparece ao lado do número total do widget, numa etiqueta com o nome e o tipo do dado, seguida da descrição do campo. É o que diferencia dois widgets de campo customizado no mesmo dashboard, já que ambos nascem com o mesmo título — e o tipo explica a forma dos rótulos do gráfico (num campo numérico, "5" e "6" são valores do campo, não erro).
    • A descrição vem do texto cadastrado em Configurações → Campos customizados. Campo sem descrição simplesmente não mostra essa parte.
    • A busca encontra tanto o rótulo do campo (o nome que aparece nas telas) quanto o nome técnico — útil quando o campo veio de uma importação de CSV e você lembra do nome da coluna original.
    • Quando dois campos têm o mesmo rótulo, o grupo aparece abaixo do nome para desempatar.
    • Só campos de contato ativos entram na lista. Campo desativado nas configurações some do seletor.
    • Enquanto nenhum campo estiver escolhido, o widget mostra 0 — ele não tem por onde quebrar a contagem.
    • O gráfico mostra os valores mais frequentes do campo no período do dashboard.

    Se não funcionou

    • Lista vazia com a busca em branco → o workspace ainda não tem campo customizado de contato ativo. Crie um em Configurações → Campos customizados.
    • O campo que você procura não aparece → confirme que ele é um campo de contato (campos de oportunidade não entram neste widget) e que está ativo.