HR

Jak podłączyć AI do HiBob, Factorial i BambooHR, żeby kadry w firmie z zagranicznym zespołem działały same?

HiBob, Factorial i BambooHR mają REST API. Podłączcie AI, żeby pilnowało umów, odpowiadało na pytania o urlop i przygotowało onboarding, zanim nowa osoba pojawi się w biurze.

⏱ 9 min czytania · 📅 20.11.2026 · 👁 64 wyświetleń

Tak, da się podłączyć AI do każdego z tych systemów przez REST API i zautomatyzować to, co teraz zajmuje kadrowej kilka godzin tygodniowo: pilnowanie kończących się umów i badań lekarskich, odpowiadanie pracownikom na pytania o urlop, przygotowanie onboardingu nowej osoby. Każdy z tych systemów udostępnia udokumentowane API z kluczem dostępu, więc nie potrzebujecie zgody producenta ani kosztownej integracji na zamówienie. Firma z polskim i zagranicznym zespołem zyska na tym szczególnie: różne zasady urlopowe w różnych krajach, dokumenty w kilku językach i kilka kalendarzy świąt przestają być źródłem ręcznej pracy.

Co boli najbardziej, gdy firma zatrudnia w kilku krajach

Polska spółka z pracownikami w Niemczech, Czechach albo na Ukrainie szybko odkrywa, że każdy kraj ma swoje zasady urlopowe, inne stawki godzinowe i inne wymagania dokumentacyjne. W HiBob widać to wyraźnie: każdy pracownik ma w polu work.location kraj zatrudnienia, a do tego odrębną politykę urlopową przypiętą do tej lokalizacji. Ktoś musi pilnować, żeby te polityki były aktualne i żeby pracownicy dostawali informację we właściwym języku.

Realne problemy z biura: pracownik pyta przez Teams, ile mu zostało urlopu przed końcem roku. Kadrowa otwiera HiBob, szuka osoby, sprawdza saldo w sekcji Time Off > Balance i odpisuje ręcznie. Mnożąc to przez kilkanaście osób miesięcznie, wychodzą godziny. Albo inny przypadek: ktoś zatrudniony na umowie na czas określony, której contract.endDate mija za sześć tygodni, a nikt w HR nie zauważył, bo nikt nie skonfigurował alertu.

Do tego dochodzą badania profilaktyczne. W Factorial każdy pracownik może mieć w polu medical_check_expires_on datę ważności badania. Jeśli to pole jest puste, to nie znaczy, że badanie jest ważne: to znaczy, że brakuje danych. AI musi to rozróżniać i braki wypisywać osobno.

Jak fizycznie wygląda podłączenie: API, klucze i ograniczenia

Wszystkie trzy systemy mają REST API z odpowiedzią w JSON. To ważne, bo oznacza, że każdy skrypt, narzędzie portalu albo agent AI może z nich korzystać bez specjalnego oprogramowania pośredniego.

BambooHR: API dostępne pod adresem api.bamboohr.com/api/gateway.php/{subdomain}/v1/. Klucz generujecie w Account Settings > API Keys. Uprawnienia read-only wystarczą do pobierania danych o pracownikach, urlopach i zadaniach onboardingowych. Uwierzytelnienie działa przez HTTP Basic Auth: klucz API jako nazwa użytkownika, hasło może być dowolnym ciągiem znaków (producent zaleca literę 'x'). Główne endpointy, z których korzystamy: GET /employees/directory, GET /time_off/requests, GET /time_off/whos_out, GET /employees/{id}/onboarding_tasks. Webhooki konfigurujecie w Account Settings > Webhooks: uruchamiają się przy zmianie statusu pracownika, nowym wniosku urlopowym albo zmianie dowolnego pola w profilu.

