Mateus Celestino Pro
Se você utiliza o N8N como orquestrador principal das suas automações e precisa lidar com valores que devem ser armazenados e recuperados entre execuções diferentes de um workflow, há uma solução poderosa e extremamente prática: o Community Node
n8n-nodes-globals.Este nó permite que você crie variáveis globais persistentes, salvando informações diretamente no banco de credenciais do N8N. Com isso, você passa a contar com um mecanismo de armazenamento leve, rápido e sempre acessível, ideal para guardar configurações, tokens, estados ou resultados intermediários — sem depender de integrações externas como Redis, Firestore, Baserow ou Notion.
O que é o Node n8n-nodes-globals?
Esse Community Node foi desenvolvido para estender as capacidades nativas do N8N, permitindo que o usuário:
- Salve informações globais durante a execução de qualquer workflow;
- Recupere esses dados posteriormente em outras execuções;
- Gerencie chaves e valores persistentes como se estivesse lidando com um mini banco de variáveis globais;
- Tudo isso de forma segura, encapsulada no sistema de credenciais do próprio N8N.
Link direto para o pacote no NPM:
Repositório oficial no GitHub:
Principais Casos de Uso para Variáveis Globais no N8N
Esse recurso é extremamente útil para cenários onde manter o estado entre execuções é essencial. Exemplos práticos:
🔑 Armazenamento de tokens ou chaves temporárias
Em integrações que exigem autenticação dinâmica, como OAuth2, você pode guardar tokens e resgatá-los sem reautenticar a cada execução.
📊 Contadores, status e flags entre execuções
Ideal para workflows que precisam controlar quantidade de execuções, versões de publicação, status de sincronização ou qualquer outro tipo de controle de estado.
📁 Dados temporários para múltiplos fluxos
Se você tem vários workflows interdependentes, pode usar variáveis globais como ponte de comunicação entre eles — sem precisar usar webhooks intermediários ou arquivos externos.
🧩 Configurações reutilizáveis
Salve parâmetros padrão (como ID de planilha, e-mail de disparo, tempo de delay) e reutilize em múltiplos fluxos sem duplicação.
Como Instalar o Node n8n-nodes-globals
A instalação deve ser feita no seu ambiente N8N self-hosted.
Execute o seguinte comando no terminal onde seu ambiente N8N está rodando:
npm install n8n-nodes-globals
Importante: Certifique-se de que seu ambiente permite a instalação de community nodes. Para isso, adicione ou verifique a seguinte linha no seu .env:
N8N_DISABLE_PRODUCTION_MAIN_MENU=true
Após a instalação, reinicie o N8N e o novo node estará disponível na interface com o nome:
Globals - Get e Globals - Set
Como Usar o Node na Prática
✅ 1. Salvando Dados com o Node “Globals - Set”
Esse nó permite que você salve um valor na estrutura de credenciais do N8N. Os campos obrigatórios são:
- Key: nome único da variável;
- Value: valor que deseja salvar (pode ser string, número, JSON, etc).
Exemplo:
{ "key": "api_token_google", "value": "ya29.a0AfH6SMBx8xxJ9..." }
Você pode definir isso manualmente ou dinamicamente via expressão.
🔄 2. Recuperando Dados com o Node “Globals - Get”
Este nó faz a leitura do valor salvo anteriormente, bastando que você informe o nome da chave.
Exemplo:
{ "key": "api_token_google" }
A saída será o valor associado, pronto para ser utilizado em qualquer etapa do fluxo.
Boas Práticas e Considerações Técnicas
- Evite nomes genéricos para as chaves: use nomes descritivos e com prefixo se necessário (
projectA_token,clientX_flagetc.);
- Não armazene dados sensíveis sem criptografia, mesmo no banco de credenciais;
- Utilize em conjunto com o node “IF” e “Switch” para tomar decisões baseadas no valor global;
- Use para compartilhar contexto entre workflows paralelos, criando uma lógica distribuída de estado no seu ambiente N8N.
Conclusão Estratégica: Variáveis Globais são o Elo Faltante da Arquitetura N8N
Ao adicionar o node
n8n-nodes-globals ao seu ambiente, você desbloqueia um novo nível de controle, persistência e inteligência nos seus fluxos automatizados.Trata-se de uma solução nativa, segura, altamente flexível e totalmente integrada ao ecossistema N8N — ideal para quem busca autonomia de dados sem depender de bancos externos.
Mateus Celestino Pro recomenda:
Se você quer orquestrar automações mais robustas, manter o estado entre execuções e criar fluxos verdadeiramente reativos e dinâmicos, a instalação deste node é obrigatória.
Explore mais sobre a ferramenta nos repositórios oficiais, estude a documentação e experimente agora mesmo o poder das variáveis globais persistentes no N8N.
Autor do artigo
Sou formado em Marketing Digital por uma das principais faculdades do Brasil, com carreira construída unindo tecnologia, automação e estratégia digital.
Apaixonado por inovação, me especializei em T.I. e automação de marketing com inteligência artificial, criando soluções que ajudam empresas a vender mais, automatizar processos e crescer com eficiência.
Atuo como empreendedor digital, desenvolvendo sistemas completos com foco em automação de vendas, atendimento inteligente via WhatsApp e integração de ferramentas modernas com IA.
Minha missão é transformar ideias em sistemas inteligentes que funcionam de forma autônoma, liberando tempo e energia para que você possa focar no que realmente importa: o crescimento do seu negócio.
Made with Bullet