接入 Slack 機器人

Buda 透過 Socket Mode 連接 Slack，使用持久的 WebSocket 長連線。這意味著您無需設定任何公網 HTTPS 位址或 Webhook URL，只需提供兩個 Token，Buda 就會在背景自動維持連線。

步驟 1：建立 Slack App

1. 前往 https://api.slack.com/apps，點擊 Create New App。
2. 選擇 From scratch，輸入應用程式名稱（例如：Buda Assistant），選擇您的工作區。
3. 點擊 Create App。

步驟 2：開啟 Socket Mode 並取得 App-Level Token

1. 在左側選單中點擊 Socket Mode。
2. 開啟 Enable Socket Mode 開關。
3. 系統會彈出建立 App-Level Token 的對話框：
   • 輸入 Token 名稱（例如：buda-socket）。
   • 點擊 Add Scope，選擇 connections:write。
   • 點擊 Generate。
4. 複製產生的 Token — 它以 xapp- 開頭，這就是您的 App-Level Token。

步驟 3：設定機器人權限

1. 在左側選單中進入 OAuth & Permissions。
2. 在 Bot Token Scopes 下，點擊 Add an OAuth Scope，依序新增以下權限：
   • app_mentions:read — 接收頻道中的 @提及事件
   • channels:history — 讀取頻道訊息歷史
   • chat:write — 傳送訊息
   • im:history — 讀取私訊歷史
   • im:read — 存取私訊頻道資訊
   • im:write — 開啟私訊會話
   • users:read — 取得使用者顯示名稱

步驟 4：訂閱事件

1. 在左側選單中點擊 Event Subscriptions。
2. 開啟 Enable Events 開關。
3. 在 Subscribe to bot events 下，點擊 Add Bot User Event，新增：
   • app_mention — 使用者在頻道中 @提及機器人時觸發
   • message.im — 使用者給機器人傳送私訊時觸發

步驟 5：安裝到工作區

1. 在左側選單中進入 OAuth & Permissions。
2. 點擊 Install to Workspace 並授權。
3. 複製 Bot User OAuth Token — 它以 xoxb- 開頭，這就是您的 Bot Token。

步驟 6：在 Buda 中設定頻道

1. 開啟 Buda 的 頻道設定 (Channels)（設定 → Channels）。
2. 點擊 新增頻道，提供商選擇 Slack。
3. 填寫兩個欄位：
   • Bot User OAuth Token：貼上您的 xoxb-... Token
   • App-Level Token：貼上您的 xapp-... Token
4. 可選填寫 標籤 並選擇 目標 Agent。
5. 點擊 Connect。

儲存成功後，Buda 會立即在背景透過 Socket Mode WebSocket 連接到 Slack。

步驟 7：開始使用

• 在頻道中：先用 /invite @你的機器人名稱 將機器人邀請進頻道，然後 @提及 它並傳送訊息。
• 私訊：直接開啟與機器人的私訊對話，傳送任意訊息即可，無需 @提及。

Buda 的 AI Agent 會即時處理您的訊息，並在同一對話串中回覆。