Collabin automatizálása n8n-nel: a hivatalos community node

Az n8n-nodes-collabin a Collabin hivatalos n8n community node-ja, nyílt forráskóddal a GitHubon. A REST API-t és a webhookokat, amiket egyébként kézzel hívnál meg, kattintható node-okká csomagolja: lekérheted és kezelheted a felhasználókat, csapatokat, szabadságtípusokat, szabadságkérelmeket és a naptárat, azonnal reagálhatsz a szabadság-eseményekre beépített aláírás-ellenőrzéssel, és akár egy AI agentnek is átadhatod az egészet eszközként. Ez az útmutató telepíti, összeköti a fiókoddal, és végigveszi mindkét node-ot az elejétől a végéig.

Mi van a csomagban

Elem	Típus	Mire való
Collabin	Action node	Felhasználók, csapatok, szabadságtípusok, szabadságkérelmek és a naptár lekérése és kezelése a `/v1` API-n keresztül. Egy AI Agent node eszközeként is használható.
Collabin Trigger	Trigger node	Elindítja a workflow-t, amikor a Collabin webhookot küld (`leave.created`, `leave.status_changed`) — az `X-Collabin-Signature` fejlécet helyetted ellenőrzi.
Collabin API	Credentials	Az API-kulcsodat és az API base URL-t tárolja, ezt használja mindkét node.

Mire lesz szükséged

Collabin fiók Pro csomaggal — a külső API és a webhookok Pro funkciók.
Admin vagy Superadmin jogosultság az API-kulcs generálásához, és (a trigger esetén) a webhook létrehozásához.
Self-hosted n8n instance, vagy olyan n8n Cloud csomag, amely lehetővé teszi community node-ok telepítését — ha nem vagy biztos benne, nézd meg az n8n community node dokumentációját.

1. lépés: A node telepítése

Az n8n-ben menj a Settings → Community Nodes → Install menüpontra.
Írd be: n8n-nodes-collabin, majd erősítsd meg.
A Collabin és a Collabin Trigger node-ok megjelennek a node panelen.

2. lépés: Kapcsold össze a Collabin fiókoddal

A Collabin felületén nyisd meg a Settings → API Keys menüpontot, és hozz létre egy új kulcsot. Válassz Read-et, ha csak adatokat szeretnél lekérni, vagy Read & Write-ot, ha szabadságkérelmeket is létrehoznál vagy jóváhagynál/elutasítanál az n8n-ből.
Másold ki a kulcsot (clb_…) — csak egyszer jelenik meg.
Adj egy Collabin node-ot (vagy Collabin Trigger-t) egy workflow-hoz, nyisd meg a credential legördülőt, és hozz létre egy új Collabin API credentialt:
- API Key: a 2. lépésben kapott kulcs.
- Base URL: https://api.collabin.eu (alapérték — hagyd így).
Kattints a Test gombra. A sikeres teszt egy GET /v1/leave-types hívást küld a kulcsoddal.

3. lépés: Adatok lekérése és kezelése a Collabin node-dal

A Collabin node az n8n megszokott Resource → Operation mintáját követi:

Resource	Operation	Megjegyzés
User	Get / Get Many	A Get Many szűrhető névre vagy e-mailre
User	Get Leaves	Egy felhasználó szabadságkérelmei, opcionálisan státusz szerint szűrve
Team	Get / Get Many	Tartalmazza a csapatvezetőket és a tagokat
Leave Type	Get Many	A szervezeted szabadságtípusai
Leave	Get / Get Many	Szűrés felhasználó, státusz, dátumtartomány vagy „updated since" szerint
Leave	Create	Új kérelem, `PENDING` státusszal — írási kulcs szükséges
Leave	Update Status	Egy `PENDING` kérelem jóváhagyása vagy elutasítása — írási kulcs szükséges
Calendar	Get	Munkanap/ünnepnap naptár egy dátumtartományra

Két dolog, amit érdemes ismerni:

