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

Nó: Definir variável

Como usar o nó Definir variável para guardar e atualizar dados temporários durante a execução de um workflow.

Jul 11, 2026

O nó Definir variável guarda um ou mais valores no contexto do workflow para que os próximos nós possam usá-los com {{$nome}}. É a forma de o workflow ter "memória" durante uma execução: contar tentativas, guardar o resultado de um nó anterior ou montar um texto antes de enviá-lo.

Quando usar

  • Guardar um valor calculado (ex.: um desconto) para reaproveitar em vários nós.
  • Manter um contador de tentativas junto com um nó Se para interromper um laço.
  • Montar mensagens dinâmicas combinando variáveis de diferentes etapas.

Configuração

Cada linha de "atribuições" tem três campos:

  • Nome: o nome da variável (sem o sinal $, o sistema adiciona sozinho).
  • Valor: o valor a guardar. Aceita variáveis de outros nós, por exemplo {{$contact.name}}.
  • Operação:
    • Set (padrão): substitui o valor atual.
    • Append: concatena o valor novo ao final do valor existente (como texto).
    • Increment: soma o valor indicado ao número atual. Se o campo "valor" ficar vazio, soma 1 — ideal para contadores de tentativas.

Você pode adicionar várias linhas no mesmo nó para definir várias variáveis de uma vez.

Exemplo

Um workflow tenta chamar um agente de IA até 3 vezes. A cada volta, adicione um nó Definir variável com nome tentativas, operação Increment e valor vazio. Um nó Se mais adiante interrompe o laço quando {{$tentativas}} chegar a 3.

Dicas

  • As variáveis definidas aqui sobrevivem mesmo depois de uma espera (delay) ou uma pausa do workflow.
  • Use nomes curtos e descritivos: tentativas, desconto, idioma_detectado.

Solução de problemas

Se um nó posterior não enxergar a variável, confira se o nome está escrito exatamente igual (sem espaços) e se o nó Definir variável foi executado antes no mesmo caminho do workflow.

Isso foi útil?

Artigos relacionados