Variável compartilhada

O módulo Variável Compartilhada salva, lê ou apaga informações que ficam disponíveis para todos os fluxos e todas as conversas do aplicativo — não apenas para um contato ou um fluxo específico. É o módulo ideal para guardar dados globais, como contadores, configurações dinâmicas ou informações que precisam ser acessadas por diferentes fluxos ao mesmo tempo.

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

Como o valor é compartilhado por todo o aplicativo, use nomes de chave (campo Chave) bem específicos para evitar que fluxos diferentes acabem lendo ou sobrescrevendo o mesmo valor sem querer.

🧩 Operação

Escolha o que este módulo vai fazer:

• Escrever (WRITE) — salva ou atualiza um valor.

• Ler (READ) — busca o valor salvo anteriormente.

• Apagar (DELETE) — remove o valor salvo.

🔑 Chave

No campo Chave, defina o nome que identifica essa informação compartilhada. Você pode usar um valor fixo ou uma variável do fluxo. A mesma chave deve ser usada em todos os módulos que precisarem acessar essa informação.

💾 Valor

Este campo aparece apenas quando a operação é Escrever. Defina aqui o conteúdo que será salvo, podendo usar variáveis do fluxo.

🔀 Saídas do módulo

O módulo tem duas saídas:

• Sucesso — a operação foi concluída. No caso de Ler, o valor encontrado fica disponível para os próximos módulos do fluxo.

• Erro — a operação não pôde ser concluída (por exemplo, ao tentar Ler ou Apagar uma chave que não existe).

💡 Caso de uso

Cenário: uma empresa quer controlar, em todos os fluxos, se uma promoção está ativa no momento, sem precisar editar cada fluxo manualmente.

Configuração:

1. Em um fluxo de controle, adicione o módulo Variável Compartilhada com a operação Escrever, chave promocao_ativa e valor true (ou false, quando quiser desativar).

2. Em qualquer outro fluxo que precise saber se a promoção está ativa, adicione o módulo Variável Compartilhada com a operação Ler e a mesma chave promocao_ativa.

3. Use o valor lido em um módulo Condicional para decidir se a mensagem promocional deve ser exibida.

Resultado: basta atualizar o valor em um único lugar para que todos os fluxos que consultam essa chave reflitam a mudança.

📌 Dicas úteis

• Use nomes de chave descritivos e específicos, para evitar conflitos entre fluxos diferentes.

• Use a operação Apagar para limpar informações que não são mais necessárias.

• Diferente das Variáveis de Usuário e de Fluxo, este módulo pode falhar (por exemplo, ao ler uma chave inexistente) — sempre conecte a saída Erro a um caminho adequado do fluxo.

• Use este módulo apenas para informações que realmente precisam ser globais — para dados específicos de um contato ou de um fluxo, prefira Variável de Usuário ou Variável de Fluxo.

📝 Resumo

• O módulo Variável Compartilhada salva, lê ou apaga informações acessíveis por todos os fluxos e conversas do aplicativo.

• A operação é escolhida entre Escrever, Ler e Apagar, sempre identificada por uma Chave.

• O campo Valor só aparece na operação Escrever.

• O módulo tem uma saída de Sucesso e uma de Erro — importante para tratar casos como leitura de uma chave inexistente.