SuperAPI AI 工具集

zoom-webhooks

编程与开发

查看项目

更新于 10-16 05:53

技能介绍

用途:帮助开发者搭建 Zoom Webhook 处理程序,完成签名验证与端点校验握手,并处理会议、录制等事件。

主要能力:验证 x-zm-signature 签名;完成一次性的 endpoint.url_validation 握手;分发 meeting.started、meeting.ended、meeting.participant_joined、meeting.participant_left、recording.completed 等事件;提供 Express、Next.js、FastAPI 完整示例与测试。

验证方式:Zoom 使用应用 Secret Token 做 HMAC-SHA256(hex)签名,消息为 v0:{x-zm-request-timestamp}:{raw body},结果加前缀 v0=,与 x-zm-signature 头做 timing-safe 比较。必须使用原始请求体,先解析 JSON 会改变字节导致签名失败。当 event 为 endpoint.url_validation 时,需返回 200 及 { plainToken, encryptedToken },其中 encryptedToken = HMAC-SHA256(plainToken, secretToken) 的 hex。所有 Webhook 须在 3 秒内响应。

环境变量:ZOOM_WEBHOOK_SECRET_TOKEN=your_secret_token,来自 Zoom App Marketplace 应用的 Feature/Webhook 页面。

本地开发:npx hookdeck-cli listen 3000 zoom --path /webhooks/zoom

限制与说明:资料未提供收费、价格、平台支持范围等细节;建议配合 webhook-handler-patterns 技能处理幂等、错误与重试。