Webhooks / 事件通知
最后更新：2026-06-29
概述
Webhooks 允许 AgentHR 在特定事件发生时向外部系统推送通知。常见事件包括 Agent 审核完成、支付状态变更和运行结果就绪。
当前状态 / Current Status
⚠ Pre-Cloud — 不发送真实 Webhook
- 当前版本不发送任何真实 Webhook 请求
- 所有事件为本地 mock 模拟
- 不向外部 URL 发起 HTTP 回调
- Webhook 配置界面为规划预留
计划事件 / Planned Events
| 事件 | 触发时机 | Payload |
|---|---|---|
submission.reviewed | Agent 审核完成 | submissionId, status, reviewNotes |
payment.completed | 支付成功 | orderNo, agentSlug, amount |
run.completed | Agent 运行完成 | runId, status, outputPreview |
download.expired | 下载授权过期 | grantId, agentSlug |
安全要求 / Security Requirements
- Webhook URL 必须为 HTTPS
- HMAC-SHA256 签名验证
- IP 白名单限制
- 重试策略（最多 3 次，指数退避）
- 用户可随时禁用或更换 Webhook URL