> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/acao/variavel-de-fluxo.md).

# Variável de fluxo

## 🔄 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.

**📷 Inserir print:** visão geral do módulo Variável de Fluxo na área de trabalho do 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.

**📷 Inserir print:** painel de módulos com a categoria Ação expandida e o módulo Variável de Fluxo visível

***

### 🔍 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.

**📷 Inserir print:** 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.

**📷 Inserir print:** aba Editar variáveis com pares de nome e valor preenchidos

***

#### 📋 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}}`). |

**📷 Inserir print:** linha de configuração com os campos Variável e Valor preenchidos

***

#### 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}}`.

**📷 Inserir print:** botão "+ Adicionar variável" e uma nova linha com os campos Variável e Valor vazios

***

#### 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.

**📷 Inserir print:** campo Valor de uma variável existente sendo editado

***

#### 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.

{% hint style="info" %}
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.
{% endhint %}

**📌 Resultado esperado**

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

**📷 Inserir print:** ícone X de remoção destacado ao lado de uma linha de variável

***

#### 🧾 Editar como JSON

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

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

{% hint style="info" %}
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.
{% endhint %}

**📷 Inserir print:** 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.

**📷 Inserir print:** chave "Continuar automaticamente" em destaque

***

### 💡 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.

**📷 Inserir print:** 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.