Skip to main content
Variáveis definidas neste nó existem apenas durante a execução atual. Elas não persistem entre execuções distintas do mesmo workflow.

​
Como Funciona

O nó Definir Variável cria ou sobrescreve variáveis com escopo de execução. Uma vez definidas, ficam acessíveis em todos os nós seguintes via {{ $vars.nome_da_variavel }} — incluindo nós de condição, HTTP, código JS e o prompt do nó LLM. Use o nó para:
  • Extrair campos de um payload volumoso e dar nomes claros e curtos a eles
  • Calcular ou concatenar valores derivados de múltiplas fontes do fluxo
  • Armazenar resultados intermediários que serão consumidos por mais de um nó adiante
  • Inicializar contadores, flags ou objetos de controle antes de entrar em um loop

​
Opções de Configuração

Um único nó pode definir quantas variáveis forem necessárias. Cada variável exige três campos:
  • Nome — identificador em snake_case sem espaços; após digitar, o painel exibe a expressão de acesso {{ $vars.seu_nome }}
  • Tipo — determina como o valor é armazenado e interpretado pelo motor de execução
  • Valor — campo estático, referência dinâmica via template {{ }} ou editor de bloco para JSON
TipoQuando usar
stringTextos, IDs, nomes, e-mails, valores alfanuméricos
numberQuantidades, totais, índices para cálculos e comparações
booleanFlags de controle (true / false) para condicionais
jsonObjetos ou arrays complexos que serão passados ao nó HTTP ou ao nó LLM
expressionTemplate dinâmico completo — o valor inteiro é resolvido em execução

​
Casos de Uso Comuns

O nó Definir Variável é mais útil nos seguintes padrões:
  • Renomear campos do payload — um webhook externo chega com chaves em inglês (customer.full_name, order.ref); defina variáveis com nomes em português antes de referenciar nos nós seguintes, tornando o fluxo mais legível
  • Construir corpo de requisição HTTP — monte um objeto json complexo com campos vindos de diferentes partes do fluxo ($trigger, $json, outros $vars) e referencie a variável como {{ $vars.payload }} no campo de corpo do nó HTTP
  • Controlar iterações em loop — inicialize contador como number com valor 0 e lista_erros como json com valor [] antes do nó Loop; o nó JavaScript interno atualiza esses valores a cada iteração usando vars.contador e vars.lista_erros