name: zoom-automation description: 通过Rube MCP(Composio)自动化Zoom会议创建、管理、录制、网络研讨会和参与者跟踪。始终先搜索工具以获取当前模式。 requires: mcp: [rube] category: automation
通过Rube MCP实现Zoom自动化
通过Composio的Zoom工具包,自动化Zoom操作,包括会议调度、网络研讨会管理、云录制检索、参与者跟踪和使用报告。
工具包文档: composio.dev/toolkits/zoom
前提条件
- Rube MCP必须已连接(RUBE_SEARCH_TOOLS可用)
- 通过
RUBE_MANAGE_CONNECTIONS与工具包zoom建立活跃的Zoom连接 - 始终先调用
RUBE_SEARCH_TOOLS以获取当前工具模式 - 大多数功能需要付费Zoom账户(Pro计划或更高)
设置
获取Rube MCP: 在客户端配置中添加https://rube.app/mcp作为MCP服务器。无需API密钥——只需添加端点即可工作。
- 通过确认
RUBE_SEARCH_TOOLS响应,验证Rube MCP可用 - 使用工具包
zoom调用RUBE_MANAGE_CONNECTIONS - 如果连接不活跃,请按照返回的认证链接完成Zoom OAuth
- 在运行任何工作流前,确认连接状态显示为活跃
核心工作流
1. 创建和调度会议
使用时机: 用户希望创建具有特定时间、持续时间和设置的新Zoom会议
工具序列:
ZOOM_GET_USER- 验证认证用户并检查许可证类型[前提条件]ZOOM_CREATE_A_MEETING- 创建具有主题、时间、持续时间和设置的会议[必需]ZOOM_GET_A_MEETING- 检索完整会议详情,包括加入链接[可选]ZOOM_UPDATE_A_MEETING- 修改会议设置或重新调度[可选]ZOOM_ADD_A_MEETING_REGISTRANT- 为启用注册的会议注册参与者[可选]
关键参数:
userId: 对于用户级应用,始终使用"me"topic: 会议主题行type:1(即时),2(调度),3(无固定时间的重复),8(有固定时间的重复)start_time: ISO 8601格式(UTC使用yyyy-MM-ddTHH:mm:ssZ或带时区字段的yyyy-MM-ddTHH:mm:ss)timezone: 时区ID(例如"America/New_York")duration: 持续时间(分钟)settings__auto_recording:"none"、"local"或"cloud"settings__waiting_room: 布尔值以启用等候室settings__join_before_host: 布尔值(当等候室启用时自动禁用)settings__meeting_invitees: 包含电子邮件地址的邀请对象数组
常见问题:
start_time必须为未来时间;Zoom内部存储和返回时间均为UTC,无论输入时区- 如果类型
2未设置start_time,则变为即时会议,30天后过期 - 参与者的
join_url和主持人的start_url来自创建响应——请持久保存 start_url在2小时后过期(或对于custCreate用户为90天)- 会议创建受速率限制,每天100个请求
- 设置名称使用双下划线表示嵌套(例如
settings__host_video)
2. 列出和管理会议
使用时机: 用户希望查看即将举行、进行中或过去的会议
工具序列:
ZOOM_LIST_MEETINGS- 按类型列出会议(调度的、进行中的、即将到来的、过去的)[必需]ZOOM_GET_A_MEETING- 获取特定会议的详细信息[可选]ZOOM_UPDATE_A_MEETING- 修改会议详情[可选]
关键参数:
userId: 对于认证用户使用"me"type:"scheduled"(默认)、"live"、"upcoming"、"upcoming_meetings"、"previous_meetings"page_size: 每页记录数(默认30)next_page_token: 来自先前响应的分页令牌from/to: 日期范围过滤器
常见问题:
ZOOM_LIST_MEETINGS排除即时会议,仅显示未过期的调度会议- 对于过去会议,使用
type: "previous_meetings" - 分页: 始终遵循
next_page_token直到为空以获取完整结果 - 令牌过期:
next_page_token在15分钟后过期 - 会议ID可能超过10位数字;存储为长整数而非标准整数
3. 管理录制
使用时机: 用户希望列出、检索或删除云录制
工具序列:
ZOOM_LIST_ALL_RECORDINGS- 在日期范围内列出用户的所有云录制[必需]ZOOM_GET_MEETING_RECORDINGS- 获取特定会议的录制[可选]ZOOM_DELETE_MEETING_RECORDINGS- 将录制移至垃圾箱或永久删除[可选]ZOOM_LIST_ARCHIVED_FILES- 列出归档的会议/网络研讨会文件[可选]
关键参数:
userId: 对于认证用户使用"me"from/to: 日期范围,yyyy-mm-dd格式(最大1个月范围)meetingId: 特定录制的会议ID或UUIDaction: 删除时的"trash"(可恢复)或"delete"(永久)include_fields: 设置为"download_access_token"以获取下载录制的JWTtrash: 设置为true以从垃圾箱列出录制
常见问题:
- 日期范围最大为1个月;API自动调整
from如果超出范围 - 必须在账户上启用云录制
- 以
/开头或包含//的UUID必须双重URL编码 ZOOM_DELETE_MEETING_RECORDINGS默认操作为"trash"(可恢复);"delete"为永久- 下载URL需要OAuth令牌在Authorization头中以访问密码保护的录制
- 需要Pro计划或更高
4. 获取会议参与者和报告
使用时机: 用户希望查看谁参加了过去会议或获取使用统计
工具序列:
ZOOM_GET_PAST_MEETING_PARTICIPANTS- 列出已完成会议的与会者[必需]ZOOM_GET_A_MEETING- 获取会议详情和注册信息以供即将举行的会议[可选]ZOOM_GET_DAILY_USAGE_REPORT- 获取每日使用统计(会议、参与者、分钟数)[可选]ZOOM_GET_A_MEETING_SUMMARY- 获取AI生成的会议摘要[可选]
关键参数:
meetingId: 会议ID(最新实例)或UUID(特定发生)page_size: 每页记录数(默认30)next_page_token: 大型参与者列表的分页令牌
常见问题:
ZOOM_GET_PAST_MEETING_PARTICIPANTS仅适用于付费计划的已完成会议- 单人会议(无其他参与者)返回空结果
- UUID编码: 以
/开头或包含//的UUID必须双重编码 - 始终使用
next_page_token分页直到为空,以避免遗漏与会者 ZOOM_GET_A_MEETING_SUMMARY需要启用AI Companion的付费计划;免费账户会收到400错误ZOOM_GET_DAILY_USAGE_REPORT有重速率限制;避免频繁调用
5. 管理网络研讨会
使用时机: 用户希望列出网络研讨会或为网络研讨会注册参与者
工具序列:
ZOOM_LIST_WEBINARS- 列出调度或即将到来的网络研讨会[必需]ZOOM_GET_A_WEBINAR- 获取详细网络研讨会信息[可选]ZOOM_ADD_A_WEBINAR_REGISTRANT- 为网络研讨会注册参与者[可选]
关键参数:
userId: 对于认证用户使用"me"type:"scheduled"(默认)或"upcoming"page_size: 每页记录数(默认30)next_page_token: 分页令牌
常见问题:
- 网络研讨会功能需要Pro计划或更高,并附加网络研讨会附加组件
- 免费/基本账户无法使用网络研讨会工具
- 仅显示未过期的网络研讨会
- 必须在网络研讨会上启用注册,
ZOOM_ADD_A_WEBINAR_REGISTRANT才能工作
常见模式
ID解析
- 用户ID: 对于用户级应用,始终使用
"me"指代认证用户 - 会议ID: 数字ID(存储为长整数);用于最新实例
- 会议UUID: 用于重复会议的具体发生;如果以
/开头或包含//,则双重编码 - 发生ID: 用于重复会议以针对特定发生
分页
大多数Zoom列表端点使用基于令牌的分页:
- 遵循
next_page_token直到为空或缺失 - 令牌在15分钟后过期
- 设置明确的
page_size(默认30,因端点而异) - 不要使用
page_number(许多端点已弃用)
时间处理
- Zoom内部将所有时间存储为UTC
- 提供
timezone字段与start_time一起用于本地时间输入 - 使用ISO 8601格式:
yyyy-MM-ddTHH:mm:ssZ(UTC)或yyyy-MM-ddTHH:mm:ss(带时区字段) - 仅日期字段使用
yyyy-mm-dd格式
已知问题
计划要求
- 大多数录制和参与者功能需要Pro计划或更高
- 网络研讨会功能需要网络研讨会附加组件
- AI会议摘要需要启用AI Companion功能
- 归档文件需要Zoom支持启用“会议和网络研讨会归档”
速率限制
- 会议创建: 每天100个请求,24小时内每个会议100次更新
ZOOM_GET_PAST_MEETING_PARTICIPANTS: 中等节流;批量处理时添加延迟ZOOM_GET_DAILY_USAGE_REPORT: 重速率限制ZOOM_GET_A_MEETING、ZOOM_GET_MEETING_RECORDINGS: 轻度速率限制ZOOM_LIST_MEETINGS、ZOOM_LIST_ALL_RECORDINGS: 中等速率限制
参数特性
- 嵌套设置使用双下划线表示法(例如
settings__waiting_room) start_url在2小时后过期;如需使用,通过API续期join_before_host在waiting_room为true时自动禁用- 重复会议字段(
recurrence__*)仅适用于类型3和8 password字段最大10个字符,仅允许字母数字和@、-、_、*
快速参考
| 任务 | 工具代号 | 关键参数 |
|---|---|---|
| 创建会议 | ZOOM_CREATE_A_MEETING |
userId、topic、start_time、type |
| 获取会议详情 | ZOOM_GET_A_MEETING |
meetingId |
| 更新会议 | ZOOM_UPDATE_A_MEETING |
meetingId、要更新的字段 |
| 列出会议 | ZOOM_LIST_MEETINGS |
userId、type、page_size |
| 获取用户信息 | ZOOM_GET_USER |
userId |
| 列出录制 | ZOOM_LIST_ALL_RECORDINGS |
userId、from、to |
| 获取录制 | ZOOM_GET_MEETING_RECORDINGS |
meetingId |
| 删除录制 | ZOOM_DELETE_MEETING_RECORDINGS |
meetingId、action |
| 过去参与者 | ZOOM_GET_PAST_MEETING_PARTICIPANTS |
meetingId、page_size |
| 每日使用报告 | ZOOM_GET_DAILY_USAGE_REPORT |
日期参数 |
| 会议摘要 | ZOOM_GET_A_MEETING_SUMMARY |
meetingId |
| 列出网络研讨会 | ZOOM_LIST_WEBINARS |
userId、type |
| 获取网络研讨会 | ZOOM_GET_A_WEBINAR |
网络研讨会ID |
| 注册会议 | ZOOM_ADD_A_MEETING_REGISTRANT |
meetingId、参与者详情 |
| 注册网络研讨会 | ZOOM_ADD_A_WEBINAR_REGISTRANT |
网络研讨会ID、参与者详情 |
| 列出归档文件 | ZOOM_LIST_ARCHIVED_FILES |
from、to |
由Composio提供支持