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.
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
- Abra a automação em Automações e selecione um nó de ação.
- Abra o painel Variáveis do editor.
- Encontre a variável que quer (por exemplo
contact.first_name). - Toque em Copiar: copia o token
{{$contact.first_name}}. - 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 exemplotentativas. - valor — um texto fixo ou que use outras variáveis.
- operação —
set(atribuir),append(concatenar) ouincrement(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
Artigos relacionados
-
Crie sua primeira automacao (workflow)
Os workflows do Omnifox automatizam sua operacao: um gatilho inicia a automacao e os nos de acao fazem o trabalho. Crie uma mensagem de boas-vindas em minutos.
-
Catálogo de disparadores (triggers) dos workflows
Conheça os eventos que podem iniciar um workflow automaticamente no Omnifox.
-
Guia completo dos fluxos de trabalho (Workflows)
Os Workflows a fundo, em 54 capítulos: gatilhos, nós, variáveis, testes, histórico, modelos, importar e exportar, com cada opção explicada e um fluxo real de ponta a ponta.
-
Nós de ação disponíveis nos workflows
Descubra as ações que um workflow pode executar de forma automática.
-
Condições e ramificações (se/então) em um workflow
Faça seus fluxos tomarem decisões e seguirem caminhos diferentes conforme os dados de cada contato.