Variaveis personalizadas e operacoes sobre variaveis

Crie suas proprias variaveis com Set variable e use as operacoes set, append e increment para contadores e textos dinamicos.

Jun 26, 2026

Veja este passo no vídeo · Variáveis

Para que servem as variaveis personalizadas

Alem das variaveis que o gatilho traz, voce pode criar as suas proprias com o no Set variable e altera-las ao longo do fluxo. Sao ideais para contadores (tentativas, numero de avisos), para montar textos a partir de varios dados, ou para guardar a resposta de uma pergunta ou de uma API para usar mais adiante.

Este artigo pressupoe que voce ja conhece o basico de variaveis. Se esta comecando, leia antes Variaveis de gatilho e de no.

Criar uma variavel com Set variable

  1. No editor do workflow, arraste o no Set variable para o canvas e conecte-o onde for preciso.
  2. Abra-o e clique em Adicionar para criar uma linha de atribuicao.
  3. Em Nome digite o identificador (sem o $), por exemplo tentativas.
  4. Em Valor digite o conteudo. Pode ser texto fixo ou incluir outras variaveis: Pedido de {{$contact.first_name}}.
  5. Escolha a operacao (coluna da direita) e salve o workflow.

A partir dai a variavel fica disponivel como {{$tentativas}} para todos os nos seguintes, e ela ate sobrevive as esperas (nos Delay / Wait).

As tres operacoes sobre variaveis

A coluna de operacao em cada linha do Set variable define como o valor e aplicado:

  • set (padrao): sobrescreve o valor. tentativas = 0.
  • += str (append): concatena o valor como texto no final do atual. Util para montar uma lista ou uma mensagem longa em partes.
  • += num (increment): trata a variavel como numero e soma o valor. Se deixar o valor vazio, soma +1. Ideal para contadores de tentativas ou de avisos enviados.

Um padrao classico de contador: um no Set variable no inicio com tentativas = 0 (operacao set), e dentro de um laco de repeticao outro Set variable com tentativas na operacao += num e valor vazio, que soma 1 a cada volta. Depois um no If/Else compara {{$tentativas}} com um limite.

Combinar variaveis em um valor

Qualquer campo de valor aceita interpolacao, entao voce pode misturar texto e varias variaveis numa unica atribuicao:

nome_completo = {{$contact.first_name}} {{$contact.last_name}}
resumo = Cliente {{$contact.display_name}} ({{$contact.phone}}) - canal {{$conversation.channel_name}}

Lembre-se de que um valor nulo (por exemplo um contato sem sobrenome) e substituido por texto vazio, nao pelo token literal.

Verificar o resultado

  1. Clique em Probar (Testar) na barra superior e dispare uma execucao.
  2. Abra o painel Timeline no rodape do canvas e clique no no Set variable.
  3. Confira a saida: voce vera o mapa de variaveis com o valor final ja calculado.

Se nao funcionar

  • O contador nao soma: confirme que a operacao e += num, nao set. Com set o valor e reescrito a cada volta em vez de acumular.
  • O append junta os textos sem separacao: o operador nao adiciona espacos; inclua-os voce mesmo no valor (por exemplo comecando com um espaco).
  • A variavel nao existe mais adiante: o no que a le precisa vir depois do Set variable no fluxo. Ramos paralelos nao compartilham o que e definido no outro ramo.
  • += num deixa um decimal estranho: se os dois operandos forem inteiros o resultado e inteiro; se algum for decimal, o resultado sera decimal.

Dica: nomeie as variaveis em minusculas e com sublinhado (total_avisos, pedido_id). Assim ficam faceis de achar no painel Variaveis.

Dica: para reiniciar um contador no meio do fluxo, use outro Set variable com operacao set e valor 0.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp