連線 Slack
通過 Socket Mode 把 Slack 機器人連線到 Buda 智慧體——在頻道或私信中聊天，無需託管公網 webhook。
把你的智慧體放進團隊的 Slack——可以是運維副手、支援應答機器人，或內部知識庫機器人。Buda 通過 Socket Mode 用兩個令牌連線，因此無需託管公網 webhook URL。連線後，機器人即可在頻道和私信中作答。
連線機器人
建立 Slack 應用
前往 api.slack.com/apps，點選 Create New App → From scratch，為其命名（例如 Buda Assistant），選擇你的工作區，然後點選 Create App。
啟用 Socket Mode 並獲取應用級令牌
開啟 Socket Mode 並將其開啟。在提示時，建立一個應用級令牌：為其命名（例如 buda-socket），新增 connections:write 許可權範圍，然後點選 Generate。複製該令牌——它以 xapp- 開頭。
新增機器人令牌許可權範圍
前往 OAuth & Permissions → Bot Token Scopes 並新增：
app_mentions:read—— 接收頻道中的 @提及channels:history—— 讀取頻道歷史chat:write—— 傳送訊息im:history、im:read、im:write—— 讀取並開啟私信users:read—— 解析顯示名稱
訂閱事件
開啟 Event Subscriptions，開啟 Enable Events，在 Subscribe to bot events 下新增 app_mention 和 message.im。點選 Save Changes。
安裝並獲取機器人令牌
回到 OAuth & Permissions，點選 Install to Workspace 並授權。複製 Bot User OAuth Token——它以 xoxb- 開頭。
在 Buda 中配置渠道
開啟 Settings → Channels，點選 Add Channel，選擇 Slack。貼上兩個令牌——Bot User OAuth Token（xoxb-）和 App-Level Token（xapp-）——可選地設定標籤和目標智慧體，然後點選 Connect。
開始聊天
- 在頻道中： 用
/invite @YourBotName邀請機器人，然後 @提及它。 - 在私信中： 開啟私信對話併發送任意內容——無需 @提及。
故障排查
| 現象 | 解決辦法 |
|---|---|
| 頻道中無回覆 | 先邀請機器人，再 @提及它；確認已訂閱 app_mention |
| 私信中無回覆 | 確認已新增 message.im 以及 im:* 許可權範圍 |
| 連線失敗 | 重新檢查 xoxb- 和 xapp- 兩個令牌是否貼上正確 |
相關內容
- 渠道總覽 —— 渠道如何把訊息路由給智慧體
- 連線 Discord —— 另一個 Gateway 風格、免 webhook 的渠道