Вебхуки

Вебхуки отправляют небольшое сообщение на 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, если не хочешь запускать сервер.