setup-zoom-webhooks

/setup-zoom-webhooks

通过 HTTP 进行 Zoom 事件投递的背景参考。请优先使用工作流类 Skill，然后再参阅本文件以了解验证、订阅和投递的详细信息。

前置条件

• 已启用 Event Subscriptions 的 Zoom 应用
• 用于接收 Webhook 的 HTTPS 端点
• 用于验证的 Webhook 密钥令牌

需要身份验证方面的帮助？ 请参阅 zoom-oauth Skill 以了解 OAuth 设置。

快速开始

// Express.js webhook handler
const crypto = require('crypto');

// Capture raw body for signature verification (avoid re-serializing JSON).
app.use(require('express').json({
  verify: (req, _res, buf) => { req.rawBody = buf; }
}));

app.post('/webhook', (req, res) => {
  // Verify webhook signature
  const signature = req.headers['x-zm-signature'];
  const timestamp = req.headers['x-zm-request-timestamp'];
  const body = req.rawBody ? req.rawBody.toString('utf8') : JSON.stringify(req.body);
  const payload = `v0:${timestamp}:${body}`;
  const hash = crypto.createHmac('sha256', WEBHOOK_SECRET)
    .update(payload).digest('hex');
  
  if (signature !== `v0=${hash}`) {
    return res.status(401).send('Invalid signature');
  }

  // Handle event
  const { event, payload } = req.body;
  console.log(`Received: ${event}`);
  
  res.status(200).send();
});

常见事件

事件	描述
meeting.started	会议已开始
meeting.ended	会议已结束
meeting.participant_joined	参会者已加入会议
recording.completed	云端录制已就绪
user.created	已添加新用户

详细参考

• references/events.md - 完整的事件类型参考
• references/verification.md - Webhook URL 验证
• references/subscriptions.md - 事件订阅 API

故障排查

• RUNBOOK.md - 深入调试前的 5 分钟预检查
• troubleshooting/common-issues.md - 签名验证、重试、URL 验证

示例仓库

官方（由 Zoom 提供）

类型	仓库	Stars
Node.js	webhook-sample	34
PostgreSQL	webhook-to-postgres	5
Go/Fiber	Go-Webhooks	-
Header Auth	zoom-webhook-verification-headers	-

社区

语言	仓库	描述
Laravel	binary-cats/laravel-webhooks	Laravel Webhook 处理器
AWS Lambda	splunk/zoom-webhook-to-hec	无服务器转发至 Splunk HEC
Node.js	Will4950/zoom-webhook-listener	Webhook 转发器
Express+Redis	ojusave/eventSubscriptionPlayground	Socket.io + Redis

多语言示例（由 tanchunsiong 提供）

语言	仓库
Node.js	Zoom-Webhook-Signature-OAuth-and-REST-API-Development-Sample-In-NodeJS
C#	Zoom-Webhook-Signature-OAuth-and-REST-API-Development-Sample-In-ASP.NET-Core-C-
Java	Zoom-Webhook-Signature-OAuth-and-REST-API-Development-Sample-In-Java-Spring-Boot
Python	Zoom-Webhook-Signature-OAuth-and-REST-API-Development-Sample-In-Python
PHP	Zoom-Webhook-Signature-OAuth-and-REST-API-Development-Sample-In-PHP

完整列表：请参阅 general/references/community-repos.md

资源

• Webhook 文档：https://developers.zoom.us/docs/api/webhooks/
• 事件参考：https://developers.zoom.us/docs/api/rest/reference/zoom-api/events/
• 开发者论坛：https://devforum.zoom.us/

环境变量

• 请参阅 references/environment-variables.md，了解标准化的 .env 键名以及每个值的获取位置。