Zoom 应用集成
本页适用于希望 ScribX 连接到专属 Zoom Marketplace 应用而非共享应用的组织管理员。
如果您只是希望录制自己的 Zoom 会议，请前往此页面 —— 每位成员均需自行连接个人的 Zoom 账号，只需一分钟： 连接您的 Zoom 账号。
Zoom 仅允许能够指明引入者身份的应用入会，因此在发起会议的人连接其 Zoom 账号之前，ScribX 无法加入 Zoom 会议。无论使用何种套餐，也无论是否配置了本文所述的组织级应用，该规则均适用。
添加应用
前提条件
- 拥有至少属于一个团队的 ScribX 账号（如尚未注册，请前往注册）。
- 拥有 Zoom 账号（任意套餐）。如果您的 Zoom 管理员限制了应用安装，可能需要先在 Zoom Marketplace 上预先批准 ScribX。
操作步骤
- 登录 ScribX，打开侧边栏中 Account 下方的 Connections。
- 在 Zoom account 卡片上，点击 Connect Zoom。
- 页面将重定向至 zoom.us，提示您登录（如未登录）并展示 ScribX 请求的权限列表。
- 查看权限并点击 Allow。
- 页面将重定向回 ScribX。此时 Connections 页面上的 Zoom account 卡片将显示为 Connected —— 配置已全部完成。
每位希望 ScribX 代表其自身 Zoom 账号执行操作的团队成员，均需使用各自的 Zoom 登录凭据重复上述步骤；连接按用户独立生效，并在其所在团队间通用。
如果在设置过程中遇到问题，请参见下文的问题排查。
组织管理员配置指南
组织管理员可在 Organization settings → Meeting platforms → Zoom 中选择组织对接的 Zoom Marketplace 应用：
- ScribX app（默认）—— 发布在 Zoom Marketplace 上的 ScribX 共享应用。无需任何配置，成员按照上述步骤直接连接即可。
- Your Zoom app —— 自行接入组织的专属 Zoom OAuth 应用：输入其 Client ID、Client secret 以及（可选的）Webhook 密钥。各团队仍可配置团队级应用予以覆盖。
该面板仅用于确定所使用的应用。该处不会连接任何 Zoom 账号 —— 由于 ScribX 不拥有管理员级别的 Zoom 权限范围，管理员无法代表同事授予同意。包括管理员在内的每位成员，均需严格按照上述步骤在 Connections 中连接自己的账号。
使用集成功能
自动获取录制权限
**使用场景：**通常情况下，当助手加入 Zoom 会议时，主持人必须在会中手动授予其录制权限。连接 Zoom 账号后，ScribX 会向 Zoom 请求本地录制令牌，因此记录员无需询问主持人即可开始录制 —— 并且能够绕过等候室。
**前提条件：**会议由已连接 Zoom 账号的用户主持（或助手由该用户创建），且该账号的套餐支持本地录制令牌。
**预期效果：**ScribX 记录员加入会议，直接绕过等候室被准入，并立即开始录制 —— 主持人端不会弹出权限申请提示。
代表您入会
**使用场景：**ScribX 可以使用与您已连接 Zoom 账号绑定的*代理（on-behalf）*令牌加入会议，从而改善记录员在您所参加会议中的身份标识与准入流程。
**前提条件：**您已连接的 Zoom 账号支持代理令牌（大部分 Zoom 付费套餐均支持），且您本人是会议的参会者。ScribX 会使用启动记录员的用户或会议主持人的账号。系统不会回退使用同事的账号 —— 针对未参会人员生成的令牌会被 Zoom 拒绝，且使用该令牌会导致其名字出现在从未参加的会议中。
**预期效果：**记录员将关联您的账号加入会议，而非显示为完全匿名的参会者。
会议识别
**使用场景：**连接成功后，ScribX 会自动获知您创建的会议（通过 Zoom 的 meeting.created 事件并定期同步您的待开会议），从而将会议自动匹配至您的账号 —— 这也是确保上述两项功能精准匹配正确人员的关键。
**前提条件：**除账号已连接外无其他要求，此过程在后台自动运行。
**预期效果：**您主持的会议会自动归属至您的连接记录下；除相关功能正常生效外，前端无其他显式界面。
移除应用
您可以随时在 Zoom 端断开连接：
- 登录 Zoom App Marketplace。
- 点击 Manage → Added Apps（或访问您的已安装应用列表）。
- 找到 ScribX 并点击 Remove。
移除应用后的影响 —— 在您取消授权的瞬间，Zoom 会向 ScribX 发送通知，ScribX 将立即执行以下操作：
- **删除您的 Zoom OAuth 令牌。**ScribX 将无法再以任何方式访问您的 Zoom 账号。
- 删除从您的 Zoom 账号获取的会议与账号映射关系。
- 在 24 小时内向 Zoom 确认数据已删除（响应 Zoom 的数据合规通知）。
操作完成后，您的 ScribX 连接状态将显示为 Disconnected。移除 Zoom 应用不会删除已捕获的录制记录、转写文字和摘要 —— 它们归属于您的 ScribX 工作区，并遵循所在团队的数据留存设置，您可以随时将其删除。会议将不再享有上述增强功能；但即使没有该集成，派出助手功能仍可正常使用。
使用 Your Zoom app 模式的组织管理员还可以在 Organization settings → Meeting platforms → Zoom → Remove app 中移除组织级应用；届时各团队将回退使用托管的 ScribX 应用。
如需稍后重新连接，只需重复添加应用中的步骤。
问题排查
- 点击 Allow 后页面报错或重定向至失效页面 —— 您的组织可能处于 Your Zoom app 模式且凭据填写不完整。请联系组织管理员检查 Organization settings → Meeting platforms → Zoom，或切换回 ScribX app 模式。
- 找不到连接按钮 —— 按钮位于侧边栏中 Account 下方的 Connections 页面，每位成员均可看到。该按钮不在组织设置中：连接个人账号需由您本人操作，而非由管理员代劳。
- 记录员仍然向主持人申请录制权限 —— 会议主持人尚未连接账号（或主持人的 Zoom 套餐不支持签发本地录制令牌）。请连接主持人的 Zoom 账号，或照常在会中手动授予权限。
- 其他问题 —— 请参阅通用问题排查指南或发送邮件至 support@scribx.app。