View a markdown version of this page

缩放集成 - Amazon Quick
开始前的准备工作配置缩放在 Amazon Quick 中设置连接器可用操作管理和故障排除

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

缩放集成

使用 Zoom 操作连接器，您可以直接在 Amazon Quick 中通过自然语言访问 Zoom 平台。您无需离开 Amazon Quick 即可创建和管理会议、访问录音和会议摘要、查看网络研讨会详情以及搜索联系人。

Amazon Quick 支持 Zoom 的多种身份验证方法。选择最适合您组织安全要求的方法。

  • 默认 OAuth 应用程序-使用 AWS由托管的 OAuth 应用程序。无需其他凭证。用户直接使用自己的 Zoom 账户进行身份验证。

  • 自定义 OAuth 应用程序 — 使用在 Zoom App Marketplace 中注册的由客户管理的 OAuth 应用程序。此选项可让您的组织完全控制 OAuth 配置。

有关 Amazon Quick 支持的身份验证方法的更多信息，请参阅身份验证方法。

开始前的准备工作

在设置集成之前，请确保您具备以下条件。

  • 一个活跃的 Zoom 账户，可以访问您想要使用的会议、录音和网络研讨会。

  • 对于自定义 OAuth 应用程序：访问 Zoom 网站上的 Zoom App Marketplace 以创建应用程序。

  • 有关 Amazon Quick 订阅要求，请参阅在控制台中设置集成。

配置缩放

如果您使用的是默认 OAuth 应用程序身份验证，请跳过本节并继续。在 Amazon Quick 中设置连接器

要进行自定义 OAuth 应用程序身份验证，请在配置 Amazon Quick 之前在 Zoom App Marketplace 中完成以下步骤。

创建 Zoom 应用程序（自定义 OAuth 应用程序）

在 Zoom App Marketplace 中创建应用程序以获取 Amazon Quick 所需的客户证书。如需了解更多信息，请参阅 Zoom 开发者网站上的 OAuth。

  1. 在 Zoom 网站上登录 Zoom App Market place，然后前往应用程序创建门户。

  2. 创建新的 应用程序。对于基于用户的 OAuth，选择 “常规”，或者选择 OAuth 进行服务到Server-to-Server 服务的身份验证。

  3. 在 “基本信息” 选项卡的 “应用程序凭证” 下，记录以下值。在配置 Amazon Quick 时，您需要它们。

    • 客户端 ID

    • 客户端密钥

  4. 在 OAuth 信息部分的授权重定向 URI 中，添加 Amazon Quick 回传 URL：https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

  5. 选择 “范围” 选项卡，然后选择 “+ 添加范围” 以选择您的集成所需的权限。有关推荐的范围，请参阅推荐瞄准镜。

推荐瞄准镜

连接到 Zoom 时，需要以下示波器。创建自定义 Zoom 应用程序时，请在范围选项卡上添加这些范围。

缩放推荐瞄准镜
Scope 说明
meeting:read:list_meetings 列出会议。
meeting:read:meeting 阅读会议详情。
meeting:read:summary 阅读会议摘要。
meeting:read:list_past_participants 列出过去的会议参与者。
meeting:read:list_past_instances 列出过去的会议实例。
meeting:write:meeting 创建会议。
meeting:update:meeting 更新会议。
meeting:delete:meeting 删除会议。
meeting:write:registrant 添加会议注册者。
cloud_recording:read:list_user_recordings 列出用户录音。
cloud_recording:read:list_recording_files 列出录音文件。
cloud_recording:delete:meeting_recording 删除会议录音。
webinar:read:webinar 阅读网络研讨会详情。
webinar:read:list_webinars 列出网络研讨会。
webinar:read:list_past_participants 列出过去的网络研讨会参与者。
webinar:read:list_registrants 列出网络研讨会注册者。
webinar:write:registrant 添加网络研讨会注册者。
user:read:user 读取用户信息。
user:read:settings 读取用户设置。
user:read:list_collaboration_devices 列出协作设备。
contact:read:list_contacts 列出联系人。
注意

还要求增加白板和市场功能的范围。上面列出的范围包括主要会议、录音、网络研讨会、用户和联系人操作。

在 Amazon Quick 中设置连接器

从 “可用” 选项卡连接