Return All + Updated Since: kapcsold be a Return All-t bármelyik "Get Many" operációnál, és a node automatikusan lapoz az API-n (500 rekord kérésenként), amíg minden adat le nem töltődik. A Leave → Get Many Updated Since szűrőjével kombinálva ez az inkrementális szinkronizálás alapja — egy óránként futó Schedule Trigger, amely csak az utolsó futás óta változott adatokat tölti le.
AI Agent eszköz: minden operáció eszközként is elérhető. Add hozzá a Collabin node-ot egy AI Agent node eszközei közé, és az agent válaszolhat olyan kérdésekre, mint „Hány szabadnapja van még Jane-nek idén?" — vagy, írási kulccsal, végrehajthat utasításokat, mint „hagyd jóvá Jane jövő heti szabadságkérelmét."

4. lépés: Reagálás eseményekre a Collabin Trigger node-dal

Ha olvastad az n8n/Make webhook útmutatónkat, tudod, hogy az X-Collabin-Signature fejléc ellenőrzése normál esetben egy Code node-ot és némi HMAC-logikát jelent. A Collabin Trigger node ezt elvégzi helyetted — az érvénytelen vagy hiányzó aláírásokat 401-gyel elutasítja, még mielőtt a workflow-d elindulna.

Adj egy Collabin Trigger node-ot egy workflow-hoz, és másold ki a webhook URL-jét.
A Collabin felületén nyisd meg a Settings → Webhooks menüpontot, és hozz létre egy új webhookot:
- URL: az 1. lépésben kapott n8n webhook URL.
- Events: válaszd ki a leave.created, leave.status_changed eseményeket, vagy mindkettőt.
A Collabin egyszer megmutatja a signing secret-et — másold be a node Signing Secret mezőjébe.
A node Events mezőjében válaszd ki ugyanazokat az eseményeket. Ez egy lokális szűrő: amit a Collabin elküld, de itt nem választottál ki, azt a node nyugtázza, de a workflow nem indul el rá.

Aktiváld a workflow-t, adj be egy próba-szabadságkérelmet a Collabinban, és a trigger elindul a teljes szabadság-objektummal — a hozzá kapcsolt user és leave type adatokkal együtt — a data mezőben.

Példa workflow-k

Slack/Teams értesítések — Collabin Trigger (leave.created) → egy Slack vagy Microsoft Teams node, így a vezetők azonnal látják az új kérelmeket.
Jóváhagyás bárhonnan — bármilyen trigger (Slack parancs, űrlap, chatbot) → Collabin node (Leave → Update Status), hogy jóváhagyj vagy elutasíts egy PENDING kérelmet a Collabin megnyitása nélkül.
Inkrementális bérszámfejtési szinkron — Schedule Trigger → Collabin node (Leave → Get Many, Updated Since = utolsó futás, Return All) → változások továbbítása a bérszámfejtő vagy HR-rendszerbe.
HR asszisztens — Collabin node AI Agent eszközként, hogy egy chat-alapú asszisztens igény szerint lekérhessen egyenlegeket, csapatokat és függő kérelmeket.

Jó tudni

Csomagkövetelmény: a /v1 API és a webhookok is Pro csomagot igényelnek; nem jogosult csomagon 403 Forbidden-t adnak vissza.
Rate limit: percenkénti 120 kérés API-kulcsonként — nagy exportoknál a Return All (nagyobb lapok) jobb, mint sok kis kérés.
Read vs. write: a Create és az Update Status Read & Write kulcsot igényel; minden más Read kulccsal is működik.
Kompatibilitás: az n8n instance-on Node.js 20.15+ szükséges — ez a jelenlegi n8n verziók szokásos követelménye.

Merre tovább

n8n-nodes-collabin az npm-en és forráskód a GitHubon — issue-k és contributionök szívesen látottak.
Most ismerkedsz az API-val? Kezdd a REST API gyorstalpalóval.
Egyszerűbb webhook-megoldást szeretnél community node telepítése nélkül? Nézd meg a kód nélküli automatizálást n8n-nel és Make-kel.