HiBob: API pod adresem api.hibob.com/v1/. Klucz tworzycie jako Service User w Settings > Integrations > API > Service Users. Nadajecie mu rolę Read Only, kopiujecie token i trzymacie w zaszyfrowanych ustawieniach narzędzia, nie w kodzie. Główne endpointy: GET /v1/people (pełna lista pracowników ze wszystkimi polami), GET /v1/timeoff/requests, GET /v1/documents, GET /v1/onboarding/newHires/tasks. HiBob ma webhooki w Settings > Integrations > Webhooks: uruchamiają się przy zmianie statusu pracownika, zatwierdzeniu wniosku urlopowego albo dodaniu dokumentu.

Factorial: API pod adresem api.factorialhr.com/api/2024-01/ (producent wersjonuje, sprawdzajcie aktualną wersję w dokumentacji). Personal Access Token generujecie w Settings > Integrations > API Keys. Endpointy: GET /api/2024-01/core/employees, GET /api/2024-01/time/leaves, GET /api/2024-01/core/contracts. Ważna uwaga: webhooki w Factorial są dostępne na planach Growth i wyżej. Na niższym planie trzeba odpytywać API cyklicznie, np. co godzinę.

Żaden z tych systemów nie udostępnia bezpośredniego dostępu do bazy danych. Producenci nie oferują połączeń SQL ani ODBC. Jedyną legalną drogą są API, eksporty CSV z panelu albo gotowe konektory w Zapierze albo Make (które pod spodem i tak korzystają z tych samych API). Eksport CSV przydaje się jako opcja zapasowa: można go zaciągnąć raz dziennie i przeszukiwać lokalnie, gdy trzeba raportować coś, do czego API nie ma gotowego endpointu.

Jakie konkretnie dane wyciągamy i do czego je dajemy AI

Z BambooHR bierzemy:

  • hireDate, terminationDate, employmentType: do raportowania rotacji i pilnowania umów
  • timeOffRequests: status wniosku, daty, rodzaj nieobecności, identyfikator pracownika
  • Pola niestandardowe (customFields), np. data ważności pozwolenia na pracę albo kategoria stanowiska: firma dodaje je samodzielnie w konfiguracji BambooHR i od razu są dostępne przez API
  • onboarding_tasks per pracownik: lista zadań z terminem, właścicielem i statusem

Z HiBob bierzemy:

  • work.startDate, work.contract.endDate, work.location, work.department, work.reportsTo
  • timeoff.requests i timeoff.balance: saldo urlopu per polityka urlopowa
  • documents: lista dokumentów, ich typy i daty ważności, np. zezwolenie na pracę z polem expiryDate
  • Sekcja onboarding.tasks: zadania przypisane do nowej osoby, właściciel zadania, termin, status

Z Factorial bierzemy:

  • employees: full_name, start_date, terminated_at, country, job_title
  • contracts: starts_on, ends_on, contract_type (np. "permanent" albo "temporary")
  • leaves: start_on, finish_on, leave_type_id, half_day

AI robi z tym trzy rzeczy: porównuje daty, odpowiada na pytania i generuje gotowe listy działań. Porównuje contract.endDate z dzisiejszą datą i wyciąga pracowników, których umowy kończą się w ciągu 30 i 60 dni. Sprawdza, czy przy każdej z tych osób jest zaplanowane badanie profilaktyczne. Patrzy na saldo urlopowe i flaguje osoby z dużą liczbą dni do wykorzystania przed końcem roku. Braki danych zawsze wypisuje osobno: puste pole to nie "wszystko w porządku".

Cztery zadania, które AI przejmuje od kadrowej

1. Odpowiedzi na pytania o urlop

Pracownik pisze przez chatbota portalu albo przez Teams: "Ile mi zostało urlopu?" AI ciągnie dane z timeoff.balance w HiBob albo z /time_off/requests w BambooHR, sprawdza aktualne saldo i otwarte wnioski, i odpowiada w ciągu sekund. Bez angażowania kadrowej. U jednego klienta, polskiej spółki z zespołem w Polsce i Niemczech, bot obsługuje kilkadziesiąt takich pytań miesięcznie. Wcześniej wszystkie trafiały do jednej osoby w HR przez Slacka.

