Уебхукове

Уебхуковете изпращат малко съобщение към URL, който контролирате, когато нещо се случи в PeekHire — за да можете да реагирате в реално време, вместо да проверявате API периодично.

Как работят уебхуковете

1. Създавате крайна точка (URL на вашия сървър или инструмент за автоматизация) в Инструменти за разработчици → Уебхукове.
2. Избирате кои събития да получава.
3. Когато настъпи събитие, PeekHire изпраща HTTP POST с JSON payload към вашата крайна точка.

Payload-ите умишлено са малки — те показват какво се е случило и за кой обект се отнася, за да можете да изтеглите пълните детайли от REST API, ако са ви необходими.

Налични събития

Събитията покриват жизнения цикъл на подбора, включително:

• Кандидатури — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Коментари към кандидатури — application.comment.created, application.comment.updated, application.comment.deleted.
• Кампании — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Проверка на доставките

Всяка доставка е подписана, за да можете да потвърдите, че наистина идва от PeekHire. Проверете подписа на вашата крайна точка, преди да се доверите на payload-а, и отговорете със статус 2xx, за да потвърдите получаването.

Преглед на доставките

Изгледът Доставки показва последните опити за изпращане на уебхукове и техните резултати, за да можете да потвърдите, че събитията пристигат, и да отстраните проблеми с крайна точка, която не отговаря.

Съвети

• Отговаряйте бързо с 2xx и извършвайте по-тежката работа асинхронно.
• Направете обработчика си идемпотентен — едно и също събитие понякога може да бъде доставено повече от веднъж.
• Започнете с инструмент като Make, Zapier или n8n, ако предпочитате да не поддържате собствен сървър.