Package Information
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