Integracje / BambooHR
Kadry, płace i rekrutacja
Integracja AI: BambooHR
Podłączamy BambooHR przez REST API i czytamy dane pracowników, wnioski urlopowe oraz zadania onboardingowe. Asystent pilnuje terminów umów na czas określony, odpowiada na pytania o saldo urlopu i śledzi niedomknięte zadania przed startem nowej osoby.
Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.

W skrócie
Jak asystent AI łączy się z systemem BambooHR?
Łączymy się z BambooHR przez REST API pod adresem api.bamboohr.com/api/gateway.php/{subdomain}/v1/. Klucz API generujecie w Account Settings > API Keys z uprawnieniami read-only.
- Na start potrzebujemy
- Klucz API z Account Settings > API Keys z uprawnieniami co najmniej read-only
- Czego asystent nie robi
- Nie zatwierdza wniosków urlopowych sam: każda zmiana statusu wymaga potwierdzenia przez menedżera
- Gdzie są dane
- Na Waszym serwerze. Zaczynamy od odczytu, zapis włączacie sami.
Dane z BambooHR w czacie i we własnym module
Pracujecie na dwa sposoby. W czacie pytacie o cokolwiek z programu i dostajecie odpowiedź na Waszych danych. Do rzeczy, które wracają co dzień, budujemy w portalu osobne narzędzie: Terminy i dokumenty z BambooHR. Moduł zbiera z BambooHR daty wygaśnięcia umów na czas określony, pozwoleń na pracę i badań profilaktycznych wszystkich pracowników. Dział HR widzi w jednym miejscu, kto wymaga decyzji w ciągu 30 i 60 dni, bez ręcznego przeglądania kart w systemie.
- Monitoruje daty zakończenia umów z pól employmentType i terminationDate w BambooHR
- Śledzi ważność pozwoleń na pracę i badań z customFields skonfigurowanych w firmie
- Sortuje rekordy według liczby dni do wygaśnięcia, od najpilniejszych na górze
- Oznacza przekroczenia i zbliżające się terminy odznaki: err, warn, info
- Pozwala wysłać przypomnienie do właściciela zadania jednym kliknięciem w tabeli

Pytanie w czacie
Pracownik dostaje odpowiedź z BambooHR w kilka sekund, bez angażowania kadrowej i bez logowania do systemu.
Ile dni urlopu mi zostało i czy mogę wziąć przyszły tydzień, skoro część ekipy z obsługi klienta już wtedy nie będzie?

