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.

Narzędzie „Terminy i dokumenty z BambooHR” w portalu redAi, ekran z danymi z programu BambooHR
Narzędzie „Terminy i dokumenty z BambooHR” w Waszym portalu. Dane przykładowe.

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
Rozmowa z asystentem AI w portalu redAi o danych z programu BambooHR: Saldo urlopu i nieobecności w wybranym tygodniu

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 Magazynier, Logistyka w narzędziu Terminy i dokumenty z BambooHR w portalu redAi

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.

Kartoteka pracowników

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

Wnioski urlopowe

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

Nieobecności bieżące

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

Zadania onboardingowe

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

Pola niestandardowe

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

Webhooki zdarzeń

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.

Pełny opis integracji w bazie wiedzy →

Jak zaczynamy

  1. 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.
  2. Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
  3. Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
Wybierzcie termin → Wolicie napisać?
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ąć.

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.