Registrácia
Registrácia
← Všetky návody

Automatizácia Collabin s n8n: oficiálny community node

Publikované: 14. júna 2026

n8n-nodes-collabin je oficiálny n8n community node pre Collabin, open source na GitHube. Zabaľuje REST API a webhooky, ktoré by ste inak volali ručne, do uzlov pripravených na použitie: čítajte a správajte používateľov, tímy, typy dovoleniek, žiadosti o dovolenku a kalendár, reagujte okamžite na udalosti dovoleniek s vstavanou verifikáciou podpisu a celé to dokonca odovzdajte AI agentovi ako nástroj. Tento návod node nainštaluje, pripojí k vášmu kontu a prejde oboma uzlami od začiatku do konca.

Čo obsahuje balík

PoložkaTypNa čo slúži
CollabinAction nodeČítanie a správa používateľov, tímov, typov dovoleniek, žiadostí o dovolenku a kalendára cez API /v1. Možno použiť aj ako nástroj v uzle AI Agent.
Collabin TriggerTrigger nodeSpustí workflow, keď Collabin pošle webhook (leave.created, leave.status_changed) — overí za vás hlavičku X-Collabin-Signature.
Collabin APICredentialsUchováva váš API klúč a základnú URL adresu API, používanú oboma uzlami.

Čo budete potrebovať

  • Konto Collabin v pláne Pro — externé API a webhooky sú funkcie Pro.
  • Oprávnenie Admin alebo Superadmin na vygenerovanie API klúča a (pre trigger) vytvorenie webhooku.
  • Self-hosted instanciu n8n alebo plán n8n Cloud, ktorý umožňuje instalovať community nodes — ak si nie ste istí, pozrite si dokumentáciu n8n o community nodes.

Krok 1: Nainštalujte node

  1. V n8n prejdite na Settings → Community Nodes → Install.
  2. Zadajte n8n-nodes-collabin a potvrďte.
  3. Collabin a Collabin Trigger sa objavia v paneli uzlov.

Krok 2: Pripojte svoje konto Collabin

  1. V dashboarde Collabin prejdite na Settings → API Keys a vytvorte nový klúč. Vyberte Read, ak potrebujete iba čítať dáta, alebo Read & Write, ak chcete z n8n aj vytvárať žiadosti o dovolenku alebo ich schvaľovať/zamietať.
  2. Skopírujte klúč (clb_…) — zobrazí sa iba raz.
  3. Pridajte uzol Collabin (alebo Collabin Trigger) do workflow, otvorte rozbaľovaciu ponuku credentials a vytvorte nové credential Collabin API:
    • API Key: klúč z kroku 2.
    • Base URL: https://api.collabin.eu (predvolená hodnota — nechajte tak).
  4. Kliknite na Test. Úspešný test zavolá GET /v1/leave-types s vašim klúčom.

Krok 3: Čítajte a správajte dáta pomocou uzla Collabin

Uzol Collabin používa známy n8n vzor Resource → Operation:

ResourceOperationPoznámky
UserGet / Get ManyGet Many možno filtrovať podľa mena alebo e-mailu
UserGet LeavesŽiadosti o dovolenku používateľa, voliteľne filtrované podľa stavu
TeamGet / Get ManyZahŕňa vedúcich a členov tímu
Leave TypeGet ManyTypy dovoleniek vašej organizácie
LeaveGet / Get ManyFiltrovanie podľa používateľa, stavu, rozsahu dátumov alebo "updated since"
LeaveCreateNová žiadosť so stavom PENDING — vyžaduje klúč s právom na zápis
LeaveUpdate StatusSchválenie alebo zamietnutie žiadosti PENDING — vyžaduje klúč s právom na zápis
CalendarGetKalendár pracovných/sviatočných dní pre rozsah dátumov

Dve veci, ktoré stoja za zmienku:

  • Return All + Updated Since: zapnite Return All pri akejkoľvek operácii "Get Many" a uzol automaticky prejde celé API stránkovaním (500 záznamov na požiadavku), až dovtedy, kým nestiahne všetko. V kombinácii s filtrom Updated Since v Leave → Get Many je to základ inkrementálnej synchronizácie — Schedule Trigger spustený každú hodinu, ktorý stiahne iba zmeny od posledného behu.
  • Nástroj pre AI Agent: každá operácia je dostupná aj ako nástroj. Pridajte uzol Collabin medzi nástroje uzla AI Agent a agent bude vedieť odpovedať na otázky ako "Koľko dní dovolenky má Jane tento rok ešte k dispozícii?" — alebo, s klúčom s právom na zápis, vykonávať pokyny ako "schváľ Jane žiadosť o dovolenku na ďalší týždeň".

Krok 4: Reagujte na udalosti pomocou uzla Collabin Trigger

Ak ste čítali náš návod na webhooky n8n/Make, viete, že overenie hlavičky X-Collabin-Signature bežne znamená pridať Code node s logikou HMAC. Uzol Collabin Trigger to urobí za vás — žiadosti s neplatným alebo chýbajúcim podpisom sú odmietnuté kódom 401 ešte predtým, ako sa váš workflow vôbec spustí.

  1. Pridajte uzol Collabin Trigger do workflow a skopírujte jeho webhook URL.
  2. V dashboarde Collabin prejdite na Settings → Webhooks a vytvorte nový webhook:
    • URL: webhook URL z n8n z kroku 1.
    • Events: vyberte leave.created, leave.status_changed, alebo oboje.
  3. Collabin zobrazí signing secret iba raz — skopírujte ho do poľa Signing Secret uzla.
  4. V poli Events uzla vyberte rovnaké udalosti. Toto je lokálny filter: čokoľvek, čo Collabin pošle, ale tu nevyberiete, je potvrdené, ale nespustí workflow.

Aktivujte workflow, odošlite testovaciu žiadosť o dovolenku v Collabin a trigger sa spustí s celým objektom dovolenky — vrátane prepojeného používateľa a typu dovolenky — v poli data.

Príklady workflow

  • Notifikácie Slack/Teams — Collabin Trigger (leave.created) → uzol Slack alebo Microsoft Teams, takže manažéri okamžite vidia nové žiadosti.
  • Schvaľovanie odkiaľkoľvek — akýkoľvek trigger (príkaz Slack, formulár, chatbot) → uzol Collabin (Leave → Update Status), na schválenie alebo zamietnutie žiadosti PENDING bez otvárania Collabin.
  • Inkrementálna synchronizácia miezd — Schedule Trigger → uzol Collabin (Leave → Get Many, Updated Since = posledný beh, Return All) → odoslanie zmien do systému miezd alebo HRIS.
  • HR asistent — uzol Collabin ako nástroj AI Agent, takže chatový asistent môže na požiadanie zisťovať zostatky, tímy a čakajúce žiadosti.

Dobré vedieť

  • Požiadavka na plán: API /v1 aj webhooky vyžadujú plán Pro; ich volanie na neoprávnenom pláne vráti 403 Forbidden.
  • Limit požiadaviek: 120 požiadaviek za minútu na API klúč — pri veľkých exportoch je lepšie použiť Return All (väčšie stránky) než veľa malých požiadaviek.
  • Read vs. write: Create a Update Status potrebujú klúč Read & Write; všetko ostatné funguje s klúčom Read.
  • Kompatibilita: vyžaduje Node.js 20.15+ na instancii n8n — štandardná požiadavka aktuálnych verzií n8n.

Kam ďalej