Slack 應用指南

OOMOL 支援你連接一次 Slack workspace，並透過已批准的工具呼叫，把經過授權的 Slack 工具提供給支援的 AI Agent 和可重複使用 Skills。本文說明如何安裝和連接 Slack 應用、OOMOL 會使用哪些 Slack 權限、可以用它完成什麼、常見問題如何排查，以及如何移除應用。

OOMOL 要求使用者先登入，再連接外部帳號。如需安裝 Slack 應用，請先登入 OOMOL，開啟 Slack 連接頁面，然後點擊 Connect 進入 Slack OAuth 授權流程。

在 OOMOL 中連接 Slack

前置條件

• 一個 OOMOL 帳號。
• 一個屬於目標 workspace 的 Slack 帳號。
• 擁有在該 workspace 中安裝或授權 Slack app 的權限。
• 可以存取 OOMOL Console。
• 如果你的 Slack workspace 限制 app 安裝，可能需要 Slack workspace owner 或 administrator 先審核 OOMOL 應用。

新增應用

1. 登入 OOMOL Console。
2. 開啟 Slack App Connections 頁面，或進入 App Connections 並搜尋 Slack。
3. 選擇 Slack，然後點擊 Connect。
4. OOMOL 會跳轉到 Slack。如有提示，請登入 Slack。
5. 如果 Slack 要求選擇 workspace，請選擇你要連接的 Slack workspace。
6. 檢查 Slack 授權頁面，包括要求的權限。
7. 點擊 Allow 授權 OOMOL。
8. Slack 跳回 OOMOL 後，確認 Slack 已顯示為已連接。

如果任一步驟失敗，請查看常見問題排查。

授權後，OOMOL 會儲存呼叫 Slack 工具所需的連接資訊。之後，你就可以在 OOMOL 支援的 Agent 和可重複使用 Skills 中，透過已批准的工具呼叫使用 Slack 工具。

OOMOL 在 Slack 中做什麼

連接 workspace 後，OOMOL Slack 應用會提供可用的 Slack 動作。根據你執行的動作不同，OOMOL 可以讀取已連接 app 可存取的 channels 和 threads，以 OOMOL app 身分傳送訊息、回覆 threads、定時傳送訊息、上傳檔案、開啟 direct messages，以及新增或移除 emoji reactions。

安裝完成後，OOMOL 不會自行開始使用 Slack。只有當已授權使用者、可重複使用 Skill、支援的 Agent 動作或已批准的 OOMOL 工具呼叫帶著必要目標和內容呼叫 Slack 工具時，Slack 工具才會執行。

安裝後的下一步

Slack 跳回 OOMOL 後，請先在 OOMOL Console 中確認 Slack 連接已顯示為 connected。之後你可以：

• 如果要在支援的 AI Agent 環境中使用已連接的 Slack 工具，設定 oo CLI。
• 使用測試頻道列出可見 Slack channels、讀取最近訊息、傳送 demo message、回覆 thread、上傳 demo file，或新增測試 reaction。
• 如果要讓 OOMOL 讀取或傳送到某個 private channel，並且你的 workspace 原則要求 app 必須在頻道內，請先把 OOMOL app 邀請到該 channel。

使用方式

Slack 工具需要先連接 Slack workspace 後才能使用。OOMOL 中展示的具體工具列表可能隨 connector 更新而變化；目前 Slack connector 包含讀取 conversations、讀取 threads、傳送訊息、回覆 threads、定時傳送訊息、管理 bot 已傳送訊息、處理檔案、讀取使用者資訊、開啟 direct messages，以及管理 emoji reactions 等工具。

透過 oo CLI 使用 Slack 工具

如果你要在支援的 AI Agent 環境中使用已連接的 Slack 工具，請在登入 OOMOL 後安裝並設定 oo CLI。

1. 登入 OOMOL Console。
2. 開啟 oo CLI 安裝頁面。
3. 按照頁面中的說明操作。該頁面會提供一鍵複製的提示詞，用於在支援的 AI Agent 環境中安裝並設定 oo CLI。
4. 完成 oo CLI 設定，並在 OOMOL 中連接 Slack 後，就可以讓 Agent 使用已連接的 Slack 工具處理 demo channels、messages 和 files。

具體 prompt 可以根據 Agent 環境調整。例如，你可以讓 Agent 列出可見 Slack channels、讀取測試頻道最近訊息、傳送 demo message、在 thread 中回覆，或給測試訊息新增 reaction。

使用的權限

OOMOL 使用 Slack 權限，讓已授權的 Slack 使用者可以把 workspace 作為一個 App 連接到 OOMOL，然後把經過授權的 Slack 工具提供給 Agent 和可重複使用 Skills。

Slack OAuth 授權頁面中顯示的具體 scopes 是目前安裝的準確資訊。根據 workspace 啟用的工具不同，OOMOL 可能要求以下權限類別：

