---
author: OOMOL
author_url: https://oomol.com/zh-cn/about/
title: Zoom 应用指南
description: 在 OOMOL 中添加、使用、排查和移除 Zoom 应用。
lang: zh-CN
canonical_url: https://oomol.com/zh-cn/docs/zoom/
markdown_url: https://oomol.com/zh-cn/docs/zoom.md
---

# Zoom 应用指南

OOMOL 支持你连接一次 Zoom 账号，然后在支持的 AI Agent 和 OOMOL 工作流中使用 Zoom 工具。本文说明如何添加 Zoom 应用、OOMOL 会使用哪些权限、可以用它完成什么、常见问题如何排查，以及如何移除应用。

## 前置条件

- 一个 OOMOL 账号。
- 一个允许授权第三方应用的 Zoom 账号。
- 可以访问 [OOMOL Console](https://console.oomol.com/)。
- 如果你的 Zoom 组织限制 Marketplace 应用，可能需要 Zoom 管理员先允许 OOMOL 应用。

## 添加应用

1. 登录 [OOMOL Console](https://console.oomol.com/)。
2. 打开 **连接服务**，或直接访问 [Connections](https://console.oomol.com/connections)。
3. 搜索 **Zoom**。
4. 选择 **Zoom**，然后点击 **Connect**。
5. OOMOL 会跳转到 Zoom。如有提示，请登录 Zoom。
6. 检查 Zoom 授权页面，包括请求的权限。
7. 点击 **Allow** 授权 OOMOL。
8. Zoom 跳回 OOMOL 后，确认 Zoom 已显示为已连接。

如果任一步骤失败，请查看[常见问题排查](#常见问题排查)。

授权后，OOMOL 会保存调用 Zoom 工具所需的连接信息。之后，你就可以在 OOMOL 支持的 Agent 和工作流中使用 Zoom 工具。

## 使用方式

Zoom 工具需要先连接 Zoom 账号后才能使用。OOMOL 中展示的具体工具列表可能随 connector 更新而变化；当前 Zoom connector 包含读取 Zoom 用户资料、列出会议、创建会议、更新会议等工具。

### 使用的权限

OOMOL 使用这些 Zoom scopes，让已授权的 Zoom 账号管理员可以把 Zoom 作为一个 App 连接到 OOMOL，然后把经过授权的 Zoom 会议工具提供给他们的 AI Agent 和可复用 Skills。

Required scopes：

| Zoom scope | 对应工具 | OOMOL 使用原因 |
| --- | --- | --- |
| `user:read:user:admin` | Get User | 在 OAuth 授权后识别已连接的 Zoom 账号，并在 OOMOL 中显示已授权的 Zoom 用户。OOMOL 使用这些信息展示账号归属、管理已连接的 App 连接，并记录工具执行时使用的是哪个 Zoom 账号。 |
| `meeting:write:meeting:admin` | Create Meeting | 通过 OOMOL Tools 创建 Zoom 会议。用户或 Agent 可以请求创建会议，OOMOL 会使用已授权的 Zoom 账号创建该会议。 |

Optional scopes：

| Zoom scope | 对应工具 | OOMOL 使用原因 |
| --- | --- | --- |
| `meeting:read:list_meetings:admin` | List Meetings | 当用户要求 Agent 查找或列出已授权 Zoom 用户的已有会议时使用。OOMOL 使用该权限，让 Zoom Tools 可以在用户选择会议进行查看或后续操作前展示已有会议信息。 |
| `meeting:update:meeting:admin` | Update Meeting | 当用户要求 Agent 更新已有 Zoom 会议时使用，例如修改会议主题、开始时间、时长或相关会议设置。如果未授予这个 optional scope，会议更新操作将不可用。 |

如果用户或 Zoom 管理员没有授予某个 optional scope，Zoom 连接仍可能存在，但依赖该 scope 的工具可能不可用，或在使用时失败，直到该权限被授予。

### 支持的 Zoom 工具

| 工具 | 支持的功能 | 常见使用场景 | 前置条件 |
| --- | --- | --- | --- |
| Get User | 读取已授权 Zoom 用户的基础资料。 | 在 Agent 或工作流使用 Zoom 前，确认当前连接的是哪个 Zoom 账号。 | 已在 OOMOL 中连接 Zoom，且已连接的 Zoom 账号处于可用状态。 |
| List Meetings | 获取已授权 Zoom 账号可访问的会议。 | 在准备议程、提醒、后续事项或相关工作流前，查看即将开始的 Zoom 会议。 | 已在 OOMOL 中连接 Zoom，且已连接的 Zoom 账号有权限查看请求的会议。 |
| Create Meeting | 为已授权的 Zoom 账号创建会议。 | 安排客户会议、项目同步、面试、课程或内部评审。 | 已在 OOMOL 中连接 Zoom，该账号可以创建会议，且工作流已获得必要的会议信息。 |
| Update Meeting | 更新已有 Zoom 会议的详情。 | 修改会议主题、开始时间、时长、时区、议程或其他支持的会议设置。 | 已在 OOMOL 中连接 Zoom，该账号可以更新目标会议，且工作流已获得会议 ID 和更新后的会议信息。 |

### Get User

使用场景：在 Agent 或工作流使用 Zoom 前，确认当前连接的是哪个 Zoom 账号。如果你管理多个 Zoom 账号，或正在做初始配置，这个工具很有用。

前置条件：

- 已在 OOMOL 中连接 Zoom。
- 已连接的 Zoom 账号处于可用状态。

工具行为：

- 读取已授权 Zoom 用户的基础信息。
- 不会创建、更新或删除 Zoom 会议。

### List Meetings

使用场景：让 Agent 查看即将开始的 Zoom 会议，用于准备议程、创建提醒、规划后续事项，或与日历、项目管理工具协同。

前置条件：

- 已在 OOMOL 中连接 Zoom。
- 已连接的 Zoom 账号有权限查看请求的会议。

工具行为：

- 获取已授权 Zoom 账号可访问的会议。
- 返回 Zoom 向该授权用户开放的会议元数据，例如会议主题、日程信息，以及在可用时返回的入会信息。
- 不会修改会议。

### Create Meeting

使用场景：让 Agent 在工作流中安排 Zoom 会议，例如创建客户会议、项目同步、面试、课程或内部评审。

前置条件：

- 已在 OOMOL 中连接 Zoom。
- 已连接的 Zoom 账号有权限创建会议。
- Agent 或工作流已经获得必要的会议信息，例如主题、日期、时间、时区和会议设置。

工具行为：

- 根据输入，为已授权的 Zoom 账号创建会议。
- 返回 Zoom 提供的会议信息，例如可用时返回会议 ID 和入会链接。
- 除非当前 OOMOL 工作流同时使用邮件、日历等其他已连接应用发送邀请，否则该工具本身不会邀请参会人。

### Update Meeting

使用场景：当计划发生变化时，让 Agent 更新已有 Zoom 会议，例如修改会议主题、开始时间、时长、时区、议程或其他支持的会议设置。

前置条件：

- 已在 OOMOL 中连接 Zoom。
- 已连接的 Zoom 账号有权限更新目标会议。
- Agent 或工作流已经获得会议 ID 和更新后的会议信息。

工具行为：

- 根据输入，为已授权的 Zoom 账号更新已有会议。
- 不会创建新会议。
- 不会删除会议。

## 常见问题排查

### 无法添加 Zoom 应用

- 确认你登录的是正确的 OOMOL 账号。
- 确认你正在登录想要连接的 Zoom 账号。
- 如果 Zoom 账号属于某个组织，请询问 Zoom 管理员：第三方 Marketplace 应用或 OOMOL 应用是否需要管理员审批。
- 如果 OOMOL 中已有失败或不完整的 Zoom 连接，先断开它，再重新连接。
- 如果问题仍然存在，请联系 OOMOL 支持，并附上 OOMOL 账号邮箱、Zoom 账号邮箱、尝试连接的时间、错误信息或截图。

### Zoom 工具找不到会议

- 确认已连接的 Zoom 账号有权限访问该会议。
- 确认工作流使用了正确的日期范围、时区、会议 ID 或搜索输入。
- 如果你最近调整过 Zoom 权限，请在 OOMOL 中重新连接 Zoom，以刷新授权状态。

### Zoom 工具无法创建会议

- 确认已连接的 Zoom 账号可以直接在 Zoom 中创建会议。
- 检查会议开始时间、时长、时区和必填字段是否有效。
- 如果 Zoom 账号由组织管理，请确认组织策略允许通过已授权应用创建会议。

### Zoom 工具无法更新会议

- 确认已连接的 Zoom 账号拥有该会议，或有权限更新该会议。
- 确认工作流使用了正确的会议 ID。
- 检查更新后的字段是否符合 Zoom 要求，例如开始时间、时长、时区和议程。
- 如果该更新权限在 Zoom 中被配置为 optional，请重新连接 Zoom，并在出现提示时授予该权限。

## 移除应用

你可以从 OOMOL 或 Zoom 任一侧移除 Zoom 应用。如果你不再希望 OOMOL 访问 Zoom，建议两边都移除。

### 从 OOMOL 移除 Zoom

1. 登录 [OOMOL Console](https://console.oomol.com/)。
2. 打开 [Connections](https://console.oomol.com/connections)。
3. 在已连接应用中找到 **Zoom**。
4. 打开 Zoom 连接详情。
5. 选择 **Disconnect**、**Remove**，或 OOMOL 界面中显示的等效移除操作。
6. 确认移除。

### 从 Zoom 移除 OOMOL

1. 登录你的 Zoom 账号，并打开 Zoom App Marketplace。
2. 打开 **Manage**。
3. 打开 **Added Apps**，或搜索 **OOMOL**。
4. 选择 OOMOL 应用。
5. 点击 **Remove**。

## 移除后的影响

- 移除或取消授权 Zoom 连接后，OOMOL 将无法再为你的账号使用 Zoom 工具。
- 依赖 Zoom 的工作流或 Agent 可能会失败，直到你重新连接 Zoom。
- 移除前已创建的 Zoom 会议会保留在 Zoom 中，除非你在 Zoom 中删除这些会议。
- 移除应用不会删除你的 OOMOL 账号。

## 数据处理

OOMOL 只会在 Zoom 账号管理员授权应用，并且用户或已批准的 Agent 动作需要使用 Zoom 时访问 Zoom 数据。OOMOL 只会为了提供通过 OOMOL 支持的 Agent、可复用 Skills 和工作流请求的 Zoom 工具而使用 Zoom 数据。

- Zoom OAuth tokens 会被加密存储。
- OOMOL 不会向 AI Agent、提示词、浏览器客户端、应用代码或终端用户暴露 Zoom OAuth token。
- 当 Zoom 工具被调用时，OOMOL 可能会处理 Zoom 用户资料和会议元数据。
- Zoom 会议和用户数据只会在必要时存储在用户可见的工具结果、使用记录、执行历史或运营记录中。
- 存储的数据会静态加密，并通过 TLS/SSL 传输。
- OOMOL 不会出售你的 Zoom 数据。
- OOMOL 不会将 Zoom 数据用于广告。
- OOMOL 不会使用客户私有内容训练 AI 模型。
- 除非你另外使用了会明确下载或保存相关内容的 OOMOL 工作流，否则该 connector 不会存储 Zoom 会议音频、视频、转写文本或录制文件。
- 当你移除或取消授权 Zoom 应用后，OOMOL 会停止使用已撤销的 Zoom 授权，并按照正常连接移除流程删除或失效化已保存的 Zoom 授权 token。
- 某些日志、支持记录、安全记录或账单相关记录可能会按照[隐私政策](/zh-cn/privacy/)中的说明保留。

## FAQ

### 是否需要付费 Zoom 账号？

大多数 OOMOL Zoom 工具只要求 Zoom 账号具备相应权限即可授权。部分 Zoom 功能可能取决于你的 Zoom 套餐或组织策略。

### 可以连接多个 Zoom 账号吗？

请在 OOMOL Console 中查看你的账号或 workspace 当前支持的连接选项。如果你需要处理多个 Zoom 账号，可以联系支持团队。

### 连接后 Agent 会自动使用 Zoom 吗？

连接 Zoom 会让 Zoom 工具在 OOMOL 中可用，但是否调用工具仍取决于你选择的 Agent、工作流和权限。基于账号的服务仍然需要你的授权。

## 联系支持

如果你在添加、使用或移除 Zoom 应用时需要帮助，请联系 OOMOL 支持：

- 邮箱：[support@oomol.com](mailto:support@oomol.com)
- 支持页面：[https://oomol.com/zh-cn/support/](https://oomol.com/zh-cn/support/)

请附上你的 OOMOL 账号邮箱、相关 Zoom 账号邮箱、你正在执行的操作，以及错误信息或截图。