O que são variáveis de fluxo?

As variáveis de fluxo são campos dinâmicos que você pode usar para referenciar dados em tempo real nos seus fluxos. Elas permitem extrair informações de gatilhos e ações (por exemplo, mensagens, contatos ou conversas) e usar esses dados para roteamento, personalização e automação.

Você pode usar variáveis de fluxo para:

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

Como funcionam as variáveis de fluxo?

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á sempre associado ao contato inscrito 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 consistência. Quando um fluxo é executado, os valores das variáveis sempre são resolvidos em relação ao contato envolvido.

A única exceção são as variáveis de integração. Essas variáveis extraem dados diretamente de sistemas externos conectados (por exemplo, plataformas de CRM, Shopify, Stripe e APIs). Como esses dados se originam fora da SleekFlow, eles não são vinculados automaticamente 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 do webhook incluir identificação de contato. Por exemplo, se você usar o gatilho Webhook received e o payload do webhook contiver 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 será vinculada a esse contato durante a execução do fluxo.

Isso oferece mais flexibilidade ao trabalhar com dados como:

• Detalhes de pedidos obtidos do Shopify
• Status de pagamento do Stripe
• Valores de respostas de APIs personalizadas mapeadas a partir de webhooks

Existem três 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, etiqueta).
2. Propriedade do contato: campos armazenados no registro do contato (por exemplo, nome, número de telefone, etiquetas e endereço de e-mail).
3. Variáveis de meio de fluxo: valores capturados ou gerados enquanto o fluxo está em execução. 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

As variáveis disponíveis no seu fluxo dependem dos blocos de gatilho e de ação que você adicionou.

Por que usar variáveis de fluxo?

As variáveis de fluxo ajudam você a automatizar experiências mais inteligentes e personalizadas. Alguns casos de uso comuns incluem:

1. Filtrar quem é inscrito em um fluxo

Por exemplo, você pode optar por inscrever contatos apenas quando a mensagem recebida contiver uma palavra-chave específica, seguindo as etapas abaixo:

1. No formulário do bloco de gatilho, vá até a aba Filtro
2. Ative 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 corresponder
6. Clique em Adicionar valor para incluir mais de uma palavra-chave

Após a configuração, apenas mensagens que contenham a(s) palavra(s)-chave definida(s) — neste caso, “Pricing” — irão acionar 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 nome do contato, número de telefone ou conteúdo da mensagem.

1. Adicione um bloco de ação Enviar mensagem ao seu fluxo
2. No campo de entrada da mensagem, comece a digitar o conteúdo
3. Clique no ícone de variável {X}

4. Escolha uma das variáveis disponíveis, por exemplo “Nome do cliente”
5. A variável selecionada aparecerá entre chaves no campo da mensagem (por exemplo, {{Customer name}})
6. Feche o formulário do bloco

Suas mensagens agora serão personalizadas automaticamente com base no contexto do contato ou do gatilho.

3. Roteamento ou ramificação com base em dados

Use variáveis em blocos de condição para controlar como os clientes percorrem o fluxo — ideal para personalizar experiências com base no conteúdo da mensagem, atributos do cliente ou canal.

1. Adicione um bloco de Ramificação por condição após o gatilho ou qualquer ação
2. Abra o formulário do bloco e selecione uma variável na aba Campo
3. Escolha um Operador
4. Insira o valor a ser comparado
5. Adicione condições adicionais, se necessário
6. Feche o formulário do bloco

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

Exemplo de caso de uso

1. Enviar acompanhamentos com base no status da mensagem

Você pode usar variáveis para automatizar acompanhamentos. Por exemplo, é possível enviar automaticamente um lembrete quando um cliente tiver um horário de compromisso agendado:

1. No formulário do bloco de gatilho, vá até a aba Filtro
2. Em Se, selecione Horário do compromisso 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
5. Ou use um bloco de Condição para tratar diferentes status de forma distinta
    

2. Manter registros usando o ID da conversa

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

1. Selecione o gatilho Conversation status updated
2. No formulário do bloco, vá até a aba Filtro
3. Em Se, escolha Novo status da conversa e defina o operador como Igual a → Resolvido
4. Adicione um bloco de ação Adicionar nota interna
5. No campo da nota, insira a variável ID da conversa junto com uma mensagem curta. Por exemplo: 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 o ID único da conversa. Isso ajuda a equipe a identificar rapidamente a conversa correta caso seja necessário revisá-la ou reabri-la posteriormente.