如果 Slack 管理員沒有授予某個必要權限，Slack 連接可能失敗，或依賴該權限的工具無法使用，直到該權限被授予。

支援的 Slack 工具

讀取 conversations 和 threads

使用情境：讓 Agent 在總結更新、提取 action items、準備回覆，或把工作轉交給其他已連接工具前，查看近期 Slack 訊息或某個 thread。

前置條件：

• 已在 OOMOL 中連接 Slack。
• 已連接 Slack app 可以存取目標 conversation 或 thread。
• Agent、Skill 或工具呼叫已經取得正確的 channel、conversation、message 或 thread identifier。

工具行為：

• 讀取已連接 Slack app 可見的 conversation metadata、最近訊息和 thread replies。
• 傳回透過已連接 workspace 授權可取得的 Slack 資料。
• 唯讀操作不會傳送、更新、刪除訊息，也不會新增 reaction。

傳送和管理訊息

使用情境：讓 Agent 在任務完成後傳送狀態更新、回覆 thread、安排提醒、向某個使用者傳送 ephemeral message，或更新 bot 已傳送的訊息。

前置條件：

• 已在 OOMOL 中連接 Slack。
• 目標 channel、conversation、user、message 或 thread 已確定。
• 使用者、Skill 或 Agent 已經提供訊息內容，並確認傳送目標。

工具行為：

• 在提供內容後傳送 plain-text messages 或 Block Kit messages。
• 在提供 parent message 後回覆已有 threads。
• 當 Slack 接受目標和 timestamp 時，安排未來傳送訊息。
• 只有在已連接 app 有權限管理目標訊息時，才會更新或刪除訊息。

處理檔案和 reactions

使用情境：讓 Agent 在 Slack 中分享檔案、檢查 file metadata，或新增 reaction 來標記某則訊息已確認、已排隊、已完成或需要跟進。

前置條件：

• 已在 OOMOL 中連接 Slack。
• 目標 conversation、file、message 或 reaction name 已確定。
• 檔案上傳需要提供 connector runtime 可以存取的 URL。

工具行為：

• 在提供 file URL 和目標後上傳檔案到 Slack。
• 讀取已連接 app 可見的 file metadata 和 reactions。
• 在 Slack 允許已連接 app 操作時，新增或移除 reactions。
• 只有在已連接 app 有權限刪除目標檔案時，才會刪除檔案。

測試應用

你可以使用一個允許安裝 app 的 Slack workspace 測試 Slack 應用。建議使用測試頻道和 demo messages，這樣可以安全測試讀取、傳送、更新、檔案和 reaction 動作。

範例測試 prompts

• List Slack public channels visible to the connected app.
• Get recent messages from the #oomol-test channel.
• Post Hello from OOMOL to the #oomol-test channel.
• Reply to the latest test message with Received.
• Add the white_check_mark reaction to a test message.
• Get reactions for the test message.
• Schedule a Slack message in the test channel for later today.
• Upload a demo file to the test channel.
• List Slack users visible to the connected app.
• Open a direct message with a test user.

測試時請只使用 demo data，不要在測試 prompt 中使用真實客戶、員工或機密 Slack 內容。

常見問題排查

無法新增 Slack 應用

• 確認你登入的是正確的 OOMOL 帳號。
• 確認你正在登入想要連接的 Slack workspace。
• 如果你的 Slack workspace 需要 app approval，請讓 Slack workspace owner 或 administrator 審核 OOMOL 應用。
• 如果 OOMOL 中已有失敗或不完整的 Slack 連接，先中斷它，再重新連接。
• 如果問題仍然存在，請聯絡 OOMOL 支援，並附上 OOMOL 帳號電子郵件、Slack workspace 名稱或 ID、嘗試連接的時間、錯誤訊息或截圖。

Slack 工具找不到 channel 或 conversation

• 確認已連接 Slack app 可以存取目標 conversation。
• 如果目標是 private channel，請確認已連接 app 已加入該 channel，或擁有所需 workspace 權限。
• 確認要求使用了正確的 conversation ID、channel name 或搜尋輸入。
• 如果你最近調整過 Slack 權限，請在 OOMOL 中重新連接 Slack，以重新整理授權狀態。

Slack 工具無法讀取訊息

• 確認已連接 Slack app 有權限讀取目標 conversation history。
• 如果訊息在 private channel 中，請確認 app 已在該 private channel 中。
• 檢查要求是否使用了正確的 message timestamp、thread timestamp 或 conversation ID。
• 如果 workspace 最近修改過 app scopes 或 channel access，請在 OOMOL 中重新連接 Slack。

Slack 工具無法傳送或更新訊息

