接入 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 会实时处理您的消息，并在同一对话线程中回复。