Slack 接入需要工作區安裝應用程式的權限和 CDelivery Admin 權限。建議為 CDelivery 建立專用應用程式，分別管理 Bot Token 與 App Token。
建立並設定應用程式
- 在 Slack 應用程式管理建立應用程式，選擇目標工作區。
- 在 OAuth 權限中添加發送消息所需的
chat:write、打開私信所需的im:write，以及讀取私信事件的im:history。 - 需要群內提及時添加
app_mentions:read；需要顯示姓名和頭像時添加users:read。 - 在 Basic Information 建立帶
connections:write的 App-Level Token，得到xapp-開頭的權杖。 - 啟用 Socket Mode，並啟用 Event Subscriptions，訂閱
message.im；需要群內提及時訂閱app_mention。 - 在 App Home 允許使用者從 Messages 頁簽向應用程式發送消息。
- 安裝到工作區，取得
xoxb-開頭的 Bot Token。修改權限後按 Slack 提示重新安裝。
Socket Mode 的設定與權杖區別可參考 Slack 官方說明。使用 CDelivery 時不需要另寫該頁面中的示例程序。
填入 CDelivery
管理員打開 設定 → 渠道 → Slack：
| 字段 | 填寫內容 |
|---|---|
| Bot Token | xoxb- 開頭的機器人權杖 |
| App Token | xapp- 開頭、具有連接權限的應用程式權杖 |
儲存設定。兩種權杖不能互換，也不能用個人使用者權杖替代 Bot Token。伺服器應允許存取 Slack API 及 WebSocket 連接。
綁定自己的帳戶
在 Slack 中打開自己的個人資料，通過更多操作複製 Member ID。然後在 CDelivery 的 帳戶 → Slack 填入該 ID，並儲存。
新綁定預設開啟維運通知，可在個人帳戶中關閉。不要填寫顯示名稱、電子郵箱、頻道 ID 或 Bot 的 Member ID。
驗證
先確認已設定 AI 模型，再私信 Bot：“查看當前應用程式清單”。核對能否收到回復及權限是否符合你的 CDelivery 帳戶。
群內使用時先把 Bot 加入對應頻道，並明確提及它；首次驗證優先使用私信，減少頻道權限與事件訂閱的干擾。
常見問題
| 現象 | 檢查項 |
|---|---|
| 無法建立連接 | App Token、connections:write、Socket Mode 和出站網路 |
| 能連接但不收私信 | message.im、im:history 和 Messages 頁簽設定 |
| 收到消息但無法回復 | Bot Token、chat:write、私信權限及安裝範圍 |
| 姓名或頭像不顯示 | users:read |
| Bot 不識別你 | 當前工作區的個人 Member ID 是否與綁定一致 |
權杖輪換後更新對應欄位，再重新驗證。