• 確認已連接 Slack app 可以在目標 conversation 中傳送訊息。
• 確認工具呼叫具有有效的目標和訊息內文。
• 對於 update 和 delete 動作，確認目標訊息由已連接 Slack app 傳送，並且可由該 app 管理。
• 如果 Slack 傳回 workspace policy 或 permission error，請讓 Slack workspace owner 或 administrator 檢查 app 權限。

Slack 檔案動作失敗

• 對於上傳動作，確認 file URL 可由 connector runtime 存取。
• 確認已連接 Slack app 可以存取目標 conversation。
• 對於刪除動作，確認已連接 app 有權限刪除目標檔案。

移除應用

你可以從 OOMOL 或 Slack 任一側移除 Slack 應用。如果你不再希望 OOMOL 存取 Slack，建議兩邊都移除。

從 OOMOL 移除 Slack

1. 登入 OOMOL Console。
2. 開啟 Connections。
3. 在已連接應用中找到 Slack。
4. 開啟 Slack 連接詳情。
5. 選擇 Disconnect、Remove，或 OOMOL 介面中顯示的等效移除操作。
6. 確認移除。

從 Slack 移除 OOMOL

1. 登入已連接 workspace 中的 Slack。
2. 開啟 Manage apps，或進入該 workspace 的 Slack app management 頁面。
3. 找到 OOMOL。
4. 開啟應用詳情。
5. 選擇 remove、uninstall 或 revoke app 的操作。
6. 確認移除。

如果你沒有在 Slack 中移除 app 的權限，請讓 Slack workspace owner 或 administrator 移除該應用。

移除後的影響

• 移除或取消授權 Slack 連接後，OOMOL 將無法再為你的 workspace 使用 Slack 工具。
• 依賴 Slack 的 Agent、Skills 或其他任務可能會失敗，直到你重新連接 Slack。
• 移除前已建立的 Slack 訊息、檔案、channels 和 reactions 會保留在 Slack 中，除非你在 Slack 中刪除或修改它們。
• 移除應用不會刪除你的 OOMOL 帳號。

資料處理

OOMOL 只會在 Slack 使用者授權應用，並且使用者、Skill 或已批准的 Agent 動作需要使用 Slack 時存取 Slack 資料。OOMOL 只會為了提供透過 OOMOL 支援的 Agent、可重複使用 Skills 和已批准工具呼叫要求的 Slack 工具而使用 Slack 資料。

• Slack OAuth tokens 會被加密儲存。
• OOMOL 不會向 AI Agent、提示詞、瀏覽器用戶端、應用程式碼或終端使用者暴露 Slack OAuth token。
• 當 Slack 工具被呼叫時，OOMOL 可能會處理 Slack workspace metadata、conversation metadata、messages、thread replies、files、user metadata 和 reactions。
• Slack 資料只會在必要時儲存在使用者可見的工具結果、使用記錄、執行歷史或營運記錄中。
• 儲存的資料會靜態加密，並透過 TLS/SSL 傳輸。
• OOMOL 不會出售你的 Slack 資料。
• OOMOL 不會將 Slack 資料用於廣告。
• OOMOL 不會使用客戶私有內容訓練 AI 模型。
• 作為該 connector 的一部分，OOMOL 不會在背景下持續同步或複製 Slack workspace 資料。只有當已授權使用者、Skill 或已批准的 Agent 動作呼叫 Slack 工具時，OOMOL 才會存取 Slack 資料。
• 當你移除或取消授權 Slack 應用後，OOMOL 會停止使用已撤銷的 Slack 授權，並按照正常連接移除流程刪除或失效化已儲存的 Slack 授權 token。
• 某些日誌、支援記錄、安全記錄或帳務相關記錄可能會按照隱私權政策中的說明保留。

FAQ

是否需要付費 Slack workspace？

大多數 OOMOL Slack 工具只要求 Slack workspace 允許要求的 app 權限。部分 Slack 功能、app approval controls、retention settings 或 workspace policies 可能取決於你的 Slack 方案或組織設定。

可以連接多個 Slack workspace 嗎？

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

連接後 Agent 會自動使用 Slack 嗎？

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

連接後 OOMOL 會讀取所有 Slack 訊息嗎？

OOMOL 按需存取 Slack 資料：已授權使用者、Skill 或已批准的 Agent 動作針對已連接 App 可存取的 conversation 呼叫工具時，才會讀取或修改對應資料。

OOMOL 可以刪除 Slack 訊息或檔案嗎？

目前 Slack connector 包含刪除 bot 已傳送訊息的動作，以及在已連接 app 被允許時刪除檔案的動作。只有當使用者或已批准的工具呼叫使用支援的 delete tool，並提供必要目標資訊時，OOMOL 才會刪除 Slack 內容。

聯絡支援

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

• 電子郵件：support@oomol.com
• 支援頁面：https://oomol.com/zh-tw/support/

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