Webhooks

每当 PeekHire 中发生某件事时，Webhooks 都会向你控制的 URL 推送一条小消息——这样你就可以实时响应，而不必轮询 API。

Webhooks 的工作原理

1. 你在 开发者工具 → Webhooks 下创建一个端点（你服务器上的 URL 或自动化工具）。
2. 你选择它应该接收哪些事件。
3. 当事件发生时，PeekHire 会向你的端点发送一个带有 JSON 负载的 HTTP POST。

负载有意保持精简——它们会标识发生了什么，以及涉及哪个对象，因此如果你需要完整详情，可以从 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 状态以确认已收到。

查看投递

投递视图会显示最近的 webhook 尝试及其结果，因此你可以确认事件正在到达，并调试没有响应的端点。

提示

• 快速返回 2xx，并将耗时工作异步处理。
• 让你的处理程序保持幂等——同一个事件偶尔可能会被投递 多次。
• 如果你不想运行服务器，可以先使用 Make、Zapier 或 n8n 这类工具。