將你的 Zoom 帳戶連結到 Okou，以便管理會議，並透過聊天處理會議資訊。本指南涵蓋由使用者管理的 Zoom 連接器。Zoom Admin 和 Zoom AI 是獨立的連接器。
開始之前
- 登入 Okou，並準備一個你有權連結的 Zoom 帳戶。
- 你的 Zoom 帳戶管理員可能需要核准此應用程式或其權限。
- Zoom 對外部分發的核准仍在等待中。在核准之前，可用性受 Zoom 的應用程式分享規則限制；在 Okou 中找到此連接器並不會繞過那些規則。
- 雲端錄影需要符合資格的 Zoom 方案、已啟用雲端錄影，以及已完成的錄影。轉錄稿必須已由 Zoom 產生。網路研討會功能需要相關的 Zoom 授權與存取權限。
- 在評估變更或刪除會議時，請使用測試帳戶與測試會議。不要使用客戶會議進行測試。
新增應用程式
- 開啟 Okou Connectors。
- 在 Discover 中，於 Find connectors 輸入 Zoom。
- 在 Meetings and scheduling 下方 Zoom 卡片上，選擇 Connect Zoom。本指南中請勿選擇 Zoom Admin 或 Zoom AI。
- Zoom 授權視窗會開啟。請使用你希望 Okou 存取其會議的 Zoom 帳戶登入。
- 檢查應用程式名稱與所要求的權限。選擇 Allow 以繼續，或選擇 Decline 以取消。共用存取權限為選用；除非你的工作需要，否則請保持停用。
- 返回 Okou，確認該帳戶顯示為已連接。**My Okou：**檢查已連接的帳戶與具名權限。**Legacy Agents：**另行選取可使用 Zoom 的 Agent。選擇此請求提供的存取期限。
- 在 My Okou 中開啟你自己的聊天，或在 Legacy Agents 中開啟與所選 Agent 的聊天。輸入 列出我即將開始的 Zoom 會議，以檢查連接是否正常。對於新帳戶而言，會議清單為空也是有效結果。
連結你的帳戶與授予 Okou 存取權是兩個不同的步驟。舊版代理程式（Legacy Agents）也會使用代理程式授權。其他團隊成員的 Zoom 連結不會讓你存取該成員的帳戶。
在聊天中使用 Zoom
Okou 會在已連結帳戶的 Zoom 存取權，以及你授予的 Okou 權限範圍內執行你要求的工作（在舊版代理程式（Legacy Agents）中包括代理程式授權）。請清楚指定會議、時區與預期動作。
| 功能 | 範例請求 | 前置條件與結果 |
|---|---|---|
| 列出會議 | 列出我即將舉行的 Zoom 會議。 | 已授權的 Zoom 帳戶。回傳會議主題、時間、ID 與可用的加入連結。 |
| 檢視會議 | 顯示 Zoom 會議 [meeting ID] 的詳細資料。 | 可存取該會議。回傳可用的會議資訊。 |
| 排程會議 | 建立一個 30 分鐘的 Zoom 會議，名稱為 Review test，時間為明天 10:00，時區為 Asia/Shanghai。不要邀請任何人。 | 建立會議的權限。回傳會議 ID、時間與加入連結。 |
| 更新會議 | 將我的 Zoom 會議 [meeting ID] 移到 Asia/Shanghai 的 11:00，並將其設為 45 分鐘。 | 你獲准管理的會議。更新指定欄位。 |
| 刪除會議 | 只刪除這個測試 Zoom 會議 [meeting ID]。 | 你可以刪除的會議。刪除會取消指定會議；在提出請求前請先確認 ID。 |
| 結束進行中的會議 | 結束我的測試 Zoom 會議 [meeting ID]。 | 你主持且可以結束的進行中會議。會為參與者結束該場即時會議。 |
| 過去的會議詳細資料 | 顯示我已完成的測試 Zoom 會議 [meeting UUID] 的詳細資料。 | 已完成的會議以及其資料的存取權。歷史實例使用 Zoom 的會議 UUID。 |
| 過去的參與者 | 列出我已完成的測試 Zoom 會議 [meeting UUID] 的參與者。 | 可存取該已完成會議的參與者資料。可用性取決於 Zoom 帳戶權限與保留政策。 |
| 尋找錄影 | 尋找我從 [date] 到 [date] 的 Zoom 雲端錄影。 | 雲端錄影存取權，以及該期間內的錄影。每次請求的期間不得超過 30 天。 |
| 檢視錄影檔案 | 顯示 Zoom 會議 [meeting ID] 可用的錄影檔案。 | 可存取的已完成雲端錄影。回傳 Zoom 提供的檔案。 |
| 讀取可用的轉錄稿 | 讀取我這個測試 Zoom 錄影 [meeting ID] 的現有轉錄稿。 | 已由 Zoom 產生的轉錄稿檔案，以及存取它的權限。這不會啟用錄影，也不會建立缺少的轉錄稿。 |
| 列出網路研討會 | 列出我可存取的網路研討會。 | 啟用網路研討會的 Zoom 帳戶，以及適當的權限。 |
| 檢視網路研討會 | 顯示 Zoom 網路研討會 [webinar ID] 的詳細資料。 | 可存取該網路研討會。此連接器會讀取網路研討會資訊；不會建立或修改網路研討會。 |
權限與資料
此使用者管理的整合會請求個人資料、會議、過去參與者、雲端錄影與網路研討會權限，以支援上述功能。個人資料存取可識別你連結的帳戶。會議寫入權限支援排程、更新、刪除與結束會議；錄影與網路研討會權限支援讀取可存取的資訊與檔案。
Okou 會在平台上以加密方式儲存 OAuth 憑證，並在伺服器端重新整理存取權杖。憑證會在網路邊界注入到連接器請求中，而不是以環境變數提供給 Agent 程式碼。在 Okou 聊天中，這個整合不需要你的 Zoom 密碼。
為某項工作擷取的會議資訊、參與者資訊，或錄影／轉錄內容，可能會出現在你的 Okou 聊天，以及你要求 Okou 建立的文件或其他工件中。不要把解除連結帳戶視為刪除先前已儲存的聊天結果或工件。請參閱 隱私權政策 以了解蒐集、使用、保留、刪除與你的資料權利，並參閱 權限 以了解帳戶授權與權限控制。
移除應用程式
若要停止未來使用並從 Okou 中移除連結：
- 在 Okou 中開啟 連接器，並選取 已連結。
- 找到 Zoom，並開啟 管理 Zoom 帳戶。
- 選取你要移除的帳戶，然後選擇 Disconnect。檢視受影響的帳戶並確認。
- 確認該帳戶已不再列為已連結。未來的工作需要另一個已連結帳戶或新的授權。
也請在 Zoom 中撤銷供應商授權：
- 使用相同的 Zoom 帳戶登入 Zoom App Marketplace。
- 視 Marketplace 介面而定，開啟 My library 或 Manage > Added Apps。
- 找到此 Okou 應用程式，開啟其移除控制項，然後選擇 Remove。確認移除。
在舊版代理程式（Legacy Agents）中，移除某一個代理程式的授權只會移除該代理程式的存取權；不會讓你對所有其他已授權代理程式的 Zoom 帳戶都解除連結。停用或解除安裝此應用程式，不會刪除 Zoom 中的會議或錄影。如果你也想刪除那些資源，請使用 Zoom 自己的控制項。
若要請求刪除 Okou 中保留的 Zoom 衍生資料，請從與你的 Okou 帳戶相關聯的電子郵件寄信至 [email protected]。請指出相關帳戶，以及涉及的聊天或工件；切勿包含密碼或存取權杖。這些請求會依據 隱私權政策 處理，包括任何適用的法定保留義務。
疑難排解
- Zoom 拒絕安裝或表示應用程式不可用： 請向你的 Zoom 帳戶管理員確認應用程式核准與分享資格。在 Zoom 核准之前，無法進行對外部分發。
- 授權遭拒或視窗已關閉： 返回 Connectors；如果連線按鈕仍在忙碌，請重新整理頁面，然後重新開始授權。已取消的嘗試不會建立連線。
- 已連線，但 Okou 要求權限： 請授權預定的代理程式與特定要求的動作。僅有連線並不會授予每個代理程式存取權。
- 帳戶錯誤： 在授權期間選取正確的 Zoom 帳戶。如有需要，請先在 Okou 中管理或解除連結該帳戶，再重新連結。
- 需要重新連結： 請從帳戶控制項重新連結。權杖可能已過期，或授權已被撤銷。不要把權杖貼到聊天中。
- 沒有會議、錄影或網路研討會： 檢查已連結的帳戶、日期範圍、會議擁有者、Zoom 授權，以及資源是否存在。空結果不能證明連線失敗。
- 缺少轉錄稿或錄影： 等待 Zoom 處理完成，並確認已在 Zoom 中啟用錄影／轉錄。Okou 無法擷取 Zoom 尚未產生或尚未開放存取的檔案。
- 速率限制或供應商錯誤： 請等待 Zoom 指示的間隔。在重試建立或變更會議之前，先確認原始操作的結果，以避免重複。
如需協助，請使用 支援頁面 或寄信至 [email protected]，並附上動作、約略時間、錯誤訊息，以及相關的測試會議 ID。請勿包含憑證與私人會議內容。
