接收 Web Hooks 并可靠处理事件

选择合适的事件接入方式

Crisp Web Hooks 使用 HTTP POST 发送 JSON 事件。Website Hooks 面向单个工作空间；Plugin Hooks 用于插件场景，支持范围与交付机制不同。

1. 明确业务需要响应的事件。
2. 核对所选 Hook 类型支持的事件范围。
3. 记录工作空间、接收地址与负责维护的人。

准备可检查的接收端

1. 使用受控的 HTTPS 地址接收通知。
2. 验证请求来源与负载格式，按所用 Hook 类型处理验证机制。
3. 保存定位问题所需的事件信息，避免记录无关敏感内容。
4. 把耗时业务处理与接收响应分离。

处理重复与失败

将重复接收视为需要设计的情况。不要仅因为收到通知，就无条件再次执行不可重复的业务操作。

1. 为事件或业务动作选择合适的去重标识。
2. 记录待处理、处理中和已完成状态。
3. 对失败采用有上限的重试或人工检查。
4. 对结果不明的写入先核对实际业务状态。

完成事件流测试

1. 在测试工作空间触发一个明确事件。
2. 确认接收端获得预期事件与对象标识。
3. 模拟重复通知，检查不会重复产生业务结果。
4. 模拟处理失败并验证恢复流程。