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/faq/contacts/custom-field-description.md.
  • Português
  • Para que serve a descrição de um campo personalizado?

    A descrição explica o que o campo significa para quem vai usá-lo. Ela aparece ao passar o mouse sobre o nome do campo e é considerada pela busca de campos — então um campo com nome enigmático continua encontrável por quem lembra do que ele faz.

    Você preenche a descrição em Descrição (texto de ajuda), ao criar ou editar o campo.

    Onde a descrição aparece

    Campos com descrição cadastrada mostram um ícone de informação (i) ao lado do nome — passe o mouse sobre ele para ler a descrição. O ícone aparece em:

    • No seletor de campo dos filtros de contatos e de oportunidades.
    • No construtor de segmentos.
    • Nos campos adicionais do contato e da oportunidade.
    • No cabeçalho das colunas do Modo Especialista e no painel Colunas.
    • Nos campos adicionais ao criar um contato ou uma oportunidade.
    • Nos campos obrigatórios das regras de etapa do pipeline.
    • Nos campos do formulário de agendamento.
    • Nas colunas de exportação e no mapeamento de importação de contatos (CSV).
    • No seletor de dimensão do analytics do Modo Especialista.

    Em alguns lugares a descrição aparece ao passar o mouse sobre o nome do campo, sem o ícone: nas condições e no destino de coleta das automações, no seletor de variáveis ({{...}}) e nos campos personalizados do construtor de formulários.

    Na tela Campos customizados, a descrição também aparece direto na listagem: na tabela, ao lado da chave da API; nos cards da visualização em grade, logo abaixo da chave. Quando o texto não cabe, ele aparece cortado — passe o mouse para ver a descrição completa.

    Quando o campo não tem descrição cadastrada, passar o mouse mostra o nome completo — útil porque nomes longos aparecem cortados nessas listas.

    Como a busca usa a descrição

    Ao digitar em Buscar campo…, o Clickmax procura o texto tanto no nome quanto na descrição, ignorando acentos e maiúsculas. Se o campo entrou no resultado por causa da descrição, o trecho que casou aparece destacado embaixo do nome — assim fica claro por que aquele campo apareceu.

    Na tela Campos customizados, a busca Buscar por nome, chave ou descrição… também considera a descrição — útil quando você lembra do texto de ajuda, mas não do nome do campo.

    Relacionados

    Se não funcionou

    • Não vê a descrição ao passar o mouse: confirme que o campo tem Descrição (texto de ajuda) preenchida — sem ela, aparece só o nome completo.
    • A busca não encontra pelo texto que você lembra: o texto precisa estar no nome ou na descrição do campo; revise a descrição em como criar campos personalizados.
    • Não encontra a tela de campos personalizados: verifique suas permissões em Sem permissão.