# Zoom 謄本整合 針對特定 Zoom 使用者主持的會議,在Botpress 中輕鬆接收 Zoom 會議謄本並將其自動化。 ## 如何運作 1.**Zoom 會議結束** → 謄本準備就緒時,Zoom 會發送webhook 。 2.**整合過濾器 `host_id`** → 僅允許指定 Zoom 使用者的事件。 3.** 取得並清理謄本** → 從 Zoom 下載並轉換為純文字。 4.** 發出事件** → 擁有 `meetingUUID` 和 `transcript` 的 `transcriptReceived` 事件可供您的流程使用。 --- ## 使用方法 - ** 觸發工作流程** → 為 `transcriptReceived` 新增「聆聽事件」卡。 - 存取資料** → 在流程中使用 `event.payload.meetingUUID` 和 `event.payload.transcript`。 - ** 儲存謄本** → 儲存到表格,以便稍後進行分析或報告。 --- ## 先決條件 您必須是 - Zoom **帳戶擁有者**、**管理員**,或擁有**「Zoom for Developers」角色**,才能建立 Zoom OAuth App - 使用 **Zoom 高級方案** (免費層級不支援雲端錄影) --- ## 步驟設定 ### 1.建立 Zoom OAuth App - 訪問:[https://marketplace.zoom.us/](https://marketplace.zoom.us/) - 前往 ** 開發 > 建立應用程式** → 選擇 ** 伺服器對伺服器 OAuth** → 命名您的應用程式 - 在 **App Credentials** 頁面,複製: - 帳戶 ID** - 客戶 ID - 用戶端秘密 稍後您會在Botpress 整合設定中使用這些內容。 - 在 **Information** 中,填入您和應用程式的必要資訊。 - 在 **Features** 中,複製 **Secret Token** - 在 **Scopes** 中,新增: cloud_recording:read:list_user_recordings:admin cloud_recording:read:list_recording_files:admin cloud_recording:read:recording:admin - 在 ** 啟用** 標籤下啟用應用程式 ### 2.取得 Zoom `host_id 您可以直接從 Zoom 入口網站找到您的 Zoom `host_id`。 #### 步驟: 1.登入您的 Zoom 帳戶並導航至: **Zoom 管理面板 > 使用者管理 > 使用者** 2.點選您想要取得 `host_id` 的使用者名稱。 3.查看瀏覽器位址列中的 URL。格式如下 https://yourdomain.zoom.us/user/xxxxxxxxxxxxx/profile 您要複製 xxxxxxxxxxxxx,因為那是您的 host_id --- ### 3.設定Botpress 整合 - 將此整合安裝至您的 Bot - 貼上 - `Zoom客戶ID - Zoom客戶秘密 - Zoom 帳戶 ID - `秘密令牌 - 允許的 Zoom 使用者 ID` → 貼上您的 `host_id` (您可以包含多個) 按一下 ** 儲存設定**。 --- ### 4.在 Zoom 中設定Webhook 回到您的 Zoom OAuth App: - 前往 **功能** → 啟用 **事件訂閱** - 名稱:Transcript Received` (也可以選擇不同的名稱) - 方法:Webhook - 端點 URL:使用Botpress 整合 URL** - 新增事件: - 在 **Recording** 下: - 所有錄製已完成 - 錄製轉錄檔已完成 - 按一下 ** 完成** - 按一下端點 URL 旁邊的 **驗證** (您應該會看到已驗證) - 按一下 ** 儲存** --- ## 完成! 當雲端錄音完成時,您的Botpress 機器人現在會收到允許的 Zoom 使用者的謄本。確定 - 您**錄製到雲端** - 您使用的是**付費的 Zoom 計劃** - 您已正確加入所有預期的 `host_id`s