什麼是 Zoom 外掛?
Zoom 是一款視訊會議應用。成員可以透過 Jodoo 中的 Zoom 外掛發起會議,並修改會議資訊。
示範
透過在 Jodoo 表單中輸入會議資訊,你可以在 Zoom 中建立會議。
前置條件
若要在 Jodoo 中使用 Zoom 外掛,你必須先建立 Zoom 帳戶。如果你還沒有帳戶,可以註冊 Zoom,或依照以下步驟建立帳戶。Zoom 免費版即可滿足使用需求
如何在 Jodoo 中使用 Zoom 外掛?
步驟 1:在 Zoom 中建立應用
前往 Zoom 的 App Marketplace,點擊頁面右上角的 Develop,再點擊 Build App。
勾選 Server to Server OAuth App,並重新命名。這樣就完成 Zoom 應用程式的建立。
步驟 2:在 Zoom 中設定應用
建立應用程式後,你需要填寫部分資訊,並完成以下設定。
1. 填寫基本資訊
為你的 Zoom 應用命名,並填寫你的資訊以繼續。
2. 功能
不需要新增任何功能,Token 也不需要進行設定。
3. 新增權限範圍
權限範圍會詳細列出 Zoom 外掛可以執行的操作。透過新增對應的權限範圍,你就可以在 Jodoo 中使用相應的功能。
請找到並選取以下權限範圍,以在 Jodoo 中實現 Zoom 外掛的對應功能。
權限範圍 | 標題 | 具體權限 |
會議 | 檢視並管理所有使用者會議 | 更新會議 |
為使用者建立會議 |
|
|
使用者 | 檢視所有使用者資訊 | 檢視使用者 |
4. 啟用你的應用
點擊 Activate your app。
步驟 3:複製應用憑證
建立應用程式後,你可以在 App Credentials 中找到 Account ID、Client ID 和 Client Secret。
請複製並儲存這些資訊。啟用 Zoom 外掛時會需要使用。
步驟 4:安裝並啟用 Zoom 外掛
登入你的 Jodoo 帳戶,並將團隊切換至「開放平台」。
2. 前往「應用市場」,並安裝 Zoom 外掛。
3. 前往「外掛」,並進行設定。
將 Account ID、Client ID 和 Client Secret 複製並填入 Jodoo。請記得勾選「啟用外掛」。
Zoom 外掛可以做什麼?
以下是可用選項:
發起會議:根據使用者在 Jodoo 表單中輸入的會議資訊,在 Zoom 中發起會議。
請求參數
參數 | 是否必填 | 說明 |
主題 | 是 | 新會議的標題。 |
說明 | 否 | 會議議程。此值最多可包含 2,000 個字元。 |
時間 | 是 | 新會議的開始時間。 |
密碼 | 否 | 新會議的密碼。如果未提交密碼,Zoom 會自動產生密碼。最多 10 個字元,且只能包含 |
時長 | 是 | 新會議的時長,以分鐘計算,沒有時間限制。 |
自動錄製 | 是 | 是否開啟錄製,以及要開啟的錄製類型:- 本機錄製- 雲端錄製- 無雲端錄製需要帳戶具備相應的雲端錄製權限。 |
音訊 | 是 | 會議參與者連接音訊的方式:- 電話語音和 VoIP- 電話語音- VoIP- 第三方預設為電話語音和 VoIP。 |
註冊審核 | 是 | 啟用註冊並設定註冊審核方式。請注意,此功能要求主持人為已授權使用者類型。基本使用者無法啟用註冊。預設為無需註冊。授權後,註冊是否通過審核,以及審核方式如下:- 自動核准- 手動核准- 無需註冊 |
會議受邀者核准 | 否 | 會議受邀者的電子郵件地址,多個電子郵件地址請使用英文逗號 |
參與者進入時開啟視訊 | 是 | 新會議開始時,是否自動開啟參與者的視訊:- True:自動開啟視訊- False:不自動開啟視訊預設值為 False。 |
參與者進入時靜音 | 是 | 參與者進入會議時,是否自動將其裝置設為靜音:- True:自動靜音- False:不自動靜音此值預設為 False。 |
允許主持人之前加入 | 是 | 參與者是否可以在主持人之前加入會議。此欄位僅適用於排程會議或週期性會議:- True:允許- False:不允許此值預設為 False。 |
等候室 | 是 | 是否開啟等候室。開啟後,「允許主持人之前加入」參數將停用:- True:允許- False:不允許 |
回應參數
參數 | 說明 |
會議 UUID | 會議的 UUID。 |
會議 ID | 會議的識別 ID。 |
主持人電子郵件 | 會議主持人的電子郵件地址。 |
主題 | 會議主題。 |
會議類型 | 會議類型。 |
狀態 | 會議狀態。 |
開始時間 | 會議開始時間。 |
時長 | 會議時長。 |
加入 URL | 加入會議的 URL。 |
密碼 | 會議密碼。 |
修改會議資訊:透過會議 ID 識別要修改資訊的會議,並根據使用者提交的資訊修改會議資訊。
請求參數
參數 | 是否必填 | 說明 |
會議 ID | 是 | 要修改的會議 ID。 |
說明 | 否 | 修改後的會議說明。 |
備用主持人 | 否 | 備用主持人的電子郵件地址,多個電子郵件地址請使用分號 |
回應參數
參數 | 說明 |
修改資訊 | 呼叫更新會議 API 後回傳的結果。若成功,會回傳 |