Webhookovi

Webhookovi šalju malu poruku na URL kojim upravljate kad god se nešto dogodi u PeekHireu — kako biste mogli reagirati u stvarnom vremenu umjesto stalnog ispitivanja API-ja.

Kako webhookovi funkcioniraju

1. Izradite endpoint (URL na svojem poslužitelju ili u alatu za automatizaciju) u Alati za razvojne programere → Webhookovi.
2. Odaberete koje događaje treba primati.
3. Kad se događaj dogodi, PeekHire šalje HTTP POST s JSON payloadom na vaš endpoint.

Payloadi su namjerno mali — identificiraju što se dogodilo i na koji se objekt odnose, kako biste mogli dohvatiti sve pojedinosti iz REST API-ja ako su vam potrebne.

Dostupni događaji

Događaji obuhvaćaju životni ciklus zapošljavanja, uključujući:

• Prijave — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Komentari prijava — application.comment.created, application.comment.updated, application.comment.deleted.
• Kampanje — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Provjera isporuka

Svaka isporuka je potpisana kako biste mogli potvrditi da je zaista došla iz PeekHirea. Provjerite potpis na svojem endpointu prije nego što povjerujete payloadu i odgovorite statusom 2xx kako biste potvrdili primitak.

Pregled isporuka

Prikaz Isporuke pokazuje nedavne pokušaje webhooka i njihove rezultate, kako biste mogli potvrditi da događaji stižu i otkloniti pogreške na endpointu koji ne odgovara.

Savjeti

• Brzo odgovorite statusom 2xx, a zahtjevniji posao obavite asinkrono.
• Neka vaš handler bude idempotentan — isti događaj može se povremeno isporučiti više od jednom.
• Počnite s alatom kao što je Make, Zapier ili n8n ako radije ne biste pokretali poslužitelj.