用途:Zoom Rivet 是面向 JavaScript/TypeScript 的服务端框架,用于构建 Zoom 集成。本技能为参考文档,适合在确定采用基于 Rivet 的服务端工作流后,指导认证处理、Webhook 消费、API 封装与多模块服务组合。
主要能力:OAuth 与令牌处理;Webhook 事件消费;类型化 REST API 端点封装;多模块服务组合。官方文档见 https://developers.zoom.us/docs/rivet/ 、https://developers.zoom.us/docs/rivet/javascript/ 、https://zoom.github.io/rivet-javascript/ 。参考示例见 https://github.com/zoom/rivet-javascript-sample 、https://github.com/zoom/isv-rivet-starter 、https://github.com/zoom/Rivet-Server-Sample 、https://github.com/zoom/rivet-javascript 。
使用方式:Rivet 推荐用于更快的服务端脚手架搭建,但并非强制。规划开始时先确认用户偏好:使用 Rivet SDK,还是直接 OAuth + REST。当用户需要将 Zoom 认证、Webhook 与 API 调用以最少胶水代码组合在一个 Node.js 服务中时使用 Rivet。若只需从现有后端直接调用 API,转 ../rest-api/SKILL.md;若聚焦 Team Chat 应用卡片/命令行为,转 ../team-chat/SKILL.md;若需要 SDK 嵌入(Meeting SDK/Video SDK 客户端运行时),转 ../meeting-sdk/SKILL.md 或 ../video-sdk/SKILL.md。
常见生命周期:按模块选择认证模型(Client Credentials、User OAuth、S2S OAuth、Video SDK JWT);用凭据、Webhook 密钥和每模块端口实例化客户端;注册事件处理器(webEventConsumer.event(...) 或快捷方式);通过 client.endpoints.* 实现 API 调用;启动接收器并向 Zoom 暴露 Webhook 端点(/zoom/events);为 OAuth 工作负载持久化令牌/状态并强制签名验证;监控模块级故障并按变更日志节奏轮换密钥/版本。
适用场景:Team Chat 斜杠命令机器人加数据 API 增强;多模块后端(Users + Meetings + Team Chat + Phone)共享一个进程;使用 videosdk 模块事件流与 API 的 Video SDK 遥测后端;带租户感知令牌存储和每模块 Webhook 的 ISV 编排层;使用 Rivet AwsLambdaReceiver 的 AWS Lambda Webhook 处理器。
限制:资料未提供具体收费、价格、平台支持范围与效果数据。环境变量标准化键值见 references/environment-variables.md;运维预检与调试清单见 RUNBOOK.md。