本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 縮放整合
<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 應用程式身分驗證，請先在 Zoom App Marketplace 中完成下列步驟，再設定 Amazon Quick。

### 建立 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 Marketplace](https://marketplace.zoom.us/)，然後前往應用程式建立入口網站。

1. 建立新的 應用程式 針對使用者型 OAuth 選擇**一般**，或針對服務對服務身分驗證選擇**Server-to-Server OAuth**。 service-to-service 

1. 在**基本資料**索引標籤上的**應用程式登入**資料下，記錄下列值。您在設定 Amazon Quick 時需要它們。
   + **用戶端 ID**
   + **Client secret** (用戶端密碼)

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 (範圍) | Description | 
| --- | --- | 
| 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. 在**可用**索引標籤上，尋找 **Zoom** 並選擇**連線**。

1. 完成 Zoom 登入流程並授予請求的許可。

若要改為使用自訂 OAuth 應用程式設定連接器，請使用**為您的團隊建立**索引標籤，如下所述。

### 從為您的團隊建立索引標籤建立
<a name="zoom-full-setup"></a>

完成任何必要的 Zoom 組態後，請在 Amazon Quick 中建立連接器。

1. 在 Amazon Quick 主控台中，選擇**連接器**。

1. 選擇**為您的團隊建立**索引標籤。

1. 尋找並選擇**縮放**。
**注意**  
如果 Zoom 連接器已存在，則會顯示一個對話方塊，其中包含您現有的連接器。若要使用現有的連接器，請選擇它。若要建立新的，請選擇**否，建立新的**。

1. 輸入連接器**的名稱**。或者，選擇 **\+ 新增描述**以新增描述。

1. 針對**連線類型**，選擇**公有網路**。

1. 針對 **OAuth 組態**，選擇下列其中一種身分驗證方法，並設定必要欄位。

   1. 對於**預設 OAuth 應用程式**：

      不需要額外的登入資料。選擇 **Next** (下一步) 繼續。

   1. 對於**自訂 OAuth 應用程式**，請設定下列欄位：
      + **基本 URL** （選用） – Zoom API 基本 URL。範例：`https://api.zoom.us`
      + **用戶端 ID** – 來自 Zoom 應用程式的用戶端 ID。
      + **用戶端秘密** – 來自 Zoom 應用程式的用戶端秘密。
      + **權杖 URL** – 權杖端點。範例：`https://zoom.us/oauth/token`
      + **授權 URL** – 授權端點。範例：`https://zoom.us/oauth/authorize`
      + **重新導向 URL** – 預先填入 Amazon Quick 回呼 URL。

1. 選擇**下一步**。

1. 如果您選擇**預設 OAuth 應用程式**或**自訂 OAuth 應用程式**，則會開啟 Zoom 授權視窗。檢閱請求的許可，然後選擇**允許**。

1. 在**檢閱**頁面上，檢閱連接器的可用動作。選擇**下一步**。

1. 在**發佈**頁面上，選擇誰可以存取連接器。您可以為組織中的每個人啟用存取權，或搜尋特定的團隊或群組。

1. 選擇**發布**。

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

設定連接器之後，可以使用下列動作。


**縮放可用的動作**  

| Category | Action | Description | 
| --- | --- | --- | 
| 會議 | 列出會議 | 列出使用者的會議。 | 
| 會議 | 取得會議 | 擷取特定會議的詳細資訊。 | 
| 會議 | 建立會議 | 建立新的會議。 | 
| 會議 | 更新會議 | 更新現有的會議。 | 
| 會議 | 取得會議摘要 | 擷取 AI 產生的會議摘要。 | 
| 會議 | 列出會議摘要範本 | 列出可用的會議摘要範本。 | 
| 會議 | 取得過去的會議參與者 | 從過去的會議擷取參與者。 | 
| 會議 | 列出過去的會議執行個體 | 列出週期性會議的執行個體。 | 
| 會議 | 建立會議註冊者 | 將註冊者新增至會議。 | 
| 錄音 | 列出錄製 | 列出使用者的所有錄音。 | 
| 錄音 | 取得會議錄製 | 擷取特定會議的錄音。 | 
| 錄音 | 列出封存檔案 | 列出封存的錄製檔案。 | 
| 網路研討會 | 列出網路研討會 | 列出使用者的網路研討會。 | 
| 網路研討會 | 取得網路研討會 | 擷取特定網路研討會的詳細資訊。 | 
| 網路研討會 | 列出網路研討會參與者 | 列出網路研討會的參與者。 | 
| 聯絡人 | 搜尋公司聯絡人 | 搜尋公司目錄中的聯絡人。 | 
| Devices | 列出裝置 | 列出 Zoom 裝置。 | 
| 報告 | 取得每日用量報告 | 擷取每日用量報告。 | 
| 使用者 | 取得使用者 | 擷取已驗證使用者的相關資訊。 | 

**注意**  
您可以使用的動作取決於為 Zoom 帳戶設定的許可，以及已驗證使用者可存取的資料。

## 管理和疑難排解
<a name="zoom-integration-troubleshooting"></a>

若要編輯、共用或刪除連接器，請參閱 [管理現有的整合](integration-workflows.md#managing-existing-integrations)。

### 驗證問題
<a name="zoom-troubleshooting-auth"></a>
+ **登入失敗 （預設 OAuth 應用程式或自訂 OAuth 應用程式）** – 確認您的 Zoom 帳戶處於作用中狀態，而且您可以直接在 Zoom 網站上登入 [zoom.us](https://zoom.us)。對於自訂 OAuth 應用程式，請確認 Zoom 應用程式中的重新導向 URI 符合 Amazon Quick 回呼 URL。
+ **無效用戶端登入資料 （自訂 OAuth 應用程式）** – 驗證用戶端 ID 和用戶端秘密是否符合 Zoom 應用程式中的值。您可以從 Zoom App Marketplace 中的應用程式設定檢視您的登入資料。
+ **許可不足** – 確認為 Zoom 應用程式設定的範圍包含您要使用的動作所需的許可。請參閱[建議範圍](#zoom-oauth-scopes)。