portal

Portal: envia dados de um caminho e recebe em outro sem fio, e dispara outros workflows pelo Portal Trigger

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0

Documentation

n8n-nodes-portal

Dois nodes que trabalham juntos:

  • Portal: envia dados de um caminho do workflow e recebe em outro sem fio. Também chama outros workflows pelo nome do canal.
  • Portal Trigger: escuta um canal e dispara o workflow quando um Portal envia algo pra ele.
Mesmo workflow:     0 → A → 📤 Portal "cliente" → C
                    0 → B → 📥 Portal "cliente" → C      ← B recebe os dados do A

Outros workflows:   Cadastro … → 📤 Portal "novo-cliente" ⚡⏳ → …
                                        ├→ ⚡ Portal Trigger "novo-cliente" (Score)
                                        └→ ⚡ Portal Trigger "novo-cliente" (CRM)

Instalar

No n8n, vá em Settings → Community Nodes → Install e digite n8n-nodes-portal.

Portal no mesmo workflow

Coloque um Portal no modo Send onde os dados existem e outro no modo Receive onde você precisa deles, com o mesmo Channel. O caminho que envia precisa rodar antes: com a ordem de execução v1, deixe ele mais acima no canvas.

Send: manda todos os campos ou só alguns (id, cliente.cpf as cpf). Os itens passam pelo Send sem mudar. Append junta vários envios (útil em loop).

Receive:

Output O que sai
Add First Item to Each Item Cada item ganha os campos do 1º item do portal (na raiz ou em Put In Field)
Add All Items as a List Cada item ganha uma lista com todos os itens do portal
Only Portal Items Sai só o que veio do portal

Chamar outros workflows (Portal Trigger)

Funciona como um sub-workflow, mas é usado como as tools do MCP:

  • Cada workflow com Portal Trigger escuta um canal e tem uma descrição.
  • No Portal, o campo Channel → From List mostra os canais ativos, quantos workflows escutam cada um e o que eles fazem.
  • Um envio cai em todos os workflows que escutam o canal ao mesmo tempo.
  • Um workflow pode ter vários Portal Triggers, um por canal.

No Portal (modo Send), em Portal Triggers:

Opção O que faz
Don’t Call Só guarda pro Portal Receive do mesmo workflow
Call and Continue ⚡ Dispara os workflows e segue sem esperar
Call and Wait for Response ⚡⏳ Dispara os workflows e espera todos responderem. A resposta é a saída do último node de cada um, igual a um sub-workflow

Com Wait, dá pra soltar só as respostas ou colocar elas num campo de cada item (resposta: [{ workflow, items }]). Se algum workflow chamado falhar ou passar do Timeout, o Portal para com erro dizendo qual foi.

O Portal Trigger adiciona _portal em cada item com o canal, o workflow, a execução e o node que enviou. Ele também conta os saltos pra barrar loop (workflow A chama B, que chama A…) depois de 10 chamadas em cadeia.

Limites

  • O Portal Trigger só dispara com o workflow ativo. Em teste manual, clique em escutar no trigger, como no Webhook.
  • Funciona com o n8n rodando em um processo só (o normal no Docker). Em queue mode, com workers separados, os avisos não atravessam de um processo pro outro.
  • Nada fica guardado em fila: se o n8n reiniciar no momento do envio, aquele disparo se perde.
  • O portal dentro do mesmo workflow só vale na mesma execução.

Build

npm install
npm run build

Discussion