🇪🇸 Español 🇬🇧 English 🇧🇷 Português

Nó: Atualizar contato

Como usar o nó Atualizar contato para alterar campos padrão ou campos personalizados de um contato a partir de um workflow.

Jul 11, 2026

O nó Atualizar contato altera um ou mais dados do contato da conversa ativa: campos padrão (nome, e-mail, idioma etc.) ou campos personalizados criados no seu workspace.

Quando usar

  • Um agente de IA detecta o idioma do cliente e você quer salvá-lo no contato para conversas futuras.
  • Um formulário ou um fluxo de perguntas (Perguntar) coleta o nome, a empresa ou o e-mail do cliente.
  • Você precisa manter atualizado um campo personalizado (por exemplo, "Plano contratado" ou "Data da última compra").

Configuração

O nó trabalha com uma lista de "atribuições", cada uma com:

  • Campo: pode ser um campo padrão do contato — nome, sobrenome, nome de exibição, e-mail, telefone, empresa, notas, idioma, fuso horário — ou um campo personalizado, escolhido na lista de campos do workspace.
  • Valor: o valor a salvar. Aceita variáveis, por exemplo {{$ai.detected_language}}.

Você pode adicionar várias linhas para atualizar vários campos no mesmo nó. Esse nó exige que a automação tenha um contato ativo no contexto (vem de uma conversa).

Exemplo

Um workflow de boas-vindas pergunta o nome e o e-mail do cliente com nós Perguntar, e depois usa um nó Atualizar contato com duas linhas: first_name = {{$resposta_nome}} e email = {{$resposta_email}}.

Dicas

  • Os campos personalizados respeitam seu tipo (número, data, sim/não, texto): se você salvar um valor que não bate com o tipo, ele é ignorado em vez de quebrar o workflow.
  • Se o campo não estiver na lista padrão nem corresponder a um campo personalizado do workspace, o nó o ignora e registra isso no log — confira se o nome está escrito corretamente.

Solução de problemas

Se um campo personalizado não atualizar, confirme que o campo existe no workspace e que é do tipo "contato" (não de empresa nem de oportunidade).

Isso foi útil?

Artigos relacionados