Webhook'ai

Webhook’ai nusiunčia nedidelį pranešimą į jūsų valdomą URL, kai tik kas nors įvyksta PeekHire — todėl galite reaguoti realiuoju laiku, užuot nuolat tikrinę API.

Kaip veikia webhook’ai

1. Sukuriate endpointą (URL savo serveryje arba automatizavimo įrankyje) skiltyje Kūrėjų įrankiai → Webhooks.
2. Pasirenkate, kuriuos įvykius jis turėtų gauti.
3. Kai įvykis įvyksta, PeekHire siunčia HTTP POST su JSON duomenimis į jūsų endpointą.

Duomenys sąmoningai nedideli — jie nurodo, kas įvyko ir su kuriuo objektu tai susiję, kad prireikus galėtumėte gauti visą informaciją iš REST API.

Galimi įvykiai

Įvykiai apima kandidatų atrankos ciklą, įskaitant:

• Kandidatūros — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Kandidatūrų komentarai — application.comment.created, application.comment.updated, application.comment.deleted.
• Kampanijos — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Pristatymų tikrinimas

Kiekvienas pristatymas pasirašomas, kad galėtumėte patvirtinti, jog jis tikrai atėjo iš PeekHire. Patikrinkite parašą savo endpointe prieš pasitikėdami duomenimis ir atsakykite 2xx būsena, kad patvirtintumėte gavimą.

Pristatymų peržiūra

Rodinyje Pristatymai matomi naujausi webhook bandymai ir jų rezultatai, todėl galite patikrinti, ar įvykiai pasiekia tikslą, ir šalinti nereaguojančio endpointo problemas.

Patarimai

• Greitai atsakykite 2xx ir sunkesnius darbus atlikite asinchroniškai.
• Pasirūpinkite, kad jūsų apdorojimo logika būtų idempotentinė — tas pats įvykis kartais gali būti pristatytas daugiau nei vieną kartą.
• Pradėkite nuo tokio įrankio kaip Make, Zapier arba n8n, jei nenorite paleisti savo serverio.