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/automations/update-contact-field.md.
  • Português
  • Como preencher um campo do contato por automação?

    Adicione um passo de Ação → Atualizar campo do contato, escolha o campo de destino e escreva o valor. Quando o contato chega nesse passo, a automação grava o valor no campo — inclusive em campos personalizados.

    Papel: qualquer membro com acesso ao workspace.

    Antes de começar

    • Uma automação criada, com um gatilho que traga um contato (captura, tag aplicada, compra, etapa do pipeline etc.).
    • Se for gravar em campo personalizado, o campo precisa existir e estar ativo em CRM → Campos personalizados.

    Passo a passo

    1. No canvas da automação, adicione um passo e escolha Atualizar campo do contato.
    2. Em Campo de destino, escolha o campo. A lista abre com uma busca — digite parte do nome para filtrar — e vem separada em dois grupos: Campos do contato (nome, e-mail, telefone, cidade, data de nascimento e afins) e Campos personalizados.
    3. Em Valor, escreva o que deve ser gravado. Você pode digitar um texto fixo ou clicar no seletor de variáveis para inserir dados do fluxo, como {{utm_source}} ou {{name}}.
    4. Em Quando gravar, escolha entre Sempre e Só se o campo estiver vazio.
    5. Se o campo escolhido for de multi-seleção, escolha também entre Substituir as opções marcadas e Acrescentar às opções marcadas.
    6. Salve a automação normalmente.

    Sempre ou só se estiver vazio?

    OpçãoO que acontece
    SempreO valor atual é substituído toda vez que o contato passa pelo passo.
    Só se o campo estiver vazioO valor só é gravado quando o campo não tem nada. Contatos que já têm o campo preenchido ficam intactos.

    Uma automação pode rodar para milhares de contatos e não existe desfazer. Se a intenção é enriquecer a base sem apagar o que o time já preencheu à mão, use Só se o campo estiver vazio.

    O que a automação faz com valores que não cabem no campo

    O valor é validado contra o tipo do campo antes de gravar. Quando ele não cabe, a automação não grava nada e segue para o próximo passo — o contato não fica com dado inválido.

    Tipo do campoO que é aceito
    Texto, área de texto, linkQualquer texto.
    Número, moeda, porcentagem, avaliaçãoUm número. Aceita vírgula decimal (1.234,56).
    DataUma data válida.
    Sim/Nãosim, não, true, false, 1 ou 0.
    Seleção e opção únicaUma das opções configuradas no campo (pelo rótulo ou pelo valor).
    Multi-seleçãoUma ou mais opções separadas por vírgula. Opções que não existem são ignoradas.

    Outras situações em que o passo não grava e a automação continua normalmente:

    • O valor ficou vazio depois de resolver as variáveis — por exemplo, {{utm_source}} em um contato que não tem essa origem. Vazio não apaga o campo.
    • O campo personalizado foi excluído depois de configurado. O painel da ação avisa com Campo removido; escolha outro campo para a automação voltar a gravar.
    • O valor gravado é igual ao que já estava lá.

    Onde a mudança aparece

    Toda gravação vira uma linha no histórico do contato, com o nome do campo e o valor de antes e depois. Assim um campo que muda sozinho na ficha tem rastro de qual automação o alterou.

    Dica

    Combine com o gatilho de captura para carimbar a origem do contato: destino Origem (campo personalizado), valor {{utm_source}} e Só se o campo estiver vazio — a primeira campanha que trouxe o contato fica registrada e não é sobrescrita pelas seguintes.