---
title: Zoom 應用指南
description: 在 OOMOL 中新增、使用、排查和移除 Zoom 應用。
lang: zh-TW
canonical_url: https://oomol.com/zh-tw/docs/zoom/
markdown_url: https://oomol.com/zh-tw/docs/zoom.md
---

# Zoom 應用指南

OOMOL 支援你連接一次 Zoom 帳號，然後在支援的 AI Agent 和 OOMOL 工作流中使用 Zoom 工具。本文說明如何新增 Zoom 應用、OOMOL 會使用哪些權限、可以用它完成什麼、常見問題如何排查，以及如何移除應用。

## 前置條件

- 一個 OOMOL 帳號。
- 一個允許授權第三方應用的 Zoom 帳號。
- 可以存取 [OOMOL Console](https://console.oomol.com/)。
- 如果你的 Zoom 組織限制 Marketplace 應用，可能需要 Zoom 管理員先允許 OOMOL 應用。

## 新增應用

1. 登入 [OOMOL Console](https://console.oomol.com/)。
2. 開啟 **連接服務**，或直接存取 [Connections](https://console.oomol.com/connections)。
3. 搜尋 **Zoom**。
4. 選擇 **Zoom**，然後點擊 **Connect**。
5. OOMOL 會跳轉到 Zoom。如有提示，請登入 Zoom。
6. 檢查 Zoom 授權頁面，包括請求的權限。
7. 點擊 **Allow** 授權 OOMOL。
8. 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

1. 登入 [OOMOL Console](https://console.oomol.com/)。
2. 開啟 [Connections](https://console.oomol.com/connections)。
3. 在已連接應用中找到 **Zoom**。
4. 開啟 Zoom 連接詳情。
5. 選擇 **Disconnect**、**Remove**，或 OOMOL 介面中顯示的等效移除操作。
6. 確認移除。

### 從 Zoom 移除 OOMOL

1. 登入你的 Zoom 帳號，並開啟 Zoom App Marketplace。
2. 開啟 **Manage**。
3. 開啟 **Added Apps**，或搜尋 **OOMOL**。
4. 選擇 OOMOL 應用。
5. 點擊 **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。
- 某些日誌、支援記錄、安全記錄或帳單相關記錄可能會按照[隱私權政策](/zh-tw/privacy/)中的說明保留。

## FAQ

### 是否需要付費 Zoom 帳號？

大多數 OOMOL Zoom 工具只要求 Zoom 帳號具備相應權限即可授權。部分 Zoom 功能可能取決於你的 Zoom 方案或組織政策。

### 可以連接多個 Zoom 帳號嗎？

請在 OOMOL Console 中查看你的帳號或 workspace 目前支援的連接選項。如果你需要處理多個 Zoom 帳號，可以聯絡支援團隊。

### 連接後 Agent 會自動使用 Zoom 嗎？

連接 Zoom 會讓 Zoom 工具在 OOMOL 中可用，但是否呼叫工具仍取決於你選擇的 Agent、工作流和權限。基於帳號的服務仍然需要你的授權。

## 聯絡支援

如果你在新增、使用或移除 Zoom 應用時需要協助，請聯絡 OOMOL 支援：

- 電子郵件：[support@oomol.com](mailto:support@oomol.com)
- 支援頁面：[https://oomol.com/zh-tw/support/](https://oomol.com/zh-tw/support/)

請附上你的 OOMOL 帳號電子郵件、相關 Zoom 帳號電子郵件、你正在執行的操作，以及錯誤訊息或截圖。
