Przegląd webhooków

Dlaczego to ważne

Webhooki przesyłają dane o zdarzeniach do systemów zewnętrznych w momencie ich wystąpienia — kandydat aplikuje, rozmowa kwalifikacyjna zostaje zaplanowana, ogłoszenie o pracę zostaje opublikowane. Zamiast odpytywać API, integracje otrzymują natychmiastowe wywołania zwrotne HTTP z pełnym ładunkiem zdarzenia.

Wymagania

• Konto Kit z dostępem administratora
• Punkt końcowy HTTPS zdolny do odbierania żądań POST

Konfiguracja

Przejdź do Integracje > Webhooki, kliknij New Webhook i wypełnij:

Pole	Wymagane	Opis
URL	Tak	Punkt końcowy HTTPS, który będzie odbierać zdarzenia
Description	Nie	Etykieta ułatwiająca identyfikację tego webhooka
Events	Tak	Typy zdarzeń do subskrypcji

Można wybrać poszczególne zdarzenia lub zasubskrybować całe kategorie. Kliknij Create Webhook, aby zapisać. Kit wygeneruje klucz podpisu, który posłuży do weryfikacji ładunków.

Dostępne zdarzenia

Kit wysyła webhooki w sześciu kategoriach:

Zdarzenia aplikacji

Zdarzenie	Kiedy jest wysyłane
application.submitted	Kandydat przesyła aplikację
application.rejected	Aplikacja zostaje odrzucona
application.advanced	Aplikacja przechodzi do następnego etapu
application.withdrawn	Kandydat wycofuje swoją aplikację
application.offer_extended	Oferta zostaje złożona kandydatowi

Zdarzenia ofert

Zdarzenie	Kiedy jest wysyłane
offer.accepted	Administrator akceptuje ofertę
offer.declined	Administrator odrzuca ofertę
offer.candidate_accepted	Kandydat akceptuje ofertę
offer.candidate_declined	Kandydat odrzuca ofertę
offer.revised	Oferta zostaje zmieniona z nowymi warunkami

Zdarzenia rozmów kwalifikacyjnych

Zdarzenie	Kiedy jest wysyłane
interview.scheduled	Rozmowa kwalifikacyjna zostaje zaplanowana
interview.confirmed	Kandydat potwierdza rozmowę kwalifikacyjną
interview.completed	Rozmowa kwalifikacyjna zostaje oznaczona jako zakończona
interview.cancelled	Rozmowa kwalifikacyjna zostaje anulowana
interview.no_show	Kandydat zostaje oznaczony jako nieobecny

Zdarzenia zadań programistycznych

Zdarzenie	Kiedy jest wysyłane
code_assignment.submitted	Kandydat przesyła swoje zadanie programistyczne
code_assignment.auto_submitted	Zadanie programistyczne zostaje automatycznie przesłane po upływie terminu

Zdarzenia ocen

Zdarzenie	Kiedy jest wysyłane
review.submitted	Członek zespołu przesyła ocenę

Zdarzenia ogłoszeń o pracę

Zdarzenie	Kiedy jest wysyłane
job_posting.published	Ogłoszenie o pracę zostaje opublikowane
job_posting.paused	Ogłoszenie o pracę zostaje wstrzymane
job_posting.closed	Ogłoszenie o pracę zostaje zamknięte
job_posting.reopened	Ogłoszenie o pracę zostaje wznowione

Zarządzanie webhookami

Każdy webhook wyświetla swój status, zasubskrybowane zdarzenia oraz historię ostatnich dostarczeń.

• Pause — Wstrzymanie dostarczania. Zdarzenia wywołane podczas wstrzymania nie są kolejkowane.
• Resume — Ponowne włączenie wstrzymanego lub automatycznie wyłączonego webhooka. Resetuje licznik błędów.
• Edit — Zmiana adresu URL, opisu lub zasubskrybowanych zdarzeń.
• Rotate Secret — Wygenerowanie nowego klucza podpisu. Należy zaktualizować punkt końcowy przed rotacją.
• Delete — Trwałe usunięcie webhooka wraz z historią dostarczeń.

Testowanie punktu końcowego

Kliknij Send Test Ping na dowolnym webhooku, aby wysłać zdarzenie test.ping do punktu końcowego. Służy to do weryfikacji połączenia i walidacji podpisu przed zasubskrybowaniem na rzeczywiste zdarzenia.

Zakładka Deliveries wyświetla nagłówki żądania, status odpowiedzi oraz czas każdej próby dostarczenia.

Szybka lista kontrolna

• Przejść do Integracje > Webhooki
• Dodać adres URL punktu końcowego HTTPS
• Wybrać zdarzenia do odbierania
• Skopiować klucz podpisu
• Wysłać testowy ping w celu weryfikacji połączenia
• Zaimplementować weryfikację podpisu w punkcie końcowym
• Zwrócić kod statusu 2xx w celu potwierdzenia odbioru