通过 Slack App 集成支持 DM 和频道。默认 Socket Mode,也支持 HTTP Request URLs。

Socket Mode vs HTTP Request URLs

关注点Socket Mode(默认)HTTP Request URLs
公网 Gateway URL不需要需要
出站网络需要出站 WSS仅入站 HTTPS
所需 TokenBot token + App-Level TokenBot token + Signing Secret
开发/防火墙后直接可用需要公网隧道
水平扩展每 App 每主机一个 WS无状态,可多副本共享

选择 Socket Mode:单 Gateway、开发环境、无法接受入站 HTTPS。 选择 HTTP Request URLs:多 Gateway 副本、出站 WSS 被阻止。

快速设置(Socket Mode)

  1. 在 api.slack.com/apps 创建 App(从 manifest)
  2. 启用 Socket Mode,生成 App-Level Token(connections:write scope)
  3. 安装 App 到工作区,复制 Bot Token
{
  channels: {
    slack: {
      enabled: true,
      botToken: "xoxb-...",
      appToken: "xapp-...",
      dmPolicy: "pairing",
    },
  },
}

多账号

{
  channels: {
    slack: {
      accounts: {
        workspace1: { botToken: "xoxb-1", appToken: "xapp-1" },
        workspace2: { botToken: "xoxb-2", appToken: "xapp-2" },
      },
    },
  },
}

注意

  • Slack 多人 DM(MPIM)路由为群聊,适用群组策略
  • 每个账号需要唯一 webhookPath(HTTP 模式)

相关

  • concepts/channels-overview — Channel 总览