n8n-nodes-gilgal

Nós do n8n pro Gilgal — a memória do seu negócio. Com eles, qualquer
um dos milhares de apps do n8n vira canal de entrada (ou de consulta) do seu cérebro,
sem escrever uma linha de código.

O que o nó faz

Ingestão (requer chave com can_ingest):

• Enviar texto — ata, e-mail, nota → memória.
• Enviar mensagem de chat — canal de conversa com janela: o diálogo
  inteiro vira uma memória só.
• Enviar transcrição de reunião — Fireflies, tl;dv, MeetGeek…
• Enviar formulário/lead — Google Forms, Typeform, site.
• Enviar planilha/tabela — cada linha vira fato carimbado na hora (sem IA).
• Enviar payload cru — qualquer ingestor pelo slug (inclusive os seus).

Memória:

• Perguntar — resposta sintetizada com fontes.
• Buscar fatos — série de fatos vigentes (sem IA).

Instalação

Publicado no npm desde 09/09/2026. No n8n self-hosted:
Settings → Community Nodes → Install e digite n8n-nodes-gilgal. É o caminho normal.

O nó aparece como Gilgal, tipo interno n8n-nodes-gilgal.gilgal. Se o Gilgal roda no
host e o n8n em Docker, use http://host.docker.internal:8790 como URL na credencial.

npm run build   # nesta pasta
docker cp dist/credentials SEU_N8N:/home/node/.n8n/custom/credentials
docker cp dist/nodes       SEU_N8N:/home/node/.n8n/custom/nodes
docker exec -u root SEU_N8N chown -R node:node /home/node/.n8n/custom
docker restart SEU_N8N

Publicar uma versão nova

A autenticação do npm é a sessão gravada pelo npm login, que abre o navegador e guarda o
token em ~/.npmrc — não é preciso token em variável de ambiente. O que o npm exige na
hora do publish é o segundo fator:

npm version patch          # ou minor/major
npm run build
npm publish --access public --otp=CODIGO

Se a conta ainda não tiver 2FA, o publish falha com um 403 que fala em "granular access
token with bypass 2fa" — a leitura correta desse erro é ative o 2FA, não crie um token.
Confira com npm profile get, que mostra two-factor auth.

O build copia o SVG do ícone com um script Node (scripts/copiar-icone.mjs) e não com
cp: o publish costuma sair de uma máquina Windows, onde mkdir -p && cp falham no cmd e
o pacote iria pro npm sem ícone, sem erro nenhum.

Credencial

Gilgal API: a URL do seu Gilgal (sem /v1) + a chave glg_... gerada no painel em
Conectar → chaves do cérebro. O botão de testar credencial lista os ingestores.

Importante: pro bot LER o cérebro (Perguntar/Buscar fatos), convide-o em Acesso
marcando "Todas as áreas (acesso total)" — é o recomendado pra integrações. Sem isso,
o escopo por área (fail-closed) esconde o conteúdo que entra em modo livre.

Receitas prontas

• Fireflies → Gilgal: Webhook (Fireflies) → GraphQL (busca o transcript) → Gilgal:
  Enviar transcrição de reunião.
• Google Forms → Gilgal: Form Trigger → Gilgal: Enviar formulário/lead (mapeie os
  campos no JSON).
• Planilha Google → Gilgal: Google Sheets Trigger → Gilgal: Enviar planilha/tabela
  (linhas em JSON) — preços viram fatos sem IA.
• Telegram → Gilgal: Telegram Trigger → Gilgal: Enviar mensagem de chat (canal
  telegram, id do chat, quem falou, texto) — janela de conversa incluída.
• Responder no n8n com a memória: qualquer fluxo → Gilgal: Perguntar → manda a
  resposta (com fontes) pra onde quiser.

Mais contexto: INGESTORES.md e CASOS.md na raiz do repo.