2. Raport terminów: umowy, badania, dokumenty

Codziennie rano skrypt ciągnie listę pracowników, których contract.endDate albo data ważności pozwolenia na pracę wypada w ciągu 30 albo 60 dni. AI formatuje raport i wysyła go do menedżera HR. W raporcie: imię, stanowisko, kraj, liczba dni do wygaśnięcia, czy jest już otwarty wniosek o przedłużenie. Typowo wygląda to tak: o 7:30 w skrzynce menedżera pojawia się mail "Terminy na ten tydzień: 2 umowy na czas określony, 1 badanie profilaktyczne do odnowienia". Każda pozycja z linkiem do karty pracownika w systemie.

3. Raport rotacji i struktury zespołu

AI zestawia dane z hireDate, terminationDate i work.department, żeby pokazać, w których działach odejść było najwięcej, jak wygląda średni staż wśród nowo zatrudnionych i jak zmienia się proporcja lokalizacji w całym zespole. Nie po miesiącu pracy nad Excelem: po jednym zapytaniu.

4. Wykrywanie niekompletnych danych

Zdarza się, że pracownik ma uzupełniony startDate, ale brakuje work.location albo contract_type. AI przegląda bazę i wypisuje osoby z niekompletnymi profilami. Brak danych to nie zero: to informacja, że czegoś brakuje i ktoś powinien to uzupełnić przed następnym raportem.

Onboarding: co AI robi, zanim nowa osoba pojawi się w biurze

Gdy w HiBob pojawi się nowy pracownik ze statusem invited i startDate za dwa tygodnie, webhook informuje narzędzie. AI odczytuje profil tej osoby: kraj, dział, stanowisko, menedżer z pola reportsTo. Na tej podstawie dobiera właściwy szablon zadań onboardingowych.

Co dostaje menedżer? Wiadomość z listą zadań, które go dotyczą: "przygotuj laptop do piątku", "zaplanuj spotkanie wprowadzające na pierwszy wtorek", "dodaj do kanału #team-de na Slacku". Dział IT dostaje swoją część. HR dostaje przypomnienie o podpisaniu umowy i rejestracji w systemie ubezpieczeń społecznych właściwego kraju.

W BambooHR to samo można zbudować na onboarding_tasks: każde zadanie ma przypisaną osobę odpowiedzialną (assignedTo), termin (dueDate) i status. AI sprawdza, które zadania nie zostały zamknięte na tydzień przed startem nowej osoby, i wysyła przypomnienie do właściciela zadania.

W Factorial nie ma tak rozbudowanego modułu zadań onboardingowych jak w HiBob. Ale można zbudować własną listę po stronie narzędzia portalu, wyzwalaną przez pojawienie się nowego rekordu w employees z start_date w przyszłości. Zadania i ich przypisania trzymacie sami, a Factorial dostarcza tylko dane o nowej osobie: stanowisko, dział, kraj, datę startu.

Od czego zaczniecie: konkretne pierwsze kroki

Zacznijcie od jednego systemu: tego, z którego faktycznie korzystacie na co dzień. Nie warto integrować wszystkich trzech naraz.

  • Wygenerujcie klucz API z uprawnieniami read-only. Klucz trzymajcie w zaszyfrowanych ustawieniach narzędzia, nie w kodzie skryptu ani pliku konfiguracyjnym.
  • Napiszcie jeden skrypt, który ciągnie listę pracowników i wypisuje tych z umowami kończącymi się w ciągu 60 dni. Uruchomcie go raz, sprawdźcie wynik z tym, co widzicie w interfejsie systemu.
  • Gdy to działa, dodajcie powiadomienie e-mailowe i uruchomcie harmonogram: np. codziennie o 7:00.
  • Następny krok: bot odpowiadający na pytania o urlop. Tu musicie zdecydować, kto ma dostęp do czyich danych. W HiBob polityki urlopowe są inne dla różnych lokalizacji. AI musi wiedzieć, z której polityki korzysta konkretny pracownik: wyciąga to z pola work.location i przypisanej do niej polityki.
  • Onboarding uruchomcie jako ostatni: wymaga zdefiniowania szablonów zadań dla każdego stanowiska i lokalizacji, co jest jednorazową pracą konfiguracyjną po stronie HR.

