将你的 Zoom 账户连接到 Okou，以便管理会议，并通过聊天处理会议信息。本指南涵盖 Zoom 用户自主管理连接器。Zoom Admin 和 Zoom AI 是单独的连接器。
开始之前
- 登录 Okou，并确保你拥有一个允许连接的 Zoom 账户。
- 你的 Zoom 账户管理员可能需要批准该应用或其权限。
- 面向外部分发的 Zoom 审批正在等待中。在获得批准之前，可用性受 Zoom 的应用共享规则限制；在 Okou 中找到该连接器并不会绕过这些规则。
- 云录制需要符合条件的 Zoom 套餐、已启用云录制以及已完成的录制。转录内容必须已经由 Zoom 生成。网络研讨会功能需要相应的 Zoom 许可和访问权限。
- 在评估变更或删除会议时，请使用测试账户和测试会议。不要使用客户会议进行测试。
添加应用
- 打开 Okou Connectors。
- 在 Discover 中，在 Find connectors 里输入 Zoom。
- 在 Meetings and scheduling 下方的 Zoom 卡片上选择 Connect Zoom。本指南不要选择 Zoom Admin 或 Zoom AI。
- 将打开 Zoom 授权窗口。使用你希望 Okou 访问其会议的 Zoom 账户登录。
- 查看应用名称和请求的权限。选择 Allow 继续，或选择 Decline 取消。共享访问权限为可选项；除非你的任务需要，否则请保持关闭。
- 返回 Okou，确认该账户显示为已连接。**My Okou：**查看已连接账户和命名权限。**Legacy Agents：**同时选择可能使用 Zoom 的智能体。选择请求中提供的访问时长。
- 在 My Okou 中打开你自己的聊天，或在 Legacy Agents 中打开与所选智能体的聊天。询问 List my upcoming Zoom meetings 以检查连接。对于新账户，空的会议列表也是有效结果。
连接你的账户与授予 Okou 访问权限是两个独立步骤。Legacy Agents 还会使用 Agent 授权。其他团队成员的 Zoom 连接不会让你访问那个人的账户。
在聊天中使用 Zoom
Okou 会在连接账户的 Zoom 访问权限以及你授予的 Okou 权限范围内（在 Legacy Agents 中还包括 Agent 授权），执行你请求的任务。请清楚说明会议、时区和预期操作。
| 功能 | 示例请求 | 前提条件和结果 |
|---|---|---|
| 列出会议 | 列出我即将开始的 Zoom 会议。 | 已获授权的 Zoom 账户。返回会议主题、时间、ID 以及可用的加入链接。 |
| 查看会议 | 显示 Zoom 会议 [meeting ID] 的详细信息。 | 对该会议具有访问权限。返回可用的会议信息。 |
| 安排会议 | 创建一个名为 Review test、时长为 30 分钟的 Zoom 会议，时间为明天 Asia/Shanghai 时区 10:00。不要邀请任何人。 | 具有创建会议的权限。返回会议 ID、时间和加入链接。 |
| 更新会议 | 将我的 Zoom 会议 [meeting ID] 改到 Asia/Shanghai 时区 11:00，并将时长改为 45 分钟。 | 你有权管理的会议。更新指定字段。 |
| 删除会议 | 仅删除测试用的 Zoom 会议 [meeting ID]。 | 你有权删除的会议。删除会取消指定会议；请求前请先核对 ID。 |
| 结束正在进行的会议 | 结束我的测试 Zoom 会议 [meeting ID]。 | 由你主持且你有权结束的正在进行中的会议。为参会者结束该实时会议。 |
| 过往会议详情 | 显示我已结束的测试 Zoom 会议 [meeting UUID] 的详细信息。 | 已结束的会议，以及对其数据的访问权限。历史会议实例使用 Zoom 的会议 UUID。 |
| 过往参会者 | 列出我已结束的测试 Zoom 会议 [meeting UUID] 的参会者。 | 对已结束会议参会者数据的访问权限。是否可用取决于 Zoom 账户权限和保留策略。 |
| 查找录制 | 查找我从 [date] 到 [date] 的 Zoom 云录制。 | 具有云录制访问权限，且该时间段内存在录制。每次请求的时间范围不得超过 30 天。 |
| 查看录制文件 | 显示 Zoom 会议 [meeting ID] 可用的录制文件。 | 可访问的已完成云录制。返回 Zoom 提供的可用文件。 |
| 读取可用转录 | 读取我的测试 Zoom 录制 [meeting ID] 的现有转录文本。 | Zoom 已生成转录文件，且你有权访问该文件。这不会启用录制，也不会创建缺失的转录文本。 |
| 列出网络研讨会 | 列出我可以访问的网络研讨会。 | 启用了网络研讨会功能的 Zoom 账户，以及相应权限。 |
| 查看网络研讨会 | 显示 Zoom 网络研讨会 [webinar ID] 的详细信息。 | 对该网络研讨会具有访问权限。该连接器可读取网络研讨会信息；不会创建或修改网络研讨会。 |
权限和数据
用户自主管理的集成会请求上述功能所需的个人资料、会议、过往参与者、云录制和网络研讨会权限。个人资料访问用于识别你连接的账户。会议写入权限支持安排、更新、删除和结束会议；录制和网络研讨会权限支持读取可访问的信息和文件。
Okou 会在平台上加密存储 OAuth 凭证，并在服务器端刷新访问令牌。凭证会在网络边界注入到连接器请求中，而不是以环境变量的形式提供给 agent 代码。在 Okou 聊天中，集成不需要你的 Zoom 密码。
为某项任务检索到的会议信息、参与者信息或录制/转录内容，可能会显示在你的 Okou 聊天中，以及你要求 Okou 创建的文档或其他工件中。不要将断开账户视为删除此前已保存的聊天结果或工件。有关收集、使用、保留、删除及你的数据权利，请参见 Privacy Policy；有关账户授权和权限控制，请参见 权限。
移除应用
若要停止未来使用并从 Okou 中移除连接：
- 在 Okou 中打开 连接器 并选择 已连接。
- 找到 Zoom，并打开 管理 Zoom 账户。
- 选择你要移除的账户，然后选择 Disconnect。查看受影响的账户并确认。
- 确认该账户不再显示为已连接。后续任务需要另一个已连接账户或新的授权。
同时在 Zoom 中撤销提供方授权：
- 使用同一个 Zoom 账户登录 Zoom 应用市场。
- 根据 Marketplace 界面，打开 My library 或 Manage > Added Apps。
- 找到这个 Okou 应用，打开其移除控制项，然后选择 Remove。确认移除。
在 Legacy Agents 中，移除某一个智能体的授权只会移除该智能体的访问权限；它不会让你的 Zoom 账户与所有其他已授权智能体断开连接。断开连接或卸载此应用不会从 Zoom 中删除会议或录制。如果你也想删除这些资源，请使用 Zoom 自己的控制项。
若要请求删除 Okou 中保留的、源自 Zoom 的数据，请从与你的 Okou 账户关联的邮箱联系 [email protected]。请说明相关账户以及涉及的聊天或工件；切勿包含密码或访问令牌。请求将依据 Privacy Policy 处理，包括任何适用的法定保留义务。
故障排除
- **Zoom 拒绝安装或提示应用不可用：**请与你的 Zoom 账户管理员确认应用审批和共享资格。在 Zoom 批准之前，外部分发不可用。
- **授权被拒绝或窗口被关闭：**返回连接器；如果连接按钮仍处于忙碌状态，请刷新页面，然后重新开始授权。已取消的尝试不会建立连接。
- **已连接，但 Okou 请求权限：**请为预期的智能体和具体请求的操作进行授权。仅连接并不会授予每个智能体访问权限。
- **账户错误：**在授权期间选择正确的 Zoom 账户。如有必要，在重新连接前先在 Okou 中管理或断开该账户。
- **需要重新连接：**从账户控制项重新连接。令牌可能已过期，或授权已被撤销。不要将令牌粘贴到聊天中。
- **没有会议、录制或网络研讨会：**检查已连接账户、日期范围、会议所有权、Zoom 许可，以及该资源是否存在。空结果并不能证明连接失败。
- **缺少转录或录制：**等待 Zoom 处理完成，并检查是否已在 Zoom 中启用录制/转录。Okou 无法检索 Zoom 尚未生成或尚未开放访问的文件。
- **速率限制或提供方错误：**等待 Zoom 指示的时间间隔。在重试创建或更改会议之前，请先检查原始操作的结果，以避免重复。
如需帮助，请使用 support page 或通过 [email protected] 发送邮件，并附上操作、近似时间、错误消息和相关测试会议 ID。请排除凭证和私人会议内容。
