本手册详细说明了如何在 Zoom App Marketplace 配置 Server-to-Server OAuth 应用,以支持 AllianceHub 系统集成 Zoom 会议功能。

1. 准备工作

2. 创建 Server-to-Server OAuth 应用

  1. 登录 Zoom App Marketplace:https://marketplace.zoom.us/
  2. 点击右上角的 Develop 菜单,选择 Build AppZoom Build App
  3. 在应用类型选择页面,找到 Server-to-Server OAuth,点击 CreateCreate Server-to-Server OAuth App
  4. 填写应用名称(例如:AllianceHub Meeting Integration),然后点击 Create填写应用名称

3. 权限管理 (Scopes)

在应用配置页面的 Scopes 标签页中,点击 Add Scopes,添加以下权限以确保 AllianceHub 能正常管理会议和用户。 添加 Scopes

3.1 添加「会议」权限

  • Meeting 分类下,找到并勾选 Create a meeting for a user (用于创建会议) 添加 Scopes
  • Meeting 分类下,找到并勾选 Delete a meeting (用于删除会议) 添加 Scopes
  • Meeting 分类下,找到并勾选 Update a meeting (用于更新会议) 添加 Scopes
  • Meeting 分类下,找到并勾选 View a meeting 添加 Scopes
  • Meeting 分类下,找到并勾选 View a meeting's summary 添加 Scopes

3.2 添加「用户」权限

  • User 分类下,找到并勾选 View a user 添加 Scopes
  • User 分类下,找到并勾选 View a users 添加 Scopes

3.3 添加「录制」权限

  • Recording 分类下,勾选 Returns all of a meeting's recordings. (用于获取会议的所有录制文件) 添加 Scopes
  • Recording 分类下,勾选 View a recording (用于查看录制文件详情) 添加 Scopes

4. 应用激活

  1. 进入 infomation 标签页,激活应用前,需要填写一些联系人信息。
  • Short Description:应用的简单描述。
  • Company Name:应用所属单位的名称。
  • Name:开发者名字。
  • Email: 开发者联系邮箱。
  1. 进入 Activation 标签页。如果应用未激活,点击 Activate your appZoom 应用激活

5. 获取凭证 (App Credentials)

  1. 在应用配置页面的 App Credentials 标签页中,您可以找到 Account IDClient IDClient Secret获取 Zoom App Credentials
  2. 在应用配置页面的 App Feature 标签页中,您可以找到 Secret Token获取 Zoom App Secret Token
  • 注意:请妥善保存这 4 个值,它们需要在 AllianceHub 管理后台的“会议厂商配置”中填入。

6. 用户管理

6.1 进入用户管理页面

  1. 登录 Zoom Web Portal:https://zoom.us/signin
  2. 在左侧导航栏中,点击 Admin -> User Management -> Users

6.2 添加用户

点击 Add Users 按钮,输入用户的邮箱地址并设置相关属性。

Zoom 添加用户

注意:

  1. License 类型:请确保为需要发起会议的用户分配了 Licensed (付费版) 账号,Basic (基础版) 账号的会议时长和功能有限制(通常限时 40 分钟)。
  2. 账号匹配:请记录下成员的邮箱,后续在 AllianceHub 配置 Zoom 会议时,需要使用该邮箱作为发起会议的账号,且该邮箱必须与 AllianceHub 中的用户邮箱一致(或在配置时指定)。
  3. 数据查看:后续在 AllianceHub 发起的 Zoom 会议生成的录屏、纪要等数据,也需要这些成员登录 Zoom 查看。

7. Zoom 会议功能与集成配置

登录 Zoom Web Portal:https://zoom.us/signin

7.1 默认自动开启会议纪要

  1. 在左侧导航栏中,点击 Seetings -> AI Companion -> MeetingZoom 默认自动开启会议纪要
  2. 在左侧导航栏中,点击 ADMIN -> Account Management -> Account Settings -> AI Companion -> MeetingZoom 默认自动开启会议纪要

7.2 允许所有参会人可共享屏幕

  1. 在左侧导航栏中,点击 Seetings -> Meeting -> In Meeting(Basic)Zoom 允许所有参会人可共享屏幕

7.3 允许所有参会人可分享文档

  1. 在左侧导航栏中,点击 Seetings -> Meeting -> In Meeting(Basic)Zoom 允许所有参会人可共享文档

7.4 配置 AllianceHub 转存会议录制视频和会议纪要

  1. 登录 Zoom App Marketplace:https://marketplace.zoom.us/
  2. 点击有上角「Manage」进入 Zoom App 列表页,选择 Zoom App 进入 Zoom App 管理页面 Zoom 配置 AllianceHub 转存会议录制视频和会议纪要
  3. 点击左侧导航栏「Feature」 ,打开 Event Subscriptions Zoom 配置 AllianceHub 转存会议录制视频和会议纪要
  4. 点击 「Add Event Subscription」 Zoom 配置 AllianceHub 转存会议录制视频和会议纪要
  5. 填写回调地址,然后点击「Validate」验证回调地址是否有效
    • 注意:回调地址请联系 AllianceHub 开发团队获取 Zoom 配置 AllianceHub 转存会议录制视频和会议纪要 如下图所示,则验证通过 Zoom 配置 AllianceHub 转存会议录制视频和会议纪要
  6. 点击 「Add Events」添加 Zoom App 订阅事件 Zoom 配置 AllianceHub 转存会议录制视频和会议纪要
    • 添加 Meeting summary has been completed 事件 Zoom 配置 AllianceHub 转存会议录制视频和会议纪要
    • 添加 All Recordings has been Completed 事件 Zoom 配置 AllianceHub 转存会议录制视频和会议纪要