> 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-usuario.md).

# Variável de usuário

## 👤 Variável de Usuário

O módulo **Variável de Usuário** salva informações vinculadas diretamente ao contato — não apenas à conversa atual. Uma vez salva, a informação fica disponível em **qualquer fluxo futuro**, mesmo em uma conversa iniciada dias depois, enquanto for o mesmo contato no mesmo canal.

**📷 Inserir print:** visão geral do módulo Variável de Usuário 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 Usuário** 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 Usuário 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 Usuário aberto

***

#### 📝 Editar variáveis

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

**📷 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 contato (ex.: `plano`).                                       |
| **Valor**    | O valor que será salvo nessa variável — pode ser um texto fixo ou uma variável do fluxo (ex.: `{{input.plano}}`). |

**📷 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 contato, 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.: `plano`).
4. No campo **Valor**, digite um texto fixo ou uma variável do fluxo (ex.: `{{input.plano}}`).
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 no contato e pode ser consultado em qualquer conversa futura com `{{user.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 no contato 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 — o que você edita em uma aparece automaticamente na outra. Exemplo:

```json
{
  "plano": "{{input.plano}}",
  "ultima_compra": "2026-01-15"
}
```

{% hint style="info" %}
Salvar uma variável de usuário não apaga as variáveis salvas anteriormente para aquele contato — cada execução do módulo adiciona ou atualiza apenas as chaves informadas, mantendo as demais.
{% 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

***

### 📌 Dicas úteis

* Use a **Variável de Usuário** para informações que fazem sentido lembrar do contato como um todo (plano, preferências, histórico), não apenas da conversa atual.
* Para informações que só importam durante o fluxo em andamento, prefira o módulo **Variável de Fluxo**.
* Como os valores não expiram automaticamente, mantenha essa variável atualizada sempre que a informação mudar.

***

### 💡 Caso de uso

**Cenário:** uma loja quer lembrar o plano de assinatura de cada cliente, para usar essa informação em qualquer atendimento futuro, mesmo em conversas diferentes.

**Configuração:**

1. Assim que o cliente informa ou confirma seu plano, adicione o módulo **Variável de Usuário**.
2. Na aba **Editar variáveis**, crie o par `plano` com o valor `{{input.plano}}`.
3. Ative **Continuar automaticamente**.

**Resultado:** em qualquer conversa futura com esse mesmo cliente, o fluxo pode consultar `{{user.plano}}` para saber qual plano ele tem, sem precisar perguntar de novo.

***

### 📝 Resumo

* O módulo **Variável de Usuário** salva informações vinculadas ao contato, disponíveis em qualquer conversa futura com ele.
* É 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.