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

# 缩放集成
<a name="zoom-integration"></a>

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

Amazon Quick 支持 Zoom 的多种身份验证方法。选择最适合您组织安全要求的方法。
+ **默认 OAuth 应用程序**-使用 AWS由托管的 OAuth 应用程序。无需其他凭证。用户直接使用自己的 Zoom 账户进行身份验证。
+ **自定义 OAuth 应用程序** — 使用在 Zoom App Marketplace 中注册的由客户管理的 OAuth 应用程序。此选项可让您的组织完全控制 OAuth 配置。

有关 Amazon Quick 支持的身份验证方法的更多信息，请参阅[身份验证方法](quick-action-auth.md)。

## 开始前的准备工作
<a name="zoom-integration-prerequisites"></a>

在设置集成之前，请确保您具备以下条件。
+ 一个活跃的 Zoom 账户，可以访问您想要使用的会议、录音和网络研讨会。
+ 对于**自定义 OAuth 应用程序**：访问 Zoom 网站上的 [Zoom App Marketplace](https://marketplace.zoom.us/) 以创建应用程序。
+ 有关 Amazon Quick 订阅要求，请参阅[在控制台中设置集成](integration-console-setup-process.md)。

## 配置缩放
<a name="zoom-source-setup"></a>

如果您使用的是**默认 OAuth 应用程序**身份验证，请跳过本节并继续。[在 Amazon Quick 中设置连接器](#zoom-quicksuite-setup)

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

### 创建 Zoom 应用程序（自定义 OAuth 应用程序）
<a name="zoom-register-oauth"></a>

在 Zoom App Marketplace 中创建应用程序以获取 Amazon Quick 所需的客户证书。如需了解更多信息，请参阅 Zoom 开发者网站上的 [OAuth](https://developers.zoom.us/docs/integrations/oauth/)。

1. 在 Zoom 网站上登录 [Zoom App Market](https://marketplace.zoom.us/) place，然后前往应用程序创建门户。

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

1. 在 “**基本信息**” 选项卡的 “**应用程序凭证**” 下，记录以下值。在配置 Amazon Quick 时，您需要它们。
   + **客户端 ID**
   + **客户端密钥**

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

1. 选择 “**范围**” 选项卡，然后选择 “**\+ 添加范围**” 以选择您的集成所需的权限。有关推荐的范围，请参阅[推荐瞄准镜](#zoom-oauth-scopes)。

### 推荐瞄准镜
<a name="zoom-oauth-scopes"></a>

连接到 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 中设置连接器
<a name="zoom-quicksuite-setup"></a>

### 从 “可用” 选项卡连接
<a name="zoom-quick-connect"></a>

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

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

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

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

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

### 从 “为你的团队创建” 选项卡创建
<a name="zoom-full-setup"></a>

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

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

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

1. 找到并选择 “**缩放**”。
**注意**  
如果 Zoom 连接器已经存在，则会出现一个包含现有连接器的对话框。要使用现有的连接器，请选择它。要创建新的，请选择 “**否，新建**”。

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

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

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

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

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

   1. 对于**自定义 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 快速回传网址。

1. 选择**下一步**。

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

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

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

1. 选择**发布**。

## 可用操作
<a name="zoom-integration-actions"></a>

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


**缩放可用操作**  

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

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

## 管理和故障排除
<a name="zoom-integration-troubleshooting"></a>

要编辑、共享或删除您的连接器，请参阅[管理现有集成](integration-workflows.md#managing-existing-integrations)。

### 身份验证问题
<a name="zoom-troubleshooting-auth"></a>
+ **Sign-in 失败（默认 OAuth 应用程序或自定义 OAuth 应用程序）**— 确认您的 Zoom 账户处于活动状态，并且可以直接在 [Zoom 网站上登录 zoom.us。](https://zoom.us)对于自定义 OAuth 应用程序，请确认您的 Zoom 应用程序中的重定向 URI 与 Amazon Quick 回传网址相匹配。
+ **无效的客户端凭证（自定义 OAuth 应用程序）**-验证客户端 ID 和客户端密钥是否与 Zoom 应用程序中的值相匹配。您可以在 Zoom App Marketplace 的应用程序设置中查看您的凭证。
+ **权限不足**-验证为 Zoom 应用程序配置的范围是否包含您要使用的操作所需的权限。请参阅[推荐瞄准镜](#zoom-oauth-scopes)。