Otwarte API i webhooki PeopleForce dla integracji niestandardowych

Sposoby połączenia

Jak połączyć PeopleForce z innymi systemami?

Większość połączeń w ogóle nie wymaga programistów. Wystarczy zacząć od poziomu, który pasuje do zespołu.

Bez programistów: gotowa aplikacja w Zapier

Oficjalna aplikacja w Zapier ma 13 wyzwalaczy i 3 akcje: zatrudnienia, zakończenia współpracy, zmiany stanowisk i wynagrodzeń, wnioski o nieobecność, zaakceptowane oferty. Łączy się ją kluczem API firmy i wybiera aplikację po drugiej stronie.

Low code: własne narzędzie do automatyzacji

n8n, Make lub dowolne narzędzie obsługujące HTTP działa z tym samym kluczem API i tymi samymi webhookami. Zespoły już w ten sposób obsługują polecenia kandydatów, korekty nadgodzin i zgłoszenia onboardingowe.

Własny zespół IT: integracja budowana samodzielnie

Udokumentowane REST API, które odczytuje i zapisuje dane o pracownikach, strukturze organizacyjnej, wynagrodzeniach, nieobecnościach, czasie pracy i rekrutacji, z opublikowanymi specyfikacjami OpenAPI. Można na nim zbudować dashboard, portal lub asystenta.

Dostępne dane

Jakie dane można odczytywać i zapisywać?

PeopleForce pozostaje źródłem prawdy o danych pracowników. Wszystko poniżej można pobrać do własnych systemów, zapisać z powrotem albo jedno i drugie.

Obiekt	Odczyt	Zapis	Zdarzenia webhooków
Pracownicy i profile	Tak	Tak	Zatrudnienie, aktualizacja, pierwszy dzień, zakończenie współpracy
Struktura organizacyjna	Tak	Tak	Zmiany stanowisk i profili stanowisk
Wynagrodzenia	Tak	Tak	Zmiany wynagrodzenia i dodatkowych wypłat
Nieobecności	Tak	Tak	Utworzenie, zatwierdzenie, odrzucenie, wycofanie, usunięcie
Nadgodziny	Tak	Tak	Utworzenie, aktualizacja, zatwierdzenie, usunięcie
Ewidencja czasu pracy	Tak	Tak	—
Rekrutacja	Tak	Tak	Kandydat, oferta pracy, aplikacja, przesunięcie w lejku, oferta
Ocena pracy	Tak	Tylko KPI	—
Ankiety	Tylko v4	—	Uruchomienie ankiety

Dane o wynagrodzeniach wymagają osobnego uprawnienia klucza. Dane z ankiet odczytuje się przez nowsze API v4, które korzysta z klucza konta usługowego zamiast klucza firmy.

Pełna dokumentacja endpointów i szczegóły pól

Wszystko jest w dokumentacji dla programistów

Dokumentacja dla programistów

Zdarzenia

Co się dzieje w chwili zmiany danych?

Zamiast odpytywać nas według harmonogramu, wystarczy zasubskrybować 36 zdarzeń, a PeopleForce sam powiadomi systemy, gdy coś się wydarzy.

Podpisane dostarczenia

Dostarczane na endpoint HTTPS. Po ustawieniu sekretu każde dostarczenie jest podpisywane HMAC‑SHA256, więc można sprawdzić, że pochodzi od nas.

Log każdego dostarczenia

Każde dostarczenie jest zapisywane w logu z żądaniem i odpowiedzią i można je wysłać ponownie z ekranu ustawień.

Konfiguracja w interfejsie lub przez API

Endpointy konfiguruje się w interfejsie, a można je też tworzyć i usuwać przez API.

Grupa	Zdarzenia
Pracownicy	Utworzenie, aktualizacja, pierwszy dzień, zakończenie współpracy, anulowanie zakończenia współpracy
Wynagrodzenia	Zmiana wynagrodzenia, dodanie lub zmiana dodatkowej wypłaty, zmiana statusu zatrudnienia
Nieobecności	Utworzenie, zatwierdzenie, odrzucenie, wycofanie, usunięcie
Nadgodziny	Utworzenie, aktualizacja, zatwierdzenie, usunięcie
Rekrutacja	Utworzenie lub usunięcie kandydata, utworzenie oferty pracy, utworzenie aplikacji, przesunięcie w lejku, przyjęcie lub odrzucenie oferty
Struktura i dostęp	Stanowiska, profile stanowisk, wiersze tabel niestandardowych, użytkownicy zewnętrzni, uruchomienie ankiety

Jak to działa

Jak to działa od początku do końca

Jedna nowa osoba, cztery kroki, bez przepisywania danych.

1. Dodanie nowej osoby

Dział HR uzupełnia profil w PeopleForce, tak jak dotychczas.

2. PeopleForce wysyła zdarzenie

Endpoint otrzymuje podpisany webhook z danymi osoby i datą rozpoczęcia pracy.

3. Systemy reagują

Tworzone są konta, otwiera się zgłoszenie na laptopa, nadawane są dostępy.

4. Wynik wraca

Proces zapisuje dane kont z powrotem w profilu przez API.

Od czego zacząć

Klucz należy do firmy, więc nic nie zależy od tego, czy jedna osoba zostanie w zespole.

1. Utworzenie klucza API

Ustawienia → Klucze API, dostępne dla każdej roli, której nadano to ustawienie. Klucz jest wyświetlany raz i należy do firmy, a nie do osoby, która go utworzyła.

2. Wywołanie pierwszego endpointu

Klucz przekazuje się w nagłówku żądania i odczytuje dane o pracownikach, działach lub ofertach pracy.

3. Subskrypcja potrzebnych zdarzeń

Administrator dodaje endpoint webhooka, wybiera jego tematy i sprawdza log dostarczeń.

Obecnie 300 żądań na minutę na klucz	Wystarczy, by co noc synchronizować kilka tysięcy osób. Po przekroczeniu limitu odpowiedź podaje, ile czekać przed ponowieniem.
Każdy klucz można ograniczyć do własnych adresów	Po dodaniu listy dozwolonych adresów IP klucz działa tylko z własnych serwerów.
Specyfikacja jest opublikowana	Można wygenerować klienta we własnym języku programowania zamiast pisać każde żądanie ręcznie.
Starsze wersje pozostają dostępne	Wersje od pierwszej do trzeciej mają te same ścieżki, więc integracja napisana dla wcześniejszej działa dalej. Wersja czwarta to osobne, nowsze API, na które przechodzi się, gdy potrzebne jest to, co dodaje.