Webhooky

Webhooky odešlou malou zprávu na URL, kterou spravujete, kdykoli se něco stane v PeekHire — takže můžete reagovat v reálném čase místo dotazování API.

Jak webhooky fungují

1. Vytvoříte endpoint (URL na svém serveru nebo v automatizačním nástroji) v části Vývojářské nástroje → Webhooky.
2. Vyberete, které události má přijímat.
3. Když dojde k události, PeekHire odešle HTTP POST s JSON payloadem na váš endpoint.

Payloady jsou záměrně malé — určují, co se stalo a kterého objektu se to týká, abyste si v případě potřeby mohli načíst úplné podrobnosti z REST API.

Dostupné události

Události pokrývají náborový proces, včetně:

• Přihlášek — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Komentářů k přihláškám — application.comment.created, application.comment.updated, application.comment.deleted.
• Kampaní — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Ověřování doručení

Každé doručení je podepsané, takže si můžete ověřit, že skutečně pochází z PeekHire. Předtím, než payloadu začnete důvěřovat, ověřte podpis na svém endpointu a odpovězte stavem 2xx, abyste potvrdili přijetí.

Kontrola doručení

Zobrazení Doručení ukazuje nedávné pokusy webhooků a jejich výsledky, takže si můžete ověřit, že události přicházejí, a ladit endpoint, který neodpovídá.

Tipy

• Odpovídejte rychle stavem 2xx a náročnější práci zpracovávejte asynchronně.
• Zajistěte, aby byl váš handler idempotentní — stejná událost může být občas doručena více než jednou.
• Pokud nechcete provozovat server, začněte s nástrojem jako Make, Zapier nebo n8n.