本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
縮放整合
使用 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 應用程式身分驗證,請先在 Zoom App Marketplace 中完成下列步驟,再設定 Amazon Quick。
建立 Zoom 應用程式 (自訂 OAuth 應用程式)
在 Zoom App Marketplace 中建立應用程式,以取得 Amazon Quick 所需的用戶端登入資料。如需詳細資訊,請參閱 Zoom 開發人員網站上的 OAuth
-
在 Zoom 網站上登入 Zoom App Marketplace
,然後前往應用程式建立入口網站。 -
建立新的 應用程式 針對使用者型 OAuth 選擇一般,或針對服務對服務身分驗證選擇Server-to-Server OAuth。 service-to-service
-
在基本資料索引標籤上的應用程式登入資料下,記錄下列值。您在設定 Amazon Quick 時需要它們。
-
用戶端 ID
-
Client secret (用戶端密碼)
-
-
在 OAuth 資訊區段中,針對授權重新導向 URI,新增 Amazon Quick 回呼 URL:
https://{region}.quicksight.aws.amazon.com/sn/oauthcallback -
選擇範圍索引標籤,然後選擇 + 新增範圍,以選取整合所需的許可。如需建議的範圍,請參閱 建議範圍。
建議範圍
當您連線至 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 中設定連接器
從可用索引標籤連線
如果您想要使用預設 OAuth 應用程式身分驗證,您可以直接從可用索引標籤連線,而不需要其他組態。
-
在 Amazon Quick 主控台中,選擇連接器。
-
在可用索引標籤上,尋找 Zoom 並選擇連線。
-
完成 Zoom 登入流程並授予請求的許可。
若要改為使用自訂 OAuth 應用程式設定連接器,請使用為您的團隊建立索引標籤,如下所述。
從為您的團隊建立索引標籤建立
完成任何必要的 Zoom 組態後,請在 Amazon Quick 中建立連接器。
-
在 Amazon Quick 主控台中,選擇連接器。
-
選擇為您的團隊建立索引標籤。
-
尋找並選擇縮放。
注意
如果 Zoom 連接器已存在,則會顯示一個對話方塊,其中包含您現有的連接器。若要使用現有的連接器,請選擇它。若要建立新的,請選擇否,建立新的。
-
輸入連接器的名稱。或者,選擇 + 新增描述以新增描述。
-
針對連線類型,選擇公有網路。
-
針對 OAuth 組態,選擇下列其中一種身分驗證方法,並設定必要欄位。
-
對於預設 OAuth 應用程式:
不需要額外的登入資料。選擇 Next (下一步) 繼續。
-
對於自訂 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。
-
-
-
選擇下一步。
-
如果您選擇預設 OAuth 應用程式或自訂 OAuth 應用程式,則會開啟 Zoom 授權視窗。檢閱請求的許可,然後選擇允許。
-
在檢閱頁面上,檢閱連接器的可用動作。選擇下一步。
-
在發佈頁面上,選擇誰可以存取連接器。您可以為組織中的每個人啟用存取權,或搜尋特定的團隊或群組。
-
選擇發布。
可用動作
設定連接器之後,可以使用下列動作。
| Category | Action | Description |
|---|---|---|
| 會議 | 列出會議 | 列出使用者的會議。 |
| 會議 | 取得會議 | 擷取特定會議的詳細資訊。 |
| 會議 | 建立會議 | 建立新的會議。 |
| 會議 | 更新會議 | 更新現有的會議。 |
| 會議 | 取得會議摘要 | 擷取 AI 產生的會議摘要。 |
| 會議 | 列出會議摘要範本 | 列出可用的會議摘要範本。 |
| 會議 | 取得過去的會議參與者 | 從過去的會議擷取參與者。 |
| 會議 | 列出過去的會議執行個體 | 列出週期性會議的執行個體。 |
| 會議 | 建立會議註冊者 | 將註冊者新增至會議。 |
| 錄音 | 列出錄製 | 列出使用者的所有錄音。 |
| 錄音 | 取得會議錄製 | 擷取特定會議的錄音。 |
| 錄音 | 列出封存檔案 | 列出封存的錄製檔案。 |
| 網路研討會 | 列出網路研討會 | 列出使用者的網路研討會。 |
| 網路研討會 | 取得網路研討會 | 擷取特定網路研討會的詳細資訊。 |
| 網路研討會 | 列出網路研討會參與者 | 列出網路研討會的參與者。 |
| 聯絡人 | 搜尋公司聯絡人 | 搜尋公司目錄中的聯絡人。 |
| Devices | 列出裝置 | 列出 Zoom 裝置。 |
| 報告 | 取得每日用量報告 | 擷取每日用量報告。 |
| 使用者 | 取得使用者 | 擷取已驗證使用者的相關資訊。 |
注意
您可以使用的動作取決於為 Zoom 帳戶設定的許可,以及已驗證使用者可存取的資料。
管理和疑難排解
若要編輯、共用或刪除連接器,請參閱 管理現有的整合。
驗證問題
-
登入失敗 (預設 OAuth 應用程式或自訂 OAuth 應用程式) – 確認您的 Zoom 帳戶處於作用中狀態,而且您可以直接在 Zoom 網站上登入 zoom.us
。對於自訂 OAuth 應用程式,請確認 Zoom 應用程式中的重新導向 URI 符合 Amazon Quick 回呼 URL。 -
無效用戶端登入資料 (自訂 OAuth 應用程式) – 驗證用戶端 ID 和用戶端秘密是否符合 Zoom 應用程式中的值。您可以從 Zoom App Marketplace 中的應用程式設定檢視您的登入資料。
-
許可不足 – 確認為 Zoom 應用程式設定的範圍包含您要使用的動作所需的許可。請參閱建議範圍。