n8n-nodes-collabin to oficjalny węzeł community n8n dla Collabin, open source na GitHubie. Pakuje REST API i webhooki, które inaczej musiałbyś wywoływać ręcznie, w gotowe do użycia węzły: odczytuj i zarządzaj użytkownikami, zespołami, typami urlopów, wnioskami urlopowymi i kalendarzem, reaguj natychmiast na zdarzenia urlopowe z wbudowaną weryfikacją podpisu, a nawet przekaż to wszystko agentowi AI jako narzędzie. Ten przewodnik instaluje węzeł, łączy go z Twoim kontem i przeprowadza przez obsługę obu węzłów od początku do końca.
Co zawiera pakiet
| Element | Typ | Co robi |
|---|---|---|
| Collabin | Action node | Odczyt i zarządzanie użytkownikami, zespołami, typami urlopów, wnioskami urlopowymi i kalendarzem przez API /v1. Może być też używany jako narzędzie przez węzeł AI Agent. |
| Collabin Trigger | Trigger node | Uruchamia workflow, gdy Collabin wysyła webhook (leave.created, leave.status_changed) — weryfikuje za Ciebie nagłówek X-Collabin-Signature. |
| Collabin API | Credentials | Przechowuje Twój klucz API i bazowy URL API, używany przez oba węzły. |
Czego będziesz potrzebować
- Konto Collabin w planie Pro — zewnętrzne API i webhooki to funkcje Pro.
- Uprawnienia Admin lub Superadmin, aby wygenerować klucz API i (dla triggera) utworzyć webhook.
- Self-hosted instancja n8n lub plan n8n Cloud umożliwiający instalację węzłów community — jeśli nie jesteś pewien, zajrzyj do dokumentacji n8n o węzłach community.
Krok 1: Zainstaluj węzeł
- W n8n przejdź do Settings → Community Nodes → Install.
- Wpisz
n8n-nodes-collabini potwierdź. - Collabin i Collabin Trigger pojawią się w panelu węzłów.
Krok 2: Połącz swoje konto Collabin
- W panelu Collabin przejdź do Settings → API Keys i utwórz nowy klucz. Wybierz Read, jeśli potrzebujesz tylko pobierać dane, albo Read & Write, jeśli chcesz też tworzyć wnioski urlopowe lub je zatwierdzać/odrzucać z n8n.
- Skopiuj klucz (
clb_…) — jest wyświetlany tylko raz. - Dodaj węzeł Collabin (lub Collabin Trigger) do workflow, otwórz listę credentials i utwórz nowe credential Collabin API:
- API Key: klucz z kroku 2.
- Base URL:
https://api.collabin.eu(wartość domyślna — zostaw bez zmian).
- Kliknij Test. Pomyślny test wywołuje
GET /v1/leave-typesz Twoim kluczem.
Krok 3: Odczytuj i zarządzaj danymi za pomocą węzła Collabin
Węzeł Collabin korzysta ze znanego z n8n schematu Resource → Operation:
| Resource | Operation | Uwagi |
|---|---|---|
| User | Get / Get Many | Get Many można filtrować po nazwie lub e-mailu |
| User | Get Leaves | Wnioski urlopowe użytkownika, opcjonalnie filtrowane po statusie |
| Team | Get / Get Many | Zawiera liderów i członków zespołu |
| Leave Type | Get Many | Kategorie urlopów w Twojej organizacji |
| Leave | Get / Get Many | Filtrowanie po użytkowniku, statusie, zakresie dat lub "updated since" |
| Leave | Create | Nowy wniosek ze statusem PENDING — wymaga klucza z prawem zapisu |
| Leave | Update Status | Zatwierdzenie lub odrzucenie wniosku PENDING — wymaga klucza z prawem zapisu |
| Calendar | Get | Kalendarz dni roboczych/świątecznych dla zakresu dat |
Dwie rzeczy, o których warto wiedzieć:
- Return All + Updated Since: włącz Return All dla każdej operacji "Get Many", a węzeł automatycznie przejdzie przez wszystkie strony API (500 rekordów na żądanie), aż pobierze wszystkie dane. W połączeniu z filtrem Updated Since w Leave → Get Many to podstawa synchronizacji przyrostowej — Schedule Trigger uruchamiany co godzinę, który pobiera tylko zmiany od ostatniego uruchomienia.
- Narzędzie dla AI Agent: każda operacja jest też dostępna jako narzędzie. Dodaj węzeł Collabin do narzędzi węzła AI Agent, a agent będzie mógł odpowiadać na pytania typu "Ile dni urlopu zostało Jane w tym roku?" — lub, z kluczem z prawem zapisu, wykonywać polecenia takie jak "zatwierdź wniosek urlopowy Jane na następny tydzień".
Krok 4: Reaguj na zdarzenia za pomocą węzła Collabin Trigger
Jeśli czytałeś nasz przewodnik o webhookach n8n/Make, wiesz, że weryfikacja nagłówka X-Collabin-Signature normalnie wymaga dodania węzła Code z logiką HMAC. Węzeł Collabin Trigger robi to za Ciebie — żądania z nieprawidłowym lub brakującym podpisem są odrzucane kodem 401, zanim Twój workflow w ogóle się uruchomi.
- Dodaj węzeł Collabin Trigger do workflow i skopiuj jego URL webhooka.
- W panelu Collabin przejdź do Settings → Webhooks i utwórz nowy webhook:
- URL: URL webhooka n8n z kroku 1.
- Events: wybierz
leave.created,leave.status_changedlub obie wartości.
- Collabin pokaże signing secret tylko raz — skopiuj go do pola Signing Secret w węźle.
- W polu Events węzła wybierz te same zdarzenia. To lokalny filtr: wszystko, co Collabin wyśle, a czego tu nie wybrano, zostanie potwierdzone, ale nie uruchomi workflow.
Aktywuj workflow, wyślij testowy wniosek urlopowy w Collabin, a trigger uruchomi się z pełnym obiektem urlopu — wraz z powiązanym użytkownikiem i typem urlopu — w polu data.
Przykładowe workflow
- Powiadomienia Slack/Teams — Collabin Trigger (
leave.created) → węzeł Slack lub Microsoft Teams, dzięki czemu menedżerowie natychmiast widzą nowe wnioski. - Zatwierdzanie z dowolnego miejsca — dowolny trigger (komenda Slack, formularz, chatbot) → węzeł Collabin (Leave → Update Status), aby zatwierdzić lub odrzucić wniosek
PENDINGbez otwierania Collabin. - Przyrostowa synchronizacja płacowa — Schedule Trigger → węzeł Collabin (Leave → Get Many, Updated Since = ostatnie uruchomienie, Return All) → przekazywanie zmian do systemu płacowego lub HRIS.
- Asystent HR — węzeł Collabin jako narzędzie AI Agent, dzięki czemu asystent czatowy może na żądanie sprawdzać salda, zespoły i oczekujące wnioski.
Warto wiedzieć
- Wymagany plan: API
/v1i webhooki wymagają planu Pro; wywołanie ich na nieuprawnionym planie zwraca403 Forbidden. - Limit żądań: 120 żądań na minutę na klucz API — przy dużych eksportach lepiej użyć Return All (większe strony) niż wielu małych żądań.
- Read vs. write: Create i Update Status wymagają klucza Read & Write; wszystko inne działa z kluczem Read.
- Kompatybilność: wymaga Node.js 20.15+ na instancji n8n — standardowy wymóg aktualnych wersji n8n.
Co dalej
- n8n-nodes-collabin na npm oraz kod źródłowy na GitHubie — issues i contributions są mile widziane.
- Zaczynasz od API? Zacznij od REST API quickstart.
- Wolisz prostsze rozwiązanie webhooków bez instalowania węzła community? Zobacz automatyzacje no-code z n8n i Make.