Webhooki

Webhooki wysyłają krótką wiadomość na kontrolowany przez ciebie URL za każdym razem, gdy coś dzieje się w PeekHire — dzięki temu możesz reagować w czasie rzeczywistym zamiast odpytywać API.

Jak działają webhooki

1. Tworzysz endpoint (URL na swoim serwerze lub w narzędziu do automatyzacji) w sekcji Narzędzia deweloperskie → Webhooki.
2. Wybierasz, które zdarzenia ma odbierać.
3. Gdy wystąpi zdarzenie, PeekHire wysyła HTTP POST z ładunkiem JSON do twojego endpointu.

Ładunki są celowo małe — identyfikują, co się stało i którego obiektu dotyczy zdarzenie, aby w razie potrzeby można było pobrać pełne szczegóły z REST API .

Dostępne zdarzenia

Zdarzenia obejmują cykl rekrutacyjny, w tym:

• Aplikacje — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Komentarze do aplikacji — application.comment.created, application.comment.updated, application.comment.deleted.
• Kampanie — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Weryfikowanie dostarczeń

Każde dostarczenie jest podpisane, aby można było potwierdzić, że naprawdę pochodzi z PeekHire. Zweryfikuj podpis na swoim endpoincie, zanim zaufasz ładunkowi, i odpowiedz statusem 2xx, aby potwierdzić odbiór.

Sprawdzanie dostarczeń

Widok Dostarczenia pokazuje ostatnie próby wysłania webhooków i ich wyniki, dzięki czemu możesz potwierdzić, że zdarzenia docierają, oraz debugować endpoint, który nie odpowiada.

Wskazówki

• Odpowiadaj szybko statusem 2xx, a cięższe zadania wykonuj asynchronicznie.
• Uczyń swój handler idempotentnym — to samo zdarzenie może czasami zostać dostarczone więcej niż raz.
• Zacznij od narzędzia takiego jak Make, Zapier lub n8n, jeśli wolisz nie uruchamiać serwera.