Karta w narzędziu
Karta pokazuje pełny kontekst: pola z BambooHR, historię alertów i sugestię asystenta, bez konieczności otwierania systemu.
Jeden ekran zamiast ręcznego przeglądania kart: HR widzi od razu, kto wymaga decyzji, i wysyła przypomnienie bez wychodzenia z portalu.
Ekrany na danych przykładowych. Narzędzie dla Waszej firmy układamy pod Wasz sposób pracy: inne kolumny, inne progi, inne powiadomienia.
Co podłączamy
Zaczynamy od odczytu danych. Zapis i akcje w systemie BambooHR włączamy dopiero wtedy, gdy sami tego chcecie.
CzytamyhireDate, terminationDate, employmentType dla każdego pracownika przez /employees/directory
AsystentWykrywa pracowników z umowami kończącymi się w ciągu 30 i 60 dni, zestawia rotację i strukturę zatrudnienia według działów
Czytamystatus wniosku, daty, rodzaj nieobecności i identyfikator pracownika z /time_off/requests
AsystentOdpowiada na pytania o aktualne saldo, sprawdza otwarte wnioski i flaguje osoby z dużą liczbą dni do wykorzystania przed końcem roku
Czytamylista osób nieobecnych w konkretnym dniu lub tygodniu z /time_off/whos_out
AsystentInformuje menedżera, kogo nie ma w pracy w wybranym dniu albo tygodniu, bez konieczności logowania do BambooHR
CzytamyassignedTo, dueDate i status każdego zadania per pracownik z /employees/{id}/onboarding_tasks
AsystentSprawdza, które zadania nie zostały zamknięte tydzień przed startem nowej osoby, i wysyła przypomnienie do właściciela zadania
CzytamycustomFields z konfiguracji firmy, np. data ważności pozwolenia na pracę albo kategoria stanowiska
AsystentPilnuje dat ważności dokumentów, wyprzedzająco ostrzega przed upływem terminu i wypisuje puste pola jako braki do uzupełnienia
Czytamyzdarzenia z Account Settings > Webhooks: zmiana statusu pracownika, nowy wniosek urlopowy, zmiana pola profilu
AsystentUruchamia działania natychmiast po zdarzeniu w BambooHR, bez czekania na kolejną synchronizację cykliczną
O co pytają w praktyce
Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.
- „Ile dni urlopu zostało mi do końca roku?”
- „Które umowy na czas określony kończą się w ciągu 30 dni?”
- „Kto z zespołu ma badania profilaktyczne do odnowienia?”
- „Które zadania onboardingowe nie zostały zamknięte przed startem nowej osoby?”
Co się zmienia
Kadrowa przestaje ręcznie sprawdzać salda urlopowe i daty kończących się umów: raport z terminami trafia do menedżera HR każdego ranka bez jej udziału.
Asystent działa na Waszym serwerze, na Waszych uprawnieniach. Każdy odczyt i każda akcja zostawiają ślad w logu. Program zostaje tam, gdzie jest, razem z historią danych i nawykami zespołu.
O programie
BambooHR to system HR w chmurze, przeznaczony dla małych i średnich firm. Zbiera w jednym miejscu kartoteki pracowników, wnioski urlopowe i zadania onboardingowe. Firma pracuje przez przeglądarkę, a dane trzymane są po stronie BambooHR. System sprawdza się szczególnie tam, gdzie zespół rozsiany jest po kilku krajach i każda lokalizacja ma inne przepisy urlopowe albo wymagania dokumentacyjne.
Codzienna praca w BambooHR to: uzupełnianie profili przez HR, zatwierdzanie wniosków urlopowych i śledzenie postępu zadań onboardingowych przed startem nowej osoby. Menedżerowie widzą swój zespół i przypisane im zadania. Pracownicy sprawdzają saldo urlopu i składają wnioski. Dane podzielone są na sekcje: kartoteka, Time Off, Onboarding i pola niestandardowe dodawane przez firmę.
Gdzie to działa najlepiej
Menedżer HR
Co rano sprawdza, czy któryś pracownik ma umowę na czas określony kończącą się w ciągu 30 albo 60 dni albo pozwolenie na pracę bliskie wygaśnięcia. Wcześniej przeglądał kartoteki ręcznie albo czekał, aż ktoś zgłosi problem.
Z asystentem: O 7:30 w skrzynce czeka gotowy raport: imię, stanowisko, kraj, liczba dni do wygaśnięcia i link do karty pracownika w BambooHR. Menedżer reaguje, zanim termin minie.
Pracownik zdalny
Przed planowanym urlopem pisze przez chatbot portalu, ile mu zostało dni urlopu i czy może wziąć tydzień, kiedy część zespołu jest już nieobecna.
Z asystentem: Asystent pobiera saldo z /time_off/requests i sprawdza whos_out w wybranym tygodniu. Odpowiada w kilka sekund, bez angażowania kadrowej.
Dział IT
Tydzień przed startem nowej osoby nikt z IT nie dostał informacji o przygotowaniu laptopa i kont w systemach. Zadanie stoi niedomknięte w BambooHR od kilku dni, a data startu zbliża się.
Z asystentem: Asystent sprawdza onboarding_tasks tej osoby, identyfikuje zadania niedomknięte z przypisanym właścicielem i wysyła im przypomnienie z terminem.
Jak się łączymy
Łączymy się z BambooHR przez REST API pod adresem api.bamboohr.com/api/gateway.php/{subdomain}/v1/. Klucz API generujecie w Account Settings > API Keys z uprawnieniami read-only. Uwierzytelnienie to HTTP Basic Auth: klucz API jako nazwa użytkownika. Webhooki konfigurujecie w Account Settings > Webhooks i reagują na zmiany statusów, nowe wnioski i modyfikacje profili bez cyklicznego odpytywania.
Asystent pracuje na serwerze klienta. Do modelu AI trafia polecenie i fragmenty danych potrzebne do odpowiedzi, bez trenowania cudzych modeli na danych klienta. Klucz API przechowywany jest zaszyfrowany w ustawieniach narzędzia, nigdy w kodzie skryptu ani historii czatu. W BambooHR możecie unieważnić klucz w Account Settings i wygenerować nowy, bez wpływu na resztę systemu.
Czego potrzebujemy od Was
- Klucz API z Account Settings > API Keys z uprawnieniami co najmniej read-only
- Subdomena BambooHR, czyli nazwa konta widoczna w adresie URL systemu
- Płatny plan BambooHR z aktywnym dostępem do REST API (każdy płatny plan ma go włączonego)
- Osoba po stronie firmy, która zna nazwy używanych pól niestandardowych (customFields)
- Dostęp do Account Settings > Webhooks, jeśli firma chce powiadomień w czasie rzeczywistym
Czego asystent nie robi
- Nie zatwierdza wniosków urlopowych sam: każda zmiana statusu wymaga potwierdzenia przez menedżera
- Nie modyfikuje danych pracowników w BambooHR bez wyraźnej zgody: domyślna praca to odczyt
- Nie interpretuje pustego pola jako braku problemu: braki wypisuje osobno jako luki do uzupełnienia
- Nie zastępuje działu HR przy decyzjach kadrowych: przygotowuje dane i raporty, decyzję podejmuje człowiek
Częste pytania
Kiedy webhooki BambooHR działają i do czego je używamy?
Webhooki konfigurujecie w Account Settings > Webhooks. Uruchamiają się przy zmianie statusu pracownika, nowym wniosku urlopowym albo zmianie pola profilu. Narzędzie reaguje na zdarzenie od razu. Bez webhooków można odpytywać API cyklicznie, np. co godzinę, co sprawdza się do raportów i pilnowania terminów.
Skąd wiadomo, jakie pola niestandardowe czytać z BambooHR?
Firma konfiguruje pola niestandardowe w BambooHR samodzielnie i od razu są dostępne przez API jako customFields. Przed wdrożeniem sprawdzamy, które pola firma używa, np. datę ważności pozwolenia na pracę, i pod te nazwy konfigurujemy narzędzie. Zmiana nazwy pola w BambooHR wymaga aktualizacji po stronie narzędzia.
Jak często dane z BambooHR są odświeżane w portalu?
Zależy od konfiguracji. Przy webhookach zmiany trafiają do narzędzia w kilka sekund od zdarzenia w BambooHR. Przy odpytywaniu cyklicznym czas odświeżania ustawiacie sami, np. co godzinę. Do raportów porannych wystarczy jedno pobranie danych o stałej porze.
Co jeśli firma ma kilka spółek z osobnymi kontami w BambooHR?
Każda subdomena BambooHR to osobne konto z osobnym kluczem API. Narzędzie można skonfigurować z kluczami do kilku subdomen i zbierać dane z każdej oddzielnie. Raporty można budować per spółka albo łączyć w jeden widok, gdy firma chce porównywać dane między jednostkami.
Jak zaczynamy
- Bezpłatna prezentacja. Mówicie, na czym pracujecie i co Was korkuje. Mówimy wprost, czy da się to spiąć, a jeśli nie ma czego automatyzować, też to powiemy.
- Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
- Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
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ąć.
Inne programy: kadry, płace i rekrutacja
BambooHR jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.