Zanim dorzucicie AI do odpowiadania pracownikom o ich danych kadrowych, sprawdźcie, czy polityka prywatności firmy i zasady RODO pozwalają na takie przetwarzanie w danym kraju. Dane kadrowe to dane osobowe i AI nie powinno odpowiadać jednej osobie na pytania dotyczące danych innej.

Jeśli chcecie zobaczyć, jak wyglądają realne wdrożenia tego typu, sprawdźcie realne wdrożenia. Albo porozmawiajmy o konkretnej sytuacji w Waszej firmie: 15 minut rozmowy wystarczy, żeby ustalić, od którego modułu warto zacząć i co przyniesie Wam efekt w ciągu tygodnia, a co to projekt na miesiąc.

Chcecie to u siebie?

Na osobnej stronie rozpisaliśmy, co dokładnie podłączamy w BambooHR, o co możecie wtedy pytać asystenta i ile kosztuje wdrożenie.

Co podłączamy i ile to kosztuje →

Najczęstsze pytania

Czy integracja AI z HiBob albo BambooHR wymaga zgody producenta albo specjalnej licencji?

Nie. Wszystkie trzy systemy mają otwarte REST API dostępne na każdym płatnym planie. Klucz API generujecie sami w ustawieniach konta, bez zgłaszania czegokolwiek do producenta.

Co jeśli firma używa Factorial na podstawowym planie i nie ma dostępu do webhooków?

Bez webhooków trzeba odpytywać API cyklicznie, np. co godzinę. Sprawdza się to dobrze do pilnowania terminów umów i generowania raportów. Tylko powiadomienia w czasie rzeczywistym będą z kilkugodzinnym opóźnieniem.

Czy AI może samo zatwierdzać wnioski urlopowe bez udziału menedżera?

Technicznie tak: API BambooHR i HiBob mają endpointy do aktualizacji statusu wniosku. W praktyce robimy to tylko tam, gdzie firma świadomie tak zdecyduje, np. dla wniosków w określonym limicie dni albo gdy nie ma konfliktu z nieobecnością reszty zespołu.

Jak bezpiecznie przechować klucz API do BambooHR albo HiBob?

Klucz trafia do zaszyfrowanego pola w ustawieniach narzędzia, nigdy do kodu skryptu, pliku tekstowego ani historii czatu. W BambooHR możecie w każdej chwili unieważnić klucz w Account Settings i wygenerować nowy, bez wpływu na resztę systemu.

Czy AI rozumie różne zasady urlopowe dla pracowników w Polsce i za granicą?

Tak, to jeden z powodów, dla których warto tę integrację zbudować. HiBob przypisuje do każdego pracownika konkretną politykę urlopową zależną od lokalizacji. AI czyta, z której polityki korzysta dana osoba, i odpowiada zgodnie z jej regułami, a nie według jednej ogólnej zasady dla całej firmy.

Wolicie napisać

Pokażemy to na Waszych danych z BambooHR

Jedno zdanie wystarczy: czego szukacie w BambooHR albo co ma się dziać samo. Odpiszemy, co podłączymy i od czego zacząć.

Opracowanie: zespół redAi z wykorzystaniem narzędzi AI.

Następny krok

Podłączymy BambooHR do AI u Was

15 minut rozmowy: mówicie, czego szukacie w danych, my mówimy, co wyciągniemy z BambooHR, ile to potrwa i czego potrzebujemy po Waszej stronie.

  • Bezpłatna prezentacjaAI na Waszych zadaniach, nie na slajdach.
  • Dostęp tego samego dniaZespół od razu pracuje we własnym portalu.
  • Do 2 tygodni testówPłacicie dopiero po decyzji.

Może Was też zainteresować