Zoom 應用指南
OOMOL 支援你連接一次 Zoom 帳號,然後在支援的 AI Agent 和 OOMOL 工作流中使用 Zoom 工具。本文說明如何新增 Zoom 應用、OOMOL 會使用哪些權限、可以用它完成什麼、常見問題如何排查,以及如何移除應用。
前置條件
- 一個 OOMOL 帳號。
- 一個允許授權第三方應用的 Zoom 帳號。
- 可以存取 OOMOL Console。
- 如果你的 Zoom 組織限制 Marketplace 應用,可能需要 Zoom 管理員先允許 OOMOL 應用。
新增應用
- 登入 OOMOL Console。
- 開啟 連接服務,或直接存取 Connections。
- 搜尋 Zoom。
- 選擇 Zoom,然後點擊 Connect。
- OOMOL 會跳轉到 Zoom。如有提示,請登入 Zoom。
- 檢查 Zoom 授權頁面,包括請求的權限。
- 點擊 Allow 授權 OOMOL。
- Zoom 跳回 OOMOL 後,確認 Zoom 已顯示為已連接。
如果任一步驟失敗,請查看常見問題排查。
授權後,OOMOL 會儲存呼叫 Zoom 工具所需的連接資訊。之後,你就可以在 OOMOL 支援的 Agent 和工作流中使用 Zoom 工具。
使用方式
Zoom 工具需要先連接 Zoom 帳號後才能使用。OOMOL 中展示的具體工具列表可能隨 connector 更新而變化;目前 Zoom connector 包含讀取 Zoom 使用者資料、列出會議、建立會議、更新會議等工具。
使用的權限
OOMOL 使用這些 Zoom scopes,讓已授權的 Zoom 帳號管理員可以把 Zoom 作為一個 App 連接到 OOMOL,然後把經過授權的 Zoom 會議工具提供給他們的 AI Agent 和可重複使用 Skills。
Required scopes:
| Zoom scope | 對應工具 | OOMOL 使用原因 |
|---|---|---|
user:read:user:admin | Get User | 在 OAuth 授權後識別已連接的 Zoom 帳號,並在 OOMOL 中顯示已授權的 Zoom 使用者。OOMOL 使用這些資訊展示帳號歸屬、管理已連接的 App 連接,並記錄工具執行時使用的是哪個 Zoom 帳號。 |
meeting:write:meeting:admin | Create Meeting | 透過 OOMOL Tools 建立 Zoom 會議。使用者或 Agent 可以請求建立會議,OOMOL 會使用已授權的 Zoom 帳號建立該會議。 |
Optional scopes:
| Zoom scope | 對應工具 | OOMOL 使用原因 |
|---|---|---|
meeting:read:list_meetings:admin | List Meetings | 當使用者要求 Agent 尋找或列出已授權 Zoom 使用者的既有會議時使用。OOMOL 使用該權限,讓 Zoom Tools 可以在使用者選擇會議進行檢視或後續操作前展示既有會議資訊。 |
meeting:update:meeting:admin | Update Meeting | 當使用者要求 Agent 更新既有 Zoom 會議時使用,例如修改會議主題、開始時間、時長或相關會議設定。如果未授予這個 optional scope,會議更新操作將不可用。 |
如果使用者或 Zoom 管理員沒有授予某個 optional scope,Zoom 連接仍可能存在,但依賴該 scope 的工具可能不可用,或在使用時失敗,直到該權限被授予。
支援的 Zoom 工具
| 工具 | 支援的功能 | 常見使用情境 | 前置條件 |
|---|---|---|---|
| Get User | 讀取已授權 Zoom 使用者的基礎資料。 | 在 Agent 或工作流使用 Zoom 前,確認目前連接的是哪個 Zoom 帳號。 | 已在 OOMOL 中連接 Zoom,且已連接的 Zoom 帳號處於可用狀態。 |
| List Meetings | 取得已授權 Zoom 帳號可存取的會議。 | 在準備議程、提醒、後續事項或相關工作流前,檢視即將開始的 Zoom 會議。 | 已在 OOMOL 中連接 Zoom,且已連接的 Zoom 帳號有權限檢視請求的會議。 |
| Create Meeting | 為已授權的 Zoom 帳號建立會議。 | 安排客戶會議、專案同步、面試、課程或內部審查。 | 已在 OOMOL 中連接 Zoom,該帳號可以建立會議,且工作流已取得必要的會議資訊。 |
| Update Meeting | 更新既有 Zoom 會議的詳情。 | 修改會議主題、開始時間、時長、時區、議程或其他支援的會議設定。 | 已在 OOMOL 中連接 Zoom,該帳號可以更新目標會議,且工作流已取得會議 ID 和更新後的會議資訊。 |
Get User
使用情境:在 Agent 或工作流使用 Zoom 前,確認目前連接的是哪個 Zoom 帳號。如果你管理多個 Zoom 帳號,或正在做初始設定,這個工具很有用。
前置條件:
- 已在 OOMOL 中連接 Zoom。
- 已連接的 Zoom 帳號處於可用狀態。
工具行為:
- 讀取已授權 Zoom 使用者的基礎資訊。
- 不會建立、更新或刪除 Zoom 會議。
List Meetings
使用情境:讓 Agent 檢視即將開始的 Zoom 會議,用於準備議程、建立提醒、規劃後續事項,或與日曆、專案管理工具協同。
前置條件:
- 已在 OOMOL 中連接 Zoom。
- 已連接的 Zoom 帳號有權限檢視請求的會議。
工具行為:
- 取得已授權 Zoom 帳號可存取的會議。
- 傳回 Zoom 向該授權使用者開放的會議中繼資料,例如會議主題、排程資訊,以及在可用時傳回的入會資訊。
- 不會修改會議。
Create Meeting
使用情境:讓 Agent 在工作流中安排 Zoom 會議,例如建立客戶會議、專案同步、面試、課程或內部審查。
前置條件:
- 已在 OOMOL 中連接 Zoom。
- 已連接的 Zoom 帳號有權限建立會議。
- Agent 或工作流已經取得必要的會議資訊,例如主題、日期、時間、時區和會議設定。
工具行為:
- 根據輸入,為已授權的 Zoom 帳號建立會議。
- 傳回 Zoom 提供的會議資訊,例如可用時傳回會議 ID 和入會連結。
- 除非目前 OOMOL 工作流同時使用郵件、日曆等其他已連接應用傳送邀請,否則該工具本身不會邀請參會人。
Update Meeting
使用情境:當計畫發生變化時,讓 Agent 更新既有 Zoom 會議,例如修改會議主題、開始時間、時長、時區、議程或其他支援的會議設定。
前置條件:
- 已在 OOMOL 中連接 Zoom。
- 已連接的 Zoom 帳號有權限更新目標會議。
- Agent 或工作流已經取得會議 ID 和更新後的會議資訊。
工具行為:
- 根據輸入,為已授權的 Zoom 帳號更新既有會議。
- 不會建立新會議。
- 不會刪除會議。
常見問題排查
無法新增 Zoom 應用
- 確認你登入的是正確的 OOMOL 帳號。
- 確認你正在登入想要連接的 Zoom 帳號。
- 如果 Zoom 帳號屬於某個組織,請詢問 Zoom 管理員:第三方 Marketplace 應用或 OOMOL 應用是否需要管理員審批。
- 如果 OOMOL 中已有失敗或不完整的 Zoom 連接,先中斷它,再重新連接。
- 如果問題仍然存在,請聯絡 OOMOL 支援,並附上 OOMOL 帳號電子郵件、Zoom 帳號電子郵件、嘗試連接的時間、錯誤訊息或截圖。
Zoom 工具找不到會議
- 確認已連接的 Zoom 帳號有權限存取該會議。
- 確認工作流使用了正確的日期範圍、時區、會議 ID 或搜尋輸入。
- 如果你最近調整過 Zoom 權限,請在 OOMOL 中重新連接 Zoom,以重新整理授權狀態。
Zoom 工具無法建立會議
- 確認已連接的 Zoom 帳號可以直接在 Zoom 中建立會議。
- 檢查會議開始時間、時長、時區和必填欄位是否有效。
- 如果 Zoom 帳號由組織管理,請確認組織政策允許透過已授權應用建立會議。
Zoom 工具無法更新會議
- 確認已連接的 Zoom 帳號擁有該會議,或有權限更新該會議。
- 確認工作流使用了正確的會議 ID。
- 檢查更新後的欄位是否符合 Zoom 要求,例如開始時間、時長、時區和議程。
- 如果該更新權限在 Zoom 中被設定為 optional,請重新連接 Zoom,並在出現提示時授予該權限。
移除應用
你可以從 OOMOL 或 Zoom 任一側移除 Zoom 應用。如果你不再希望 OOMOL 存取 Zoom,建議兩邊都移除。
從 OOMOL 移除 Zoom
- 登入 OOMOL Console。
- 開啟 Connections。
- 在已連接應用中找到 Zoom。
- 開啟 Zoom 連接詳情。
- 選擇 Disconnect、Remove,或 OOMOL 介面中顯示的等效移除操作。
- 確認移除。
從 Zoom 移除 OOMOL
- 登入你的 Zoom 帳號,並開啟 Zoom App Marketplace。
- 開啟 Manage。
- 開啟 Added Apps,或搜尋 OOMOL。
- 選擇 OOMOL 應用。
- 點擊 Remove。
移除後的影響
- 移除或取消授權 Zoom 連接後,OOMOL 將無法再為你的帳號使用 Zoom 工具。
- 依賴 Zoom 的工作流或 Agent 可能會失敗,直到你重新連接 Zoom。
- 移除前已建立的 Zoom 會議會保留在 Zoom 中,除非你在 Zoom 中刪除這些會議。
- 移除應用不會刪除你的 OOMOL 帳號。
資料處理
OOMOL 只會在 Zoom 帳號管理員授權應用,並且使用者或已批准的 Agent 動作需要使用 Zoom 時存取 Zoom 資料。OOMOL 只會為了提供透過 OOMOL 支援的 Agent、可重複使用 Skills 和工作流請求的 Zoom 工具而使用 Zoom 資料。
- Zoom OAuth tokens 會被加密儲存。
- OOMOL 不會向 AI Agent、提示詞、瀏覽器用戶端、應用程式碼或終端使用者暴露 Zoom OAuth token。
- 當 Zoom 工具被呼叫時,OOMOL 可能會處理 Zoom 使用者資料和會議中繼資料。
- Zoom 會議和使用者資料只會在必要時儲存在使用者可見的工具結果、使用記錄、執行歷史或營運記錄中。
- 儲存的資料會靜態加密,並透過 TLS/SSL 傳輸。
- OOMOL 不會出售你的 Zoom 資料。
- OOMOL 不會將 Zoom 資料用於廣告。
- OOMOL 不會使用客戶私有內容訓練 AI 模型。
- 除非你另外使用了會明確下載或儲存相關內容的 OOMOL 工作流,否則該 connector 不會儲存 Zoom 會議音訊、視訊、轉錄文字或錄製檔案。
- 當你移除或取消授權 Zoom 應用後,OOMOL 會停止使用已撤銷的 Zoom 授權,並按照正常連接移除流程刪除或失效化已儲存的 Zoom 授權 token。
- 某些日誌、支援記錄、安全記錄或帳單相關記錄可能會按照隱私權政策中的說明保留。
FAQ
是否需要付費 Zoom 帳號?
大多數 OOMOL Zoom 工具只要求 Zoom 帳號具備相應權限即可授權。部分 Zoom 功能可能取決於你的 Zoom 方案或組織政策。
可以連接多個 Zoom 帳號嗎?
請在 OOMOL Console 中查看你的帳號或 workspace 目前支援的連接選項。如果你需要處理多個 Zoom 帳號,可以聯絡支援團隊。
連接後 Agent 會自動使用 Zoom 嗎?
連接 Zoom 會讓 Zoom 工具在 OOMOL 中可用,但是否呼叫工具仍取決於你選擇的 Agent、工作流和權限。基於帳號的服務仍然需要你的授權。
聯絡支援
如果你在新增、使用或移除 Zoom 應用時需要協助,請聯絡 OOMOL 支援:
請附上你的 OOMOL 帳號電子郵件、相關 Zoom 帳號電子郵件、你正在執行的操作,以及錯誤訊息或截圖。
Wanta