Variaveis de gatilho e de no (resultado de acoes anteriores)
Aprenda a usar as variaveis que o gatilho traz e as que seus nos produzem para personalizar mensagens e acoes nos seus workflows.
Veja este passo no vídeo · Variáveis
O que sao variaveis em um workflow
Toda vez que um workflow e executado, o motor monta um contexto com os dados do evento que o disparou (o contato, a conversa, o canal) e vai guardando o resultado de cada no conforme ele roda. Esses dados sao as variaveis, e voce pode inseri-las em quase qualquer campo de texto usando a sintaxe {{$nome}}.
Existem tres origens de variaveis, e e exatamente assim que o painel Variaveis as agrupa no editor:
- Do gatilho — o que o evento disparador traz consigo (dados do contato e da conversa).
- Do workflow — o que os seus proprios nos produzem ao rodar (o resultado de acoes anteriores).
- Built-in — sempre disponiveis, independente do gatilho (
{{$now}},{{$today}},{{$workflow.name}}, etc.).
Abrir o painel de variaveis
- Abra Automacoes no menu lateral e entre no seu workflow.
- Na barra superior do editor, clique no botao Variaveis.
- Um painel abre a direita com as tres secoes. Use a busca para filtrar por nome.
- Clique em Copiar em qualquer variavel para levar o token
{{$variavel}}para a area de transferencia e cole no campo do no que esta configurando.
Variaveis do gatilho
Dependem do evento que voce escolheu como disparador. Os gatilhos de conversa expoem, entre outras:
{{$contact.first_name}},{{$contact.last_name}},{{$contact.display_name}},{{$contact.email}},{{$contact.phone}},{{$contact.company}},{{$contact.tags}}{{$conversation.id}},{{$conversation.status}},{{$conversation.channel_name}},{{$conversation.assignee}},{{$conversation.assignee_team}}
Alguns gatilhos adicionam variaveis proprias. Por exemplo, Conversa fechada expoe dados do fechamento, e Fechamento automatico por inatividade expoe {{$last_responder}} e {{$days_inactive}}. O painel sempre mostra exatamente as que se aplicam ao gatilho selecionado, com uma breve descricao de cada uma.
Variaveis de no (resultado de acoes anteriores)
Sao criadas a medida que voce adiciona nos. As mais comuns:
- Set variable — cada linha de atribuicao cria uma variavel com o nome que voce digita.
- Ask question (perguntar ao cliente) — salva a resposta na variavel indicada em Salvar na variavel.
- HTTP request — salva a resposta da API (como JSON) na variavel que voce definir.
- Loop — dentro do laco expoe
{{$_index}}(posicao) e{{$_item}}(elemento atual).
Um no so consegue ler variaveis de nos que rodaram antes dele no fluxo. Por isso a ordem importa: se quiser usar a resposta de um Ask question em um Send message, a mensagem precisa vir depois da pergunta.
Verificar se uma variavel e resolvida
- Insira o token em um campo (por exemplo, uma mensagem de teste:
Ola {{$contact.first_name}}). - Clique em Probar (Testar) na barra superior e dispare uma execucao.
- Abra o painel Timeline no rodape do canvas e confira a saida do no: voce vera o texto ja com a variavel substituida.
Se nao funcionar
- A mensagem mostra o texto literal
{{$...}}: o nome nao corresponde a nenhuma variavel disponivel. Sempre copie pelo painel Variaveis para evitar erros de digitacao. - A variavel sai vazia: o campo de origem nao tinha valor (por exemplo um contato sem sobrenome). O motor substitui valores nulos por texto vazio, nao pelo token.
- A variavel de um no nao aparece: confirme que esse no esta conectado antes no fluxo e que voce salvou o workflow.
Dica: voce pode escrever o token em tres formatos equivalentes —
{{$contact.first_name}},{{contact.first_name}}ou$contact.first_nameinline. Use sempre o primeiro para mais clareza.
Dica: os nomes distinguem dados do contato (
contact.*) dos dados da conversa (conversation.*). Quando um valor existe em ambos, prefira o que se encaixa no contexto do seu fluxo.
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.