> For the complete documentation index, see [llms.txt](https://docs.floui.io/guia/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.floui.io/guia/configuracoes/variaveis-globais.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
