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

# Slack 應用指南

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

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

[在 OOMOL 中連接 Slack](https://console.oomol.com/connections/slack)

## 前置條件

- 一個 OOMOL 帳號。
- 一個屬於目標 workspace 的 Slack 帳號。
- 擁有在該 workspace 中安裝或授權 Slack app 的權限。
- 可以存取 [OOMOL Console](https://console.oomol.com/)。
- 如果你的 Slack workspace 限制 app 安裝，可能需要 Slack workspace owner 或 administrator 先審核 OOMOL 應用。

## 新增應用

1. 登入 [OOMOL Console](https://console.oomol.com/)。
2. 開啟 [Slack App Connections 頁面](https://console.oomol.com/connections/slack)，或進入 **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](https://console.oomol.com/)。
2. 開啟 [oo CLI 安裝頁面](https://console.oomol.com/install-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 權限範圍 | 對應工具 | OOMOL 使用原因 |
| --- | --- | --- |
| Workspace 和 conversation metadata | List Conversations、List Channels、Get Conversation | 展示已連接 Slack app 可存取的 conversations 和 channels，讓使用者或 Agent 在讀取或傳送前選擇正確目標。 |
| Message history | Get Channel Messages、Get Thread | 當使用者或已批准的 Agent 動作需要上下文時，讀取已連接 Slack app 可見 conversations 中的訊息和 thread replies。 |
| Message posting 和管理 | Post Message、Post Ephemeral Message、Reply Message、Update Message、Schedule Message、Delete Message | 當使用者、Skill 或已批准的 Agent 動作提供內容和目標時，傳送訊息、回覆 threads、定時傳送訊息，並管理已連接 Slack app 傳送的訊息。 |
| File access | Upload File、List Files、Get File、Delete File | 按已批准的工具呼叫要求上傳檔案到 Slack、列出 app 可見檔案、讀取檔案 metadata，或在允許時刪除檔案。 |
| User information 和 direct messages | List Users、Get User、Open Conversation | 識別 app 可見 Slack users，並在使用者、Skill 或 Agent 選擇某個 Slack user 後開啟或恢復 direct-message conversation。 |
| Emoji reactions | Add Reaction、Get Reactions、Remove Reaction | 當使用者、Skill 或已批准的 Agent 動作要求時，為 Slack 訊息新增、讀取或移除 emoji reactions。 |

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

### 支援的 Slack 工具

| 工具 | 支援的功能 | 常見使用情境 | 前置條件 |
| --- | --- | --- | --- |
| List Conversations | 列出已連接 app 可見的 Slack conversations。 | 讓 Agent 在執行後續動作前選擇正確的 channel、private channel、group message 或 direct message。 | 已在 OOMOL 中連接 Slack，且已連接 app 可以存取這些 conversations。 |
| List Channels | 列出已連接 app 可見的公開 Slack channels。 | 為報告、提醒、摘要或後續訊息找到正確公開頻道。 | 已在 OOMOL 中連接 Slack，且公開 channels 對已連接 app 可見。 |
| Get Conversation | 讀取 Slack conversation metadata。 | 在後續動作使用 conversation 前，確認名稱、ID、類型、成員狀態或其他可用 metadata。 | 已在 OOMOL 中連接 Slack，且 conversation 對已連接 app 可見。 |
| Get Channel Messages | 取得 Slack conversation 最近訊息。 | 總結近期更新、收集支援請求，或從測試/已批准工作頻道準備後續事項。 | 已在 OOMOL 中連接 Slack，且已連接 app 可以讀取 conversation history。 |
| Get Thread | 取得 Slack thread 中的訊息。 | 總結討論、準備回覆，或從 thread 中提取 action items。 | 已在 OOMOL 中連接 Slack，且已連接 app 可以讀取該 thread。 |
| Post Message | 使用 plain text 或 Block Kit blocks 傳送 Slack 訊息。 | 向指定頻道傳送狀態更新、提醒、摘要或任務結果。 | 已在 OOMOL 中連接 Slack，目標已確定，且使用者、Skill 或 Agent 提供了訊息內容。 |
| Post Ephemeral Message | 傳送只對 conversation 中某個使用者可見的訊息。 | 向一個 Slack 使用者傳送私密確認或提示，而不公開給所有人。 | 已在 OOMOL 中連接 Slack，目標 conversation 和 user 已確定，且 app 有權限傳送。 |
| Reply Message | 回覆 Slack thread。 | 把任務結果、回答、摘要或後續事項直接補充到已有討論中。 | 已在 OOMOL 中連接 Slack，parent message 已確定，且 app 可以在該 conversation 中傳送。 |
| Update Message | 更新 bot 已傳送的 Slack 訊息。 | 修正、替換或重新整理 bot 傳送的狀態訊息。 | 已在 OOMOL 中連接 Slack，且目標訊息由已連接 app 傳送。 |
| Schedule Message | 定時傳送 Slack 訊息。 | 為未來某個時間安排提醒、交接說明或更新。 | 已在 OOMOL 中連接 Slack，目標和計畫時間有效，且 app 可以在目標位置傳送。 |
| Delete Message | 刪除 bot 已傳送的 Slack 訊息。 | 刪除 bot 傳送的測試訊息、過期提醒或錯誤更新。 | 已在 OOMOL 中連接 Slack，且目標訊息可由已連接 app 刪除。 |
| Upload File | 透過 file URL 上傳檔案到 Slack。 | 向指定 conversation 分享報告、匯出結果、圖片或文件。 | 已在 OOMOL 中連接 Slack，目標已確定，且 file URL 可由 connector runtime 存取。 |
| List Files | 列出已連接 app 可見的 Slack files。 | 在後續動作使用檔案前，尋找某個 channel 或使用者分享的檔案。 | 已在 OOMOL 中連接 Slack，且 app 可以看到要求的檔案。 |
| Get File | 讀取 Slack file metadata。 | 在決定下一步前檢查檔案名稱、擁有者、類型或其他可用 metadata。 | 已在 OOMOL 中連接 Slack，且檔案對已連接 app 可見。 |
| Delete File | 在已連接 app 被允許時刪除 Slack file。 | 當使用者要求清理時，刪除測試檔案或 bot 上傳的檔案。 | 已在 OOMOL 中連接 Slack，且已連接 app 有權限刪除該檔案。 |
| List Users | 列出已連接 app 可見的 Slack users。 | 在傳送 ephemeral message 或開啟 direct message 前找到使用者。 | 已在 OOMOL 中連接 Slack，且 users 對已連接 app 可見。 |
| Get User | 讀取 Slack user metadata。 | 在 Skill 或 Agent 引用某個人前確認正確的 Slack user。 | 已在 OOMOL 中連接 Slack，且 user 對已連接 app 可見。 |
| Open Conversation | 與一個 Slack user 開啟或恢復 direct message。 | 使用者選擇某個 Slack user 後，準備 direct-message 任務。 | 已在 OOMOL 中連接 Slack，且 app 可以開啟或存取該 direct message。 |
| Add Reaction | 給 Slack 訊息新增 emoji reaction。 | 標記訊息已確認、已排隊、已完成或需要跟進。 | 已在 OOMOL 中連接 Slack，且訊息對已連接 app 可見。 |
| Get Reactions | 取得 Slack 訊息 reactions。 | 檢查訊息是否已透過 reaction 被確認或分流。 | 已在 OOMOL 中連接 Slack，且訊息對已連接 app 可見。 |
| Remove Reaction | 移除 Slack 訊息上的 emoji reaction。 | 清除不再準確的 reaction。 | 已在 OOMOL 中連接 Slack，且已連接 app 可以移除該 reaction。 |

### 讀取 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](https://console.oomol.com/)。
2. 開啟 [Connections](https://console.oomol.com/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。
- 某些日誌、支援記錄、安全記錄或帳務相關記錄可能會按照[隱私權政策](/zh-tw/privacy/)中的說明保留。

## 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](mailto:support@oomol.com)
- 支援頁面：[https://oomol.com/zh-tw/support/](https://oomol.com/zh-tw/support/)

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