Webhookit

Webhooks lähettävät pienen viestin hallitsemaasi URL-osoitteeseen aina, kun PeekHiressa tapahtuu jotain — näin voit reagoida reaaliajassa API:n kyselyn sijaan.

Miten webhookit toimivat

1. Luot päätepisteen (URL-osoitteen palvelimellasi tai automaatiotyökalussa) kohdassa Kehittäjätyökalut → Webhookit.
2. Valitset, mitä tapahtumia sen tulee vastaanottaa.
3. Kun tapahtuma tapahtuu, PeekHire lähettää HTTP POST -pyynnön JSON-payloadilla päätepisteeseesi.

Payloadit pidetään tarkoituksella pieninä — ne kertovat, mitä tapahtui ja mitä objektia se koskee, jotta voit hakea täydet tiedot REST API:sta tarvittaessa.

Saatavilla olevat tapahtumat

Tapahtumat kattavat rekrytoinnin elinkaaren, muun muassa:

• Hakemukset — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Hakemusten kommentit — application.comment.created, application.comment.updated, application.comment.deleted.
• Kampanjat — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Lähetysten varmentaminen

Jokainen lähetys allekirjoitetaan, jotta voit varmistaa, että se todella tuli PeekHirelta. Varmenna allekirjoitus päätepisteessäsi ennen kuin luotat payloadiin, ja vastaa 2xx-tilakoodilla vastaanoton kuittaamiseksi.

Lähetysten tarkastelu

Lähetykset-näkymä näyttää viimeisimmät webhook-yritykset ja niiden tulokset, joten voit varmistaa, että tapahtumat saapuvat, ja selvittää ongelmia päätepisteessä, joka ei vastaa.

Vinkit

• Vastaa nopeasti 2xx-tilakoodilla ja tee raskas työ asynkronisesti.
• Suunnittele käsittelijäsi idempotentiksi — sama tapahtuma saatetaan joskus toimittaa useammin kuin kerran.
• Jos et halua ylläpitää omaa palvelinta, aloita työkalulla kuten Make, Zapier tai n8n.