For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.


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


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

📝 Editar variáveis

Nesta aba, adicione pares de nome e valor. O valor pode ser um texto fixo ou uma variável do fluxo (ex.: {{input.plano}}).

🧾 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:

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.

➡️ 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: 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.

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

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