BriefGate pro n8n

n8n-nodes-briefgate je komunitní node pro n8n, který zabaluje sběr podkladů BriefGate — založení intaku, čekání s upomínkami a čtení typovaných výsledků — do workflow nodů, nástroje pro AI Agent a triggeru na webhookové události BriefGate.

Node je podaný na n8n k ověření (verification) a zatím není ověřený — co to pro vás dnes znamená, viz Instalace na n8n Cloud níže.

Instalace

Self-hosted n8n:

  1. Přejděte na Settings → Community Nodes.
  2. Zvolte Install.
  3. Zadejte n8n-nodes-briefgate.
  4. Odsouhlaste upozornění na riziko (standardní hláška u každého neověřeného balíčku, ne specifická pro BriefGate) a zvolte Install.

Nebo z příkazové řádky, pokud si závislosti n8n instance spravujete sami:

bash
npm install n8n-nodes-briefgate

Oba nody i typ přihlašovacích údajů se objeví po restartu n8n (instalace přes Docker/npm) nebo hned (panel Community Nodes instaluje bez restartu).

Instalace na n8n Cloud

n8n Cloud umožňuje instalovat přímo z panelu Community Nodes jen ověřené komunitní nody (plán Starter a vyšší); neověřený node jako tento — dokud čeká na review — tam instalovat nejde. Dokud BriefGate node neprojde ověřením, používejte ho na self-hosted instanci n8n (Docker, npm nebo kterákoli z možností nasazení n8n). Jakmile bude ověřený, tahle stránka to bude říkat a node se objeví v panelu Cloudu jako každá jiná ověřená integrace.

Přihlašovací údaje: BriefGate API

Oba nody se autentizují BriefGate API klíčem.

  1. V dashboardu BriefGate otevřete API klíče a vytvořte klíč. Při stavbě workflow používejte klíč bg_test_… — chová se normálně, ale nikdy neposílá e-mail ani SMS reálnému klientovi; na bg_live_… přepněte, až budete jít do ostrého provozu.
  2. V n8n vytvořte nové přihlašovací údaje BriefGate API a vložte klíč do pole API Key. Base URL nechte na https://api.briefgate.dev, pokud nemíříte na staging nebo self-hosted nasazení BriefGate.
  3. Node BriefGate Trigger potřebuje konkrétně klíč se scope admin — registrace webhooku odebírá události za celý účet, intakes:read/intakes:write nestačí. Viz scope API klíčů.

Operace (node BriefGate)

Node BriefGate má jedno pole Operation s pěti volbami:

Operace Co dělá Klíčová pole
Create Intake Založí nový intake a pošle klientovi e-mail s odkazem na portál Project Name, Client Email, Client Name, Items (pevná pole nebo surové JSON), Additional Fields (rozvrh upomínek, termín, retence, složka, idempotency key…)
Get Many Vypíše intaky s volitelnými filtry Filtry: Status, Client Email, Folder ID, Search; Return All / Limit
Get Results Typované hodnoty schválených (volitelně i odeslaných-neschválených) položek Intake ID; Options: Only New, Include Pending
Get Status Stavy položek, historie upomínek a progres jednoho intaku Intake ID
Send Reminder Ručně spustí upomínku mimo automatický rozvrh Intake ID, Channel (Email/SMS)

Příklad — Create Intake

Položky lze poskládat polem Items (fixed collection s Key, Label, Type, Required, Assignee, Help Text a volitelným Advanced (JSON) pro constraints/options/schema), nebo přepnout Specify Items na Using JSON a vložit pole přímo:

json
[
  { "key": "logo", "label": "Company logo", "type": "image", "required": true },
  { "key": "colors", "label": "Brand colors", "type": "color_list", "required": false }
]

Nastavte Project Name na Bella Napoli — Website, Client Email/Client Name na údaje klienta a v Additional Fields nastavte Chase Schedule na Default a Due Date na 2026-12-01. Spuštěním nodu se klientovi pošle e-mail s odkazem na portál a vrátí se založený intake včetně id — to pošlete dál jako intakeId do Get Status / Get Results / Send Reminder.

Příklad — Get Results

Nastavte Intake ID na {{$json.id}} (z předchozího Create Intake nebo Trigger nodu) a v Options zapněte Include Pending, pokud chcete v odpovědi i odeslané, ale zatím neschválené položky. Node vrátí typované hodnoty podle klíče položky, podepsané URL souborů u file/image položek a pole missing s tím, co ještě chybí.

Příklad — Get Many

Nechte Filters prázdné pro výpis všech intaků, nebo nastavte Status na In Progress a Search na jméno klienta pro zúžení výběru. Zapněte Return All, pokud chcete projít všechny výsledky místo zastavení na Limit.

BriefGate jako nástroj pro AI Agent

Node BriefGate lze použít jako nástroj: připojte ho ke vstupu Tool nodu AI Agent stejně, jako byste připojili jakýkoli jiný n8n tool node. Agent ho vidí jako BriefGate se všemi pěti operacemi a sám se ze systémového promptu a konverzace rozhoduje, kdy zavolat Create Intake, zkontrolovat Get Status, nebo stáhnout Get Results. Jde o stejný případ použití, jaký pro Claude Code a další MCP klienty pokrývá MCP server BriefGate — jen vedený přes vlastního agenta v n8n.

Typické zapojení: node AI Agent s chat triggerem, node BriefGate připojený jako nástroj (s přihlašovacími údaji BriefGate API) a systémový prompt, který agentovi říká, kdy je úkol zablokovaný na něčem, co může dodat jen člověk na straně klienta (viz vlastní doporučení BriefGate k tomuto tématu — stejná logika platí, ať agent běží v n8n nebo v MCP klientovi).

BriefGate Trigger — webhookové události

Node BriefGate Trigger spustí workflow, jakmile na vašem účtu nastane některá z těchto událostí:

Vyberte jednu nebo více v poli Events (multi-select). Aktivace workflow zaregistruje na vašem účtu BriefGate webhookový endpoint mířící na webhookovou URL n8n; deaktivace workflow ho zase odstraní — na žádné straně není nic potřeba uklízet ručně. Každé doručení je před předáním workflow ověřeno proti hlavičce X-BriefGate-Signature BriefGate (HMAC-SHA256, 5minutové okno proti replay útoku). Přesný tvar payloadu pro každou událost je v webhooks.md.

Příklady workflow

Nový klient na jedno kliknutí. Formulář (Typeform, nebo n8n Form trigger) posbírá název projektu a e-mail klienta ve chvíli, kdy je v CRM obchod označen jako vyhraný → BriefGate: Create Intake s položkami, které tým vždy potřebuje na startu → hotovo. Klient dostane odkaz na portál e-mailem okamžitě.

Soubory samy přistanou na Drive. BriefGate Trigger čeká na intake.completed → BriefGate: Get Results načte typované hodnoty a podepsané URL souborů → node HTTP Request stáhne každý soubor → node Google Drive ho nahraje do složky projektu pojmenované podle klienta. Nikdo si nemusí pamatovat, že má soubory jít ručně posbírat.

Zeptejte se agenta, kdo vám ještě dluží podklady. Chat Trigger předá zprávu do nodu AI Agent (s OpenAI Chat Model a nodem BriefGate připojeným jako nástroj) — zeptejte se „kteří klienti mi ještě dluží podklady?" a agent zavolá Get Many pro seznam rozpracovaných intaků, pak Get Status na každý pro zjištění, co ještě chybí, a odpoví v chatu.

Tři šablony k rovnou naimportování postavené na těchto třech nápadech jsou na GitHubu.

Odkazy