Visão geral das variáveis de fluxo

Como usar variáveis de fluxo no Advanced Flow Builder

Written By Ray Tang (Administrator)

Updated at October 23rd, 2026

O que são variáveis de fluxo?

As variáveis de fluxo são campos dinâmicos que permitem consultar dados em tempo real nos seus fluxos. Elas permitem recuperar informações de gatilhos e ações (como mensagens, contatos ou conversas) e usar esses dados para direcionamento, personalização e automação.

Você pode usar variáveis de fluxo para:

  • Personalizar mensagens enviadas
  • Criar condições com base nos dados recebidos
  • Direcionar clientes dinamicamente para diferentes ramificações do fluxo


How does flow variables works? 

A maioria das variáveis de fluxo na SleekFlow está vinculada a um contato. Isso significa que, sempre que você seleciona uma variável, seja ela proveniente de uma mensagem, conversa ou propriedade, o valor estará associado ao contato incluído naquele fluxo.

Por exemplo, neste caso, {contact_name} é uma variável que insere automaticamente o nome do cliente com base no registro do contato. Isso garante que cada cliente receba uma mensagem personalizada, sem a necessidade de edição manual.

Essa estrutura centrada no contato garante a consistência dos dados. Quando um fluxo é executado, os valores das variáveis são sempre determinados com base no contato envolvido.

A única exceção são as variáveis de integração. Essas variáveis recuperam dados diretamente de sistemas externos conectados à SleekFlow (como plataformas de CRM, Shopify, Stripe e APIs). Como os dados são provenientes de sistemas externos, eles não são automaticamente vinculados a um contato específico por padrão.

No entanto, algumas variáveis de integração podem ser associadas a um contato se a configuração do gatilho ou webhook incluir informações de identificação do contato. Por exemplo, se você usar o gatilho "Webhook recebido" e os dados recebidos pelo webhook contiverem um campo, como número de telefone ou ID do cliente, que corresponda a um contato existente na SleekFlow, o sistema vinculará automaticamente os dados recebidos a esse contato.

Nesses casos, a variável de integração ficará vinculada ao contato durante a execução do fluxo.

Isso oferece mais flexibilidade ao trabalhar com dados como:

  • Detalhes de pedidos recuperados da Shopify
  • Status de pagamento do Stripe
  • Valores de respostas de APIs personalizadas mapeados a partir de webhooks

 

Existem 3 tipos de variáveis de fluxo:

  1. Propriedade comum: valores gerais disponíveis na maioria dos fluxos (por exemplo, conteúdo da mensagem, último canal e etiqueta).
  2. Propriedade de contato: campos armazenados no registro de um contato (por exemplo, nome, número de telefone, etiquetas e endereço de e-mail).
  3. Variáveis durante o fluxo: valores capturados ou gerados durante a execução do fluxo. Essas variáveis podem mudar ou ser atualizadas conforme a conversa avança, como:
    1. Conteúdo da mensagem capturado a partir da resposta do contato
    2. Etiquetas adicionadas a um contato durante o fluxo
    3. As variáveis disponíveis no seu fluxo dependem dos Blocos de Gatilho e Blocos de Ação que você adicionou.

 

Por que usar variáveis de fluxo?

As variáveis de fluxo ajudam você a criar automações mais inteligentes e experiências personalizadas. Veja alguns casos de uso comuns:

1. Filtrar quais contatos serão incluídos em um fluxo

Por exemplo, você pode configurar o fluxo para incluir apenas contatos cujas mensagens recebidas contenham uma palavra-chave específica. Para isso, siga as etapas abaixo:

  1. No formulário de configuração do Bloco de Gatilho, acesse a aba "Filtro".
  2. Ative a opção "Condições de inscrição".
  3. Em "Se", selecione "Conteúdo da mensagem" na lista de variáveis.
  4. Defina o operador como "Contém".
  5. Insira a palavra-chave que deseja identificar.
  6. Clique em "Adicionar valor" para adicionar mais de uma palavra-chave.

Depois de configurar essas condições, apenas mensagens que contenham as palavras-chave especificadas, neste caso, "Pricing", acionarão o fluxo.

 

2. Personalizar mensagens com valores dinâmicos

Use variáveis de fluxo para inserir dados em tempo real nos seus modelos de mensagem, como nomes de contatos, números de telefone ou conteúdo de mensagens.

  1. Adicione um Bloco de Ação "Enviar mensagem" ao seu fluxo.
  2. No campo de texto da mensagem, comece a digitar o conteúdo.
  3. Clique no ícone de variável {X}.
  4. Selecione uma variável na lista. Por exemplo, selecione "Nome" em “Propriedade de contato”.
  5. Para pesquisar uma variável, digite o nome ou uma palavra-chave na barra de pesquisa. Por exemplo, digite "contact" para visualizar as variáveis correspondentes.


     

Agora, suas mensagens serão personalizadas automaticamente com base nas informações do contato ou no contexto do gatilho.

 

3. Direcionar contatos ou criar ramificações com base nos dados

Use variáveis nos Blocos de Condição para controlar como os clientes avançam pelo fluxo. Esse recurso é ideal para personalizar experiências com base no conteúdo das mensagens, nas características dos clientes ou no canal utilizado.

  1. Adicione um Bloco de Condição de ramificação após o gatilho ou qualquer ação.
  2. Abra o formulário de configuração do bloco e selecione uma variável na aba "Campo".
  3. Escolha um operador.
  4. Insira o valor que será usado na comparação.
  5. Adicione outras condições, se necessário.
  6. Feche o formulário de configuração do bloco.

O sistema verificará esses valores e direcionará os contatos para o caminho correspondente em tempo real.

 

Exemplos de casos de uso

1. Enviar mensagens de acompanhamento com base no status da mensagem

Você pode usar variáveis para automatizar mensagens de acompanhamento. Por exemplo, é possível enviar automaticamente um lembrete quando um cliente tiver um agendamento próximo.

  1. No formulário de configuração do Bloco de Gatilho, acesse a aba "Filtro".
  2. Em "Se", selecione "Horário do agendamento" na lista de variáveis.
  3. Defina o operador como "Não está vazio".
  4. Adicione um Bloco de Ação "Enviar mensagem" para lembrar o cliente do agendamento.
  5. Como alternativa, use um Bloco de Condição para tratar diferentes status de maneiras distintas.
     

2. Manter registros usando o ID da conversa

Você pode usar a variável "ID da conversa" para deixar um registro claro para os membros da equipe sempre que o status de uma conversa for alterado. Isso facilita o acompanhamento das atualizações e a localização da conversa correta posteriormente.

  1. Selecione o gatilho "Status da conversa atualizado".
  2. No formulário de configuração do bloco, acesse a aba "Filtro".
  3. Em "Se", selecione "Novo status da conversa", defina o operador como "É igual a" e escolha "Resolvido".
  4. Adicione um Bloco de Ação "Adicionar nota interna".
  5. No campo de texto da nota, insira a variável "ID da conversa" junto com uma mensagem curta. Por exemplo: A conversa {{conversation_id}} foi marcada como resolvida.
  6. Salve o fluxo.

Agora, sempre que uma conversa for encerrada, a SleekFlow adicionará automaticamente uma nota com seu ID exclusivo. Isso ajuda os membros da equipe a localizar rapidamente a conversa correta caso precisem revisá-la ou reabri-la posteriormente.