连接 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 的渠道