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.

Jun 26, 2026

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

  1. Abra Automacoes no menu lateral e entre no seu workflow.
  2. Na barra superior do editor, clique no botao Variaveis.
  3. Um painel abre a direita com as tres secoes. Use a busca para filtrar por nome.
  4. 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

  1. Insira o token em um campo (por exemplo, uma mensagem de teste: Ola {{$contact.first_name}}).
  2. Clique em Probar (Testar) na barra superior e dispare uma execucao.
  3. 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_name inline. 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

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp