Вебхуки

Вебхуки надсилають невелике повідомлення на URL, який ти контролюєш, щоразу, коли щось відбувається в PeekHire — тож ти можеш реагувати в реальному часі замість того, щоб опитувати API.

Як працюють вебхуки

1. Ти створюєш кінцеву точку (URL на своєму сервері або в інструменті автоматизації) у розділі Інструменти розробника → Вебхуки.
2. Ти вибираєш, які події вона має отримувати.
3. Коли відбувається подія, PeekHire надсилає HTTP POST з JSON-навантаженням до твоєї кінцевої точки.

Навантаження навмисно невеликі — вони визначають, що сталося та якого об’єкта це стосується, щоб ти міг отримати повні деталі через 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. Перевіряй підпис на своїй кінцевій точці, перш ніж довіряти навантаженню, і відповідай статусом 2xx, щоб підтвердити отримання.

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

Подання Доставки показує нещодавні спроби вебхуків і їхні результати, щоб ти міг підтвердити, що події надходять, і налагодити кінцеву точку, яка не відповідає.

Поради

• Швидко відповідай статусом 2xx, а важку роботу виконуй асинхронно.
• Зроби свій обробник ідемпотентним — одна й та сама подія іноді може доставлятися більше ніж один раз.
• Почни з інструмента на кшталт Make, Zapier або n8n, якщо не хочеш запускати сервер.