Variável de fluxo

O módulo Variável de Fluxo salva informações vinculadas ao fluxo em andamento, para essa conversa específica. É útil para guardar dados coletados ao longo do atendimento e reaproveitá-los mais adiante, dentro do mesmo fluxo.

---

🧭 Como acessar

1. No menu lateral, clique em Gerenciamento de aplicativos.

2. Em seguida, clique em Fluxos.

3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.

4. No painel de módulos, localize a categoria Ação (identificada pela cor vermelha).

5. Arraste o módulo Variável de Fluxo para a área de trabalho do fluxo.

Imagem 1 - Módulo Variável de fluxo localizado no painel de busca, na categoria Ação.

---

🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela, com duas formas de preencher as variáveis.

Imagem 2 - Painel de configuração do módulo Variável de fluxo aberto.

---

📝 Editar variáveis

Nesta aba, você adiciona pares de nome e valor para cada informação que quer guardar nesse fluxo.

---

📋 Campos de configuração

Campo	O que preencher
Variável	O nome que vai identificar essa informação salva no fluxo (ex.: motivo).
Valor	O valor que será salvo nessa variável — pode ser um texto fixo ou uma variável do fluxo (ex.: {{input.motivo}}).

---

1️⃣ Adicionar uma variável

🎯 Propósito

Criar uma nova informação para ser salva no fluxo em andamento, com um nome e um valor.

✅ Como fazer na tela

1. Na aba Editar variáveis, clique em + Adicionar variável.

2. Uma nova linha aparece com os campos Variável e Valor.

3. No campo Variável, digite o nome que vai identificar essa informação (ex.: motivo).

4. No campo Valor, digite um texto fixo ou uma variável do fluxo (ex.: {{input.motivo}}).

5. Repita os passos acima para cada informação que quiser salvar.

📌 Resultado esperado

A nova variável passa a fazer parte da configuração do módulo. Quando o fluxo executar esse módulo, o valor é salvo para essa conversa e pode ser consultado mais adiante no mesmo fluxo com {{flow.nome_da_variavel}}.

---

2️⃣ Editar uma variável existente

🎯 Propósito

Alterar o nome ou o valor de uma variável já configurada no módulo.

✅ Como fazer na tela

1. Localize a linha da variável que deseja alterar.

2. Clique no campo Variável ou Valor e edite o conteúdo.

3. A alteração aparece automaticamente também na aba Editar como JSON.

📌 Resultado esperado

O novo nome ou valor substitui a informação anterior dessa variável assim que o fluxo executar o módulo novamente.

---

3️⃣ Remover uma variável

🎯 Propósito

Retirar uma variável que não é mais necessária na configuração do módulo.

✅ Como fazer na tela

1. Na linha da variável que deseja remover, clique no ícone X à direita dos campos.

2. A linha é removida imediatamente.

O ícone de remoção só aparece quando há mais de uma variável configurada — o módulo sempre mantém ao menos uma linha visível.

📌 Resultado esperado

A variável deixa de fazer parte da configuração do módulo e não é mais salva quando o fluxo é executado.

---

🧾 Editar como JSON

Nesta aba, defina as mesmas informações em formato JSON — as duas abas ficam sempre sincronizadas. Exemplo:

{
  "motivo": "{{input.motivo}}",
  "etapa": "confirmacao"
}

Salvar uma variável de fluxo não apaga as variáveis salvas anteriormente nesse mesmo fluxo — cada execução adiciona ou atualiza apenas as chaves informadas.

Imagem 3 - Aba Editar Como JSON com o mesmo conteúdo em formato JSON.

---

➡️ Continuar automaticamente

Uma chave permite decidir se o fluxo segue automaticamente para o próximo módulo depois de salvar a variável, ou se encerra neste ponto.

---

💡 Caso de uso

Cenário: durante um fluxo de suporte técnico, o cliente informa em qual etapa do problema ele está, e essa informação precisa ser usada mais adiante no mesmo atendimento.

Configuração:

1. Assim que o cliente responder qual é o motivo do contato, adicione o módulo Variável de Fluxo.

2. Na aba Editar variáveis, crie o par motivo com o valor {{input.motivo}}.

3. Ative Continuar automaticamente.

Resultado: mais adiante no mesmo fluxo, é possível usar {{flow.motivo}} para personalizar as próximas mensagens com base no que o cliente já informou.

Imagem 4 - Painel de configuração do módulo com a variável "motivo" preenchida com o valor {{input.motivo}}.

---

📌 Dicas úteis

• Use a Variável de Fluxo para informações que fazem sentido apenas dentro do atendimento atual.

• Se a informação precisar ser lembrada em conversas futuras com o mesmo contato, use o módulo Variável de Usuário no lugar.

• Se precisar de uma informação compartilhada entre diferentes fluxos e conversas (não vinculada a um contato específico), use o módulo Variável Compartilhada.

• A variável de fluxo foi pensada para durar apenas enquanto o atendimento está em andamento, mas hoje ela pode continuar disponível por muito mais tempo do que o esperado. Não conte com um apagamento automático: se a informação não fizer mais sentido, sobrescreva o valor ou encerre o atendimento.

---

📝 Resumo

• O módulo Variável de Fluxo salva informações vinculadas ao fluxo em andamento, para uso nas próximas etapas da mesma conversa.

• É possível editar as variáveis em pares nome/valor ou diretamente em JSON — as duas formas ficam sincronizadas.

• Salvar uma nova variável não apaga as anteriores; apenas atualiza ou adiciona as chaves informadas.

• A chave Continuar automaticamente define se o fluxo segue para o próximo módulo após salvar.