如果要使用默认 OAuth 应用程序身份验证，则无需额外配置即可直接从 “可用” 选项卡进行连接。

  1. 在 Amazon Quick 控制台中，选择连接器。

  2. 在 “可用” 选项卡上，找到 “缩放”，然后选择 Connect。

  3. 完成 Zoom 登录流程并授予所请求的权限。

要改为使用自定义 OAuth 应用程序配置连接器，请使用为团队创建选项卡，如下所述。

从 “为你的团队创建” 选项卡创建

完成所有必需的 Zoom 配置后，请在 Amazon Quick 中创建连接器。

  1. 在 Amazon Quick 控制台中，选择连接器。

  2. 选择 “为你的团队创建” 选项卡。

  3. 找到并选择 “缩放”。

    注意

    如果 Zoom 连接器已经存在，则会出现一个包含现有连接器的对话框。要使用现有的连接器，请选择它。要创建新的，请选择 “否，新建”。

  4. 输入连接器的名称。（可选）选择 + 添加描述以添加描述。

  5. 对于连接类型，选择公共网络。

  6. 对于 OAuth 配置，请选择以下身份验证方法之一并配置必填字段。

    1. 对于默认 OAuth 应用程序：

      无需其他凭证。选择下一步以继续。

    2. 对于自定义 OAuth 应用程序，请配置以下字段：

      • 基本网址（可选）— Zoom API 基础网址。示例：https://api.zoom.us

      • 客户端 ID — 来自您的 Zoom 应用程序的客户端 ID。

      • 客户密钥-来自 Zoom 应用程序的客户端密钥。

      • 令牌网址-令牌端点。示例：https://zoom.us/oauth/token

      • 授权 URL-授权端点。示例：https://zoom.us/oauth/authorize

      • 重定向 URL — Pre-filled 使用 Amazon 快速回传网址。

  7. 选择下一步。

  8. 如果您选择默认 OAuth 应用程序或自定义 OAuth 应用程序，则会打开 Zoom 授权窗口。查看请求的权限并选择 “允许”。

  9. 在 “查看” 页面上，查看连接器的可用操作。选择下一步。

  10. 在 “发布” 页面上，选择谁可以访问连接器。您可以为组织中的所有人启用访问权限，也可以搜索特定的团队或群组。

  11. 选择发布。

可用操作

设置连接器后，可以使用以下操作。

缩放可用操作
类别 处理建议 说明
会议 列出会议 列出用户的会议。
会议 开始会议 检索特定会议的详细信息。
会议 创建会议 创建新会议。
会议 更新会议 更新现有会议。
会议 获取会议摘要 检索会议的 AI-generated 摘要。
会议 列出会议摘要模板 列出可用的会议摘要模板。
会议 获取过去的会议参与者 检索过去会议的参与者。
会议 列出过去的会议实例 列出定期会议的实例。
会议 创建会议注册人 向会议添加注册者。
录音 列出录音 列出用户的所有录音。
录音 获取会议录音 检索特定会议的录音。
录音 列出存档文件 列出存档的录音文件。
网络研讨会 列出网络研讨会 列出用户的网络研讨会。
网络研讨会 获取网络研讨会 检索特定网络研讨会的详细信息。
网络研讨会 列出网络研讨会参与者 列出网络研讨会的参与者。
联系人 搜索公司联系人 在公司目录中搜索联系人。
Devices 列出设备 列出 Zoom 设备。
Reports 获取每日使用量报告 检索每日使用情况报告。
Users 获取用户 检索有关经过身份验证的用户的信息。
注意

您可以使用的操作取决于为您的 Zoom 账户配置的权限以及经过身份验证的用户可访问的数据。

管理和故障排除

要编辑、共享或删除您的连接器，请参阅管理现有集成。

身份验证问题

  • Sign-in 失败（默认 OAuth 应用程序或自定义 OAuth 应用程序）— 确认您的 Zoom 账户处于活动状态，并且可以直接在 Zoom 网站上登录 zoom.us。对于自定义 OAuth 应用程序，请确认您的 Zoom 应用程序中的重定向 URI 与 Amazon Quick 回传网址相匹配。

  • 无效的客户端凭证（自定义 OAuth 应用程序）-验证客户端 ID 和客户端密钥是否与 Zoom 应用程序中的值相匹配。您可以在 Zoom App Marketplace 的应用程序设置中查看您的凭证。

  • 权限不足-验证为 Zoom 应用程序配置的范围是否包含您要使用的操作所需的权限。请参阅推荐瞄准镜。