O que são variáveis e sua sintaxe ({{$...}})

As variáveis substituem marcadores como {{$contact.first_name}} por valores reais quando a automação roda. Aprenda a sintaxe e como inseri-las.

Jun 26, 2026

Veja este passo no vídeo · Variáveis

O que é e quando usar

Uma variável é um marcador que a automação substitui por um valor real no momento em que ela roda. Em vez de escrever um nome fixo, você escreve {{$contact.first_name}} e, ao executar a automação, o Omnifox troca pelo nome do contato. Assim uma mesma mensagem serve para todos.

Servem para personalizar mensagens e e-mails, montar o corpo de uma requisição HTTP para outro sistema, ou tomar decisões dentro de uma condição.

A sintaxe: {{$...}}

A forma recomendada envolve o nome em chaves duplas com um sinal $:

{{$contact.first_name}}

O Omnifox também aceita duas formas equivalentes:

  • Sem o sinal $: {{contact.first_name}}
  • Em linha, sem chaves: $contact.first_name (seguido de espaço ou pontuação)

Importante: se uma variável estiver vazia (por exemplo um contato sem sobrenome) ou não existir, ela é substituída por texto vazio. Você nunca verá o {{...}} cru na mensagem enviada.

Onde usar

Você pode digitar variáveis em quase qualquer campo de texto dos nós de ação:

  • O texto de uma mensagem (Enviar mensagem).
  • O assunto e o corpo de um e-mail (Enviar e-mail).
  • O corpo e os cabeçalhos de uma requisição HTTP.
  • O título de uma tarefa, uma nota interna, etc.

Passos para inserir uma variável

  1. Abra a automação em Automações e selecione um nó de ação.
  2. Abra o painel Variáveis do editor.
  3. Encontre a variável que quer (por exemplo contact.first_name).
  4. Toque em Copiar: copia o token {{$contact.first_name}}.
  5. Cole no campo de texto, onde quiser que o valor apareça.

Crie suas próprias variáveis

Além das que já vêm por padrão, você pode definir as suas com o nó Definir variável (set variable). Cada atribuição tem:

  • nome — sem o $, por exemplo tentativas.
  • valor — um texto fixo ou que use outras variáveis.
  • operação — set (atribuir), append (concatenar) ou increment (somar, ideal para contadores de novas tentativas).

Depois você a referencia mais abaixo no fluxo como {{$tentativas}}.

Verificação

Use o botão de teste (Test run) do editor com um contato real e abra a linha do tempo: você verá a mensagem já com os valores substituídos. Se vir o token sem substituir, o nome não confere.

Se não funcionar

  • Sai texto vazio onde você esperava um valor: esse campo do contato está vazio, ou você digitou errado o nome da variável.
  • Aparece {{$algo}} literal na mensagem: confira as chaves (devem ser duplas) e o nome exato; copie a variável a partir do painel Variáveis para evitar erros de digitação.
  • Uma variável própria sai vazia: garanta que o nó Definir variável rode antes do nó que a usa.

Dicas

  • Copie sempre as variáveis a partir do painel Variáveis; assim evita erros de nome.
  • Para contar tentativas use increment: começa vazio e soma 1 a cada volta.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp