Webhooky

Webhooky odosielajú malú správu na URL, ktorú ovládate, vždy keď sa niečo stane v PeekHire — takže môžete reagovať v reálnom čase namiesto opakovaného dopytovania API.

Ako webhooky fungujú

1. Vytvoríte endpoint (URL na vašom serveri alebo v automatizačnom nástroji) v časti Vývojárske nástroje → Webhooky.
2. Vyberiete, ktoré udalosti má prijímať.
3. Keď nastane udalosť, PeekHire odošle HTTP POST s JSON payloadom na váš endpoint.

Payloady sú zámerne malé — identifikujú, čo sa stalo a ktorého objektu sa to týka, takže si môžete načítať úplné detaily z REST API, ak ich potrebujete.

Dostupné udalosti

Udalosti pokrývajú náborový životný cyklus vrátane:

• Žiadosti — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Komentáre k žiadostiam — application.comment.created, application.comment.updated, application.comment.deleted.
• Kampane — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Overovanie doručení

Každé doručenie je podpísané, aby ste si mohli potvrdiť, že naozaj prišlo z PeekHire. Pred dôverovaním payloadu overte podpis na svojom endpointe a odpovedzte stavom 2xx, čím potvrdíte prijatie.

Kontrola doručení

Zobrazenie Doručenia ukazuje nedávne pokusy o webhook a ich výsledky, takže si môžete potvrdiť, že udalosti prichádzajú, a ladiť endpoint, ktorý neodpovedá.

Tipy

• Odpovedajte rýchlo stavom 2xx a náročnú prácu vykonávajte asynchrónne.
• Nastavte svoj handler ako idempotentný — tá istá udalosť môže byť občas doručená viac než raz.
• Začnite s nástrojom ako Make, Zapier alebo n8n, ak radšej nechcete prevádzkovať server.