Zoom Webhook是否提供Event ID？自行构建时如何保证唯一性？

Zoom 部分 Webhook 事件（比如你提供的webinar.started）确实没有返回全局唯一的event_id字段，需要自行构建幂等键来判断事件是否已处理。以下是两种可靠的构建方式：

基于事件Payload字段组合 #

利用事件本身的业务唯一标识字段组合，确保同一事件只会生成一个幂等键：

• 核心组合方案：account_id + event + payload.object.uuid
  • account_id：区分不同Zoom账号的事件，避免跨账号冲突
  • event：明确事件类型（比如webinar.started和webinar.ended是不同事件）
  • payload.object.uuid：网络研讨会的全局唯一UUID，每个研讨会的标识绝对唯一
• 可选增强：如果担心极端场景下的重复触发（比如Zoom异常重复推送同一事件），可以再加上event_ts（事件触发的时间戳），进一步提升唯一性。

基于请求头字段（谨慎使用） #

Zoom Webhook 请求会携带X-Zoom-Request-Id请求头，这是每个HTTP请求的唯一标识，但注意：

• 该ID是请求级唯一，而非事件级唯一。如果Zoom因重试机制重新发送同一事件，会生成新的X-Zoom-Request-Id，此时用这个ID会误判为新事件，破坏幂等性。
• 仅适合不需要区分“同一事件的重复投递”，只需要区分不同HTTP请求的场景，一般不推荐用于事件幂等判断。

实现建议 #

1. 将选中的字段拼接成字符串（比如用分隔符|分隔：AAAAAABBBB|webinar.started|4444AAAiAAAAAiAiAiiAii==）
2. 对拼接后的字符串进行哈希计算（比如SHA-256），生成固定长度的幂等键
3. 处理事件前，先检查存储系统（比如Redis、数据库）中是否存在该键：
   • 存在：跳过事件处理
   • 不存在：处理事件，并将该键存入存储系统（可设置过期时间，比如事件处理完成后保留7天）

内容的提问来源于stack exchange，提问作者user2342348