# Variáveis globais

## Introdução

O uso de Variáveis Globais permite armazenar e reutilizar informações de forma centralizada dentro do Workspace, facilitando a configuração e execução de fluxos. Elas podem ser acessadas por diferentes conectores e personalizações, garantindo flexibilidade e segurança na automação de processos.&#x20;

## Gerenciar variáveis

Para gerenciar as variáveis globais do Workspace, acesse o menu lateral, vá até **Configurações** e clique em **Variáveis**. Nesta tela, é possível visualizar a listagem de variáveis existentes, criar novas variáveis, editar ou remover variáveis conforme necessário.

<figure><img src="/files/53Oudzc42C0ut1A3EIBu" alt=""><figcaption><p>Gerenciar variáveis</p></figcaption></figure>

## Crie variáveis

Para criar uma variável global no nível do Workspace, acesse a tela de listagem de variáveis e clique em **Criar Variável**, localizado no canto superior direito.&#x20;

No formulário de criação, defina um **nome** para a variável, utilizado como identificador visual, e insira o **código da variável**, que servirá como chave de acesso ao recurso. Em seguida, informe o **conteúdo** da variável e finalize clicando em **Salvar Variável**.

Por motivos de segurança não é permitido inserir variáveis globais com mesmo nome ou código.

<figure><img src="/files/00IaNVHDaeQkb7PkTqy0" alt=""><figcaption><p>Criação de variáveis globais</p></figcaption></figure>

## Acesso a variáveis

As variáveis globais criadas no Workspace podem ser acessadas e utilizadas de diferentes formas, permitindo maior flexibilidade na reutilização de dados em fluxos e configurações. A seguir, são apresentadas as principais maneiras de acessar e utilizar essas variáveis dentro da plataforma.

### Conectores

Durante a configuração de conectores, em geral, é possível obter acesso aos valores de variáveis globais utilizando a notação Mustache.

<details>

<summary>Mustache</summary>

Nos campos de configuração utilize **var** antes de instanciar a variável dentro da marcação Mustache {{ }}.

```mustache
{{var minha_variavel}}
```

</details>

Com o conector [Function Javascript](/guia/conectores/categorias/conectores-essenciais/function-javascript.md), é possível acessar a variável global a partir de uma função reservada **getVar()**.

<details>

<summary>Função reservada</summary>

Aplicada via conector [Function Javascript](/guia/conectores/categorias/conectores-essenciais/function-javascript.md).

```javascript
let minhavariavel = await getVar("nome_variavel")
```

</details>

### Conector Personalizado

As variáveis globais podem ser usadas na implementação de conectores personalizados, através de uma função reservada.

<details>

<summary>Função reservada</summary>

Aplicada via conectores personalizadas.

```javascript
let minhavariavel = await getVar("nome_variavel")
```

</details>

## Precedência entre variáveis globais e de fluxos

Quando uma variável local é criada dentro de um fluxo com a mesma chave de uma variável global, o ambiente adota uma ordem de precedência, priorizando a variável local. Isso garante que o fluxo utilize a variável definida em seu contexto imediato, sem impactar outras execuções ou dependências que utilizem a variável global.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.floui.io/guia/configuracoes/variaveis-globais.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
