Nós de contato: atualizar contato e definir variável

Veja como usar os nós Atualizar contato e Definir variável dentro de um workflow para salvar dados na ficha do contato e lidar com valores temporários durante a execução.

Jun 26, 2026

Veja este passo no vídeo · Contatos e variáveis

Os nós Atualizar contato e Definir variável são duas peças-chave para que suas automações não apenas respondam, mas também lembrem e guardem informação. O primeiro grava dados permanentes na ficha do contato; o segundo guarda valores temporários que existem apenas enquanto a execução do workflow dura.

Ambos ficam na seção Ações da paleta do editor de workflows (menu lateral Automações).

Quando usar cada um

  • Atualizar contato: quando você quer guardar algo de forma permanente no contato (nome, e-mail, idioma ou um campo personalizado como "Origem do lead"). O que você gravar aparece em Contatos e se mantém entre conversas.
  • Definir variável: quando você precisa de um valor temporário para usar mais adiante no mesmo fluxo (um contador de tentativas, ou um texto montado a partir da resposta do cliente). A variável some quando a execução termina.

O nó Atualizar contato

  1. Abra seu workflow em Automações e arraste o nó Atualizar contato para a tela.
  2. Conecte-o à saída do nó anterior.
  3. No inspetor à direita, adicione uma ou mais atribuições. Cada uma tem um Campo e um Valor.
  4. Em Campo, escolha um campo padrão (Nome, Sobrenome, Nome de exibição, E-mail, Telefone, Empresa, Notas, Idioma, Fuso horário) ou um campo personalizado criado em Contatos.
  5. Em Valor, digite um texto fixo ou insira dados do fluxo com a sintaxe {{$nome_variavel}} (por exemplo {{$ai.response}}).
  6. Salve e publique o workflow.

O nó atualiza o contato ativo da conversa que disparou o workflow. Se o fluxo não tiver um contato no contexto, o nó não terá em quem gravar.

O nó Definir variável

  1. Arraste Definir variável para a tela e conecte-o.
  2. Adicione uma atribuição com um Nome (sem espaços, ex.: tentativas), um Valor e uma Operação.
  3. Escolha a operação:
    • Definir (set): sobrescreve o valor.
    • Anexar (append): concatena texto ao valor atual.
    • Incrementar (increment): trata como número e soma; ideal para contadores. Deixe o valor vazio para somar 1.
  4. Mais adiante, referencie a variável em qualquer outro nó com {{$tentativas}}.

As variáveis persistem durante toda a execução, mesmo depois de um nó de espera, então você pode defini-las no início e usá-las no fim.

Verificação

Use o botão Testar do editor para rodar o fluxo com um contato de teste. Depois abra a ficha do contato em Contatos e confirme que o campo mudou. Para as variáveis, veja a linha do tempo de execução do workflow: cada nó mostra os valores que calculou.

Se não funcionar

  • "No contact_id in context": o workflow disparou a partir de um evento sem contato associado. Use um gatilho ligado a uma conversa ou contato.
  • O campo personalizado não salva: confirme que o campo existe em Contatos e que o tipo (número, data, booleano) corresponde ao valor enviado.
  • A variável sai vazia: garanta que o nome esteja escrito exatamente igual ao defini-la e ao usá-la; {{$Tentativas}} e {{$tentativas}} são diferentes.

Dicas

  • Combine os dois: defina uma variável temporária, monte-a com várias respostas e, no fim, jogue-a no contato com Atualizar contato.
  • Use Atualizar contato para gravar o idioma detectado e personalizar mensagens futuras.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp