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.

Je to ověřený (verified) komunitní node n8n: na n8n Cloud ho přidáte přímo z plátna a na self-hosted n8n ho nainstalujete stejně, nebo podle názvu balíčku — viz Instalace níže.

Instalace

Instalace na n8n Cloud

  1. Ověřte, že je v Admin Panelu vaší instance zapnutá volba Verified Community Nodes (zapnout ji může vlastník nebo admin).
  2. Na plátně workflow otevřete panel nodů, vyhledejte BriefGate a přetáhněte node do workflow.

Pokud se node ve vyhledávání ještě neobjeví, restartujte instanci z Admin Panelu — n8n Cloud nově ověřené nody načte po restartu.

Instalace na self-hosted n8n

Ověřené nody se ve vyhledávání na plátně objeví i na self-hosted n8n, pokud máte ověřené komunitní nody na instanci povolené. Nebo node nainstalujte podle názvu balíčku:

  1. Přejděte na Settings → Community Nodes.
  2. Zvolte Install.
  3. Zadejte n8n-nodes-briefgate.
  4. Odsouhlaste upozornění na riziko (n8n ho zobrazuje u každého balíčku instalovaného podle názvu, není 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).

Self-hosted a data residency. Provoz vlastního n8n už sám o sobě drží logiku workflow i přihlašovací údaje na infrastruktuře, kterou máte pod kontrolou. Hostovaná API BriefGate na to navazuje: podle dokumentace ke GDPR se veškerá data zpracovávají výhradně v EU — hosting aplikace v Německu, úložiště souborů v Cloudflare R2 s omezením na jurisdikci EU. Dobré vědět, pokud je data residency důvodem, proč si n8n hostujete sami; není to ale samo o sobě důvod, proč zvolit zrovna BriefGate.

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), webhook z CRM (obchod označený jako vyhraný), nebo obyčejný node Webhook přivede do BriefGate: Create Intake název projektu, e-mail a jméno klienta, plus položky, které tým vždy potřebuje na startu — třeba logo (Image), hero_copy (Long Text), wp_admin (Secret). Spuštěním nodu se klientovi ihned e-mailem pošle odkaz na portál a vrátí se id intaku, které pak jako intakeId potřebuje každé z dalších workflow níže. Pokud je spouštěčem webhook, nastavte Additional Fields → Idempotency Key na něco stabilního ze zdrojové události (třeba ID obchodu v CRM): CRM a formulářové služby doručení opakují, a bez idempotency key vytvoří opakované doručení druhý intake pro stejného klienta — opětovné použití stejného klíče místo toho vrátí ten původní.

Soubory samy přistanou ve vašem úložišti. BriefGate Trigger (Intake Completed) → BriefGate: Get Results → jeden node na soubor. Get Results vrátí typované hodnoty podle klíče položky: souborová nebo obrázková položka se vrátí jako { url, filename, mime, size, checksum_sha256 } s 24hodinovou podepsanou URL, textová položka jako prostá hodnota — odkazujte se na klíče, které jste si sami definovali (results.logo.url, results.hero_copy), místo procházení neznámého tvaru dat. Podepsanou URL souboru pošlete do nodu HTTP Request nastaveného na vrácení binárních dat, pak ji zapište nodem Write Binary File, nodem Google Drive, nebo S3/MinIO nodem. Položka typu secret (přihlašovací údaje k adminu, API klíč) vyžaduje ke čtení API klíč se scope secrets:read nebo admin a její hodnota se vrátí přesně jednou — uložte ji ve chvíli, kdy tohle workflow proběhne, protože každé další volání pak už jen hlásí secret_unavailable: true. Nechte tenhle Zap okamžitý místo dávkování — podepsaná URL platí jen 24 hodin.

Zjistěte, kdo vám ještě dluží podklady. Dva způsoby, podle toho, jestli to chcete mít posílané, nebo vyžádané na požádání. Posílané: Schedule Trigger (např. pracovní dny v 08:00) → Get Many (Status: In Progress, Return All: zapnuto) → smyčka s Get Status na každý intake → Filter, který ponechá progress.outstanding > 0 → odeslání seznamu do Slacku nebo e-mailem. Get Status je pro tenhle krok odlehčený endpoint — stavy položek, historie upomínek a počet outstanding bez stahování obsahu souborů, což dělá jeho volání jednou na intake v rámci rozvrhu rozumným, ne nákladným. Na požádání: připojte node BriefGate do vstupu Tool u nodu AI Agent (viz výše) a prostě se zeptejte — „kteří klienti mi ještě dluží podklady?" — a nechte agenta zavolat Get Many a Get Status samotného.

Intake po termínu dostane cílenou upomínku. intake.overdue se spustí jednou, poprvé, kdy si pravidelný sweep všimne, že intake překročil termín a povinná položka pořád chybí — nezávisle na automatickém rozvrhu upomínek, a je určený k informování vás, ne klienta. BriefGate Trigger (Intake Overdue) → BriefGate: Send Reminder (Channel: Email nebo SMS, to druhé vyžaduje funkci sms a kladný zůstatek kreditu) z toho udělá skutečně odeslanou zprávu. intake.stalled se ke stejnému vzoru hodí stejně dobře — spustí se ve chvíli, kdy dojde limit upomínek a chase engine zbylé zruší a předá intake zpátky vám — přidejte ho vedle Intake Overdue do pole Events triggeru, pokud chcete eskalovat i v tomhle bodě.

Každý payload událostí výše nese intake_id a všechny kromě chase.bounced i project_name — žádná z nich nenese e-mailovou adresu klienta samotného, záměrně, protože execution log workflow má širší publikum než samotný intake. chase.bounced je výjimkou, protože jeho smyslem je právě pojmenovat, která adresa recipient selhala. Pro cokoli dalšího o klientovi volejte Get Status nebo Get Results, místo abyste čekali, že to ponese payload triggeru. Kompletní seznam polí pro všech šest událostí je v webhooks.md.

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

Odkazy