Slack

Slack 接入使用 Socket Mode，用户可在频道中 @ App、给 App 发私信或在线程中继续对话，回复会回到原频道或原线程；默认由本地服务直连 Slack，除非设置 SLACK_CHANNEL_DIRECT_ENABLED=false。

使用方式

方式	触发方式	说明
频道 @ App	在频道中 @ App 并输入问题	适合团队在频道里查询设备、处理告警或下发控制命令。
私信 App	直接给 App 发私信	适合个人远程查询和控制设备。
线程回复	在 App 回复的线程中继续提问	适合把一次设备排查或操作过程保持在同一个 Slack 线程里。

在 Slack 后台准备 App

1. 在 Slack API Apps 中创建 App。
2. OAuth & Permissions → Bot Token Scopes 添加：
   • chat:write
   • app_mentions:read
   • im:history
3. Event Subscriptions 中订阅 Bot Events：
   • app_mention
   • message.im
4. 打开 Socket Mode。
5. Basic Information → App-Level Tokens 创建 token，scope 选择 connections:write，复制 xapp-...。
6. OAuth & Permissions → Install to Workspace，复制 Bot User OAuth Token，通常形如 xoxb-...。
7. Basic Information 中复制 Signing Secret。

在控制台填写配置

打开 设置 → IM 通道 → Slack，填写以下字段：

字段	.env	说明
启用	SLACK_ENABLED	是否启动 Slack 通道
Bot Token	SLACK_BOT_TOKEN	xoxb-...
App Token	SLACK_APP_TOKEN	xapp-...，需要 connections:write
Signing Secret	SLACK_SIGNING_SECRET	可选，Slack App 的 Signing Secret
白名单	SLACK_ALLOW_FROM	可选，允许访问的 Slack 用户 ID

也可以在 .env 中配置：

SLACK_ENABLED=true
SLACK_BOT_TOKEN=xoxb-your-slack-bot-token
SLACK_APP_TOKEN=xapp-your-slack-app-token
SLACK_SIGNING_SECRET=your-signing-secret
SLACK_ALLOW_FROM=U01234567,U89ABCDEF
SLACK_CHANNEL_DIRECT_ENABLED=true

保存后重启服务，配置才会生效。

验证接入

1. 确认服务已重启。
2. 日志中出现 Slack: enabled 和 Channel started (Socket Mode)。
3. 在频道中 @ App，或给 App 发私信。
4. 如果启用了白名单，确认发送者 Slack 用户 ID 已写入白名单。

频道消息会在原线程中回复；私信会直接回复到私信会话中。

常见检查项

• 私信无响应：确认订阅了 message.im，并重新安装 App 到 workspace。
• 频道无响应：确认消息中 @ 了 App，并且 App 已加入频道。
• Socket Mode 无法启动：确认 SLACK_APP_TOKEN 是 xapp-...，且包含 connections:write。
• 直连通道未启动：确认没有设置 SLACK_CHANNEL_DIRECT_ENABLED=false。