Variáveis · set_variable / assigner / variable_assigner

Referência do nó

Kind:assigner / set_variable / variable_assignerCategoria:Dados

Para que serve

Pensa num bloco de notas que fica do seu lado durante o atendimento. Você anota o nome do cliente, o número do pedido, a resposta que ele deu — e a qualquer momento pode consultar, mudar ou apagar esse conteúdo. Os nós de variável fazem exatamente isso: guardam informações para você usar mais à frente no fluxo.

Quando usar

• Salvar a escolha que o cliente fez num menu de botões
• Construir uma mensagem personalizada juntando nome + produto + data
• Acumular itens numa lista ao longo de uma iteração
• Limpar o valor de uma variável antes de começar um novo ciclo
• Mesclar dados de fontes diferentes numa saída tipada e organizada

---

Os três nós de variável

O Flow Builder tem três nós com funções parecidas mas objetivos diferentes. Veja qual usar em cada situação:

Nó	Kind	Para que usar
Atribuir Variável	assigner	Criar ou alterar variáveis uma a uma, com controle de operação
Variável (legado)	set_variable	Versão antiga — ainda funciona, mas prefira o assigner
Mesclar Variáveis	variable_assigner	Combinar N entradas em uma saída tipada (texto, número, objeto…)

---

Nó Atribuir Variável (assigner)

Passo a passo

1. ·
   Arraste o nó **Atribuir Variável** para o canvas e conecte-o ao bloco anterior.
   

   

   CAPTURAR: nó assigner sendo arrastado da biblioteca para o canvas

2. ·
   No painel à direita, clique em **+ Adicionar variável**.
3. ·
   Digite o nome da variável (ex.: `nome_cliente`) e escolha a operação desejada.
4. ·
   Informe o valor — pode ser texto fixo ou uma expressão como {{contact.name}}.
5. ·
   Repita para quantas variáveis precisar e salve.
   

   

   CAPTURAR: painel do assigner com uma variável configurada mostrando campo nome, operação e valor

Operações disponíveis

Operação	O que faz
over-write	Substitui o valor atual pelo novo
clear	Apaga o valor (deixa a variável vazia)
append	Adiciona texto ao final do valor existente
extend	Adiciona itens ao final de uma lista

Exemplo

Você quer guardar a resposta do cliente e depois mostrar numa mensagem:

variável: produto_escolhido
operação: over-write
valor:    {{esperar_botao.label}}

Depois, no nó de mensagem: "Você escolheu: {{produto_escolhido}}. Aguarde!"

Dica

Use nomes de variável sem espaços e sem acentos. Prefira snake_case, como nome_cliente ou valor_total. Fica mais fácil de usar nas expressões {{ }}.

---

Nó Mesclar Variáveis (variable_assigner)

Esse nó pega valores de várias partes do fluxo e os organiza numa saída única e tipada — ideal quando você precisa passar um "pacote de dados" para um nó de IA ou de integração.

Passo a passo

1. ·
   Arraste o nó **Mesclar Variáveis** para o canvas.
2. ·
   Escolha o tipo de saída: **Texto**, **Número**, **Objeto JSON** ou **Array**.
3. ·
   Adicione as entradas, mapeando cada campo ao valor correspondente do fluxo.
   

   

   CAPTURAR: painel do variable_assigner mostrando múltiplas entradas sendo mescladas em um objeto JSON de saída

4. ·
   Conecte a saída deste nó ao próximo bloco que vai consumir esses dados.

Campos

Campo	O que faz
Tipo de saída	Define o formato do resultado (texto, número, objeto, array)
Entradas	Lista de pares chave → valor que serão mesclados
Nome da variável de saída	Como essa variável ficará disponível nos próximos nós

Atenção

O nó set_variable (legado) ainda funciona, mas não recebe novas operações. Se você está montando um fluxo novo, use sempre o assigner — ele é mais flexível e claro.