Zoom自动化Skill zoom-automation

这个技能通过Rube MCP和Composio的Zoom工具包,自动化Zoom会议创建、管理、录制、网络研讨会和参与者跟踪,适用于需要高效管理Zoom操作的用户。关键词包括Zoom自动化、会议调度、录制管理、参与者跟踪、Composio、API集成、自动化工作流。

DevOps 0 次安装 0 次浏览 更新于 3/8/2026

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密钥——只需添加端点即可工作。

  1. 通过确认RUBE_SEARCH_TOOLS响应,验证Rube MCP可用
  2. 使用工具包zoom调用RUBE_MANAGE_CONNECTIONS
  3. 如果连接不活跃,请按照返回的认证链接完成Zoom OAuth
  4. 在运行任何工作流前,确认连接状态显示为活跃

核心工作流

1. 创建和调度会议

使用时机: 用户希望创建具有特定时间、持续时间和设置的新Zoom会议

工具序列:

  1. ZOOM_GET_USER - 验证认证用户并检查许可证类型[前提条件]
  2. ZOOM_CREATE_A_MEETING - 创建具有主题、时间、持续时间和设置的会议[必需]
  3. ZOOM_GET_A_MEETING - 检索完整会议详情,包括加入链接[可选]
  4. ZOOM_UPDATE_A_MEETING - 修改会议设置或重新调度[可选]
  5. 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. 列出和管理会议

使用时机: 用户希望查看即将举行、进行中或过去的会议

工具序列:

  1. ZOOM_LIST_MEETINGS - 按类型列出会议(调度的、进行中的、即将到来的、过去的)[必需]
  2. ZOOM_GET_A_MEETING - 获取特定会议的详细信息[可选]
  3. 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. 管理录制

使用时机: 用户希望列出、检索或删除云录制

工具序列:

  1. ZOOM_LIST_ALL_RECORDINGS - 在日期范围内列出用户的所有云录制[必需]
  2. ZOOM_GET_MEETING_RECORDINGS - 获取特定会议的录制[可选]
  3. ZOOM_DELETE_MEETING_RECORDINGS - 将录制移至垃圾箱或永久删除[可选]
  4. ZOOM_LIST_ARCHIVED_FILES - 列出归档的会议/网络研讨会文件[可选]

关键参数:

  • userId: 对于认证用户使用"me"
  • from / to: 日期范围,yyyy-mm-dd格式(最大1个月范围)
  • meetingId: 特定录制的会议ID或UUID
  • action: 删除时的"trash"(可恢复)或"delete"(永久)
  • include_fields: 设置为"download_access_token"以获取下载录制的JWT
  • trash: 设置为true以从垃圾箱列出录制

常见问题:

  • 日期范围最大为1个月;API自动调整from如果超出范围
  • 必须在账户上启用云录制
  • /开头或包含//的UUID必须双重URL编码
  • ZOOM_DELETE_MEETING_RECORDINGS默认操作为"trash"(可恢复);"delete"为永久
  • 下载URL需要OAuth令牌在Authorization头中以访问密码保护的录制
  • 需要Pro计划或更高

4. 获取会议参与者和报告

使用时机: 用户希望查看谁参加了过去会议或获取使用统计

工具序列:

  1. ZOOM_GET_PAST_MEETING_PARTICIPANTS - 列出已完成会议的与会者[必需]
  2. ZOOM_GET_A_MEETING - 获取会议详情和注册信息以供即将举行的会议[可选]
  3. ZOOM_GET_DAILY_USAGE_REPORT - 获取每日使用统计(会议、参与者、分钟数)[可选]
  4. 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. 管理网络研讨会

使用时机: 用户希望列出网络研讨会或为网络研讨会注册参与者

工具序列:

  1. ZOOM_LIST_WEBINARS - 列出调度或即将到来的网络研讨会[必需]
  2. ZOOM_GET_A_WEBINAR - 获取详细网络研讨会信息[可选]
  3. 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_MEETINGZOOM_GET_MEETING_RECORDINGS: 轻度速率限制
  • ZOOM_LIST_MEETINGSZOOM_LIST_ALL_RECORDINGS: 中等速率限制

参数特性

  • 嵌套设置使用双下划线表示法(例如settings__waiting_room
  • start_url在2小时后过期;如需使用,通过API续期
  • join_before_hostwaiting_roomtrue时自动禁用
  • 重复会议字段(recurrence__*)仅适用于类型38
  • password字段最大10个字符,仅允许字母数字和@-_*

快速参考

任务 工具代号 关键参数
创建会议 ZOOM_CREATE_A_MEETING userIdtopicstart_timetype
获取会议详情 ZOOM_GET_A_MEETING meetingId
更新会议 ZOOM_UPDATE_A_MEETING meetingId、要更新的字段
列出会议 ZOOM_LIST_MEETINGS userIdtypepage_size
获取用户信息 ZOOM_GET_USER userId
列出录制 ZOOM_LIST_ALL_RECORDINGS userIdfromto
获取录制 ZOOM_GET_MEETING_RECORDINGS meetingId
删除录制 ZOOM_DELETE_MEETING_RECORDINGS meetingIdaction
过去参与者 ZOOM_GET_PAST_MEETING_PARTICIPANTS meetingIdpage_size
每日使用报告 ZOOM_GET_DAILY_USAGE_REPORT 日期参数
会议摘要 ZOOM_GET_A_MEETING_SUMMARY meetingId
列出网络研讨会 ZOOM_LIST_WEBINARS userIdtype
获取网络研讨会 ZOOM_GET_A_WEBINAR 网络研讨会ID
注册会议 ZOOM_ADD_A_MEETING_REGISTRANT meetingId、参与者详情
注册网络研讨会 ZOOM_ADD_A_WEBINAR_REGISTRANT 网络研讨会ID、参与者详情
列出归档文件 ZOOM_LIST_ARCHIVED_FILES fromto

Composio提供支持