Slack 接入指南 ​

将 Tencent WorkBuddy 连接到 Slack 后，你可以直接在 Slack 工作区发送任务并接收执行结果。该集成使用 助理 远程控制能力，并通过 Socket Mode 建立连接，无需公网 Webhook 地址。

前置条件 ​

  • 一个 Slack 工作区，且你具备管理员权限，或可以请求安装应用
  • 电脑上已安装并运行 Tencent WorkBuddy
  • 已登录可用的 Tencent WorkBuddy 账号

配置步骤 ​

Step 1：创建 Slack App ​

  1. 打开 api.slack.com/apps 并登录
  2. 点击 Create New App，选择 From scratch
  3. 输入应用名称，例如 Tencent WorkBuddy，并选择目标工作区
  4. 点击 Create App

Step 2：开启 Socket Mode ​

  1. 在左侧菜单点击 Socket Mode
  2. 将 Enable Socket Mode 切换为开启
  3. 系统会提示创建 App-Level Token：
    • 输入 token 名称，例如 tencent-workbuddy-socket
    • 添加 scope：connections:write
    • 点击 Generate
  4. 复制生成的 App Token，通常以 xapp- 开头

Step 3：获取 Bot Token ​

  1. 在左侧菜单进入 OAuth & Permissions
  2. 在 Scopes → Bot Token Scopes 中添加以下权限：
    • app_mentions:read
    • chat:write
    • im:history
    • im:read
    • im:write
    • files:read
    • files:write
  3. 回到页面上方，点击 Install to Workspace 并授权
  4. 复制 Bot User OAuth Token，通常以 xoxb- 开头

Step 4：开启事件订阅 ​

  1. 在左侧菜单点击 Event Subscriptions
  2. 将 Enable Events 切换为开启
  3. 在 Subscribe to bot events 中添加：
    • message.im
    • app_mention
  4. 点击 Save Changes

Step 5：在 Tencent WorkBuddy 中配置 Slack ​

  1. 打开 Tencent WorkBuddy，进入 助理 Settings
  2. 在渠道列表中选择 Slack
  3. 在 Bot Token 字段中填入 xoxb-...
  4. 在 App Token 字段中填入 xapp-...
  5. 点击 Save

Step 6：完成配对 ​

  1. 保存后，Tencent WorkBuddy 会显示一个 gateway pairing code
  2. 回到 Slack 工作区，打开与 Tencent WorkBuddy bot 的私聊窗口
  3. 将 pairing code 发送给 bot
  4. 配对成功后，渠道状态会显示为 Connected

使用方式 ​

  • 直接私聊 Tencent WorkBuddy bot 发送任务
  • 在频道中通过 @Tencent WorkBuddy 提及 bot 分配任务
  • 上传文件和图片作为任务上下文
  • 在 Slack 中接收任务进度和结果通知

常见问题 ​

问题处理方式
Bot 没有响应确认 Tencent WorkBuddy 正在运行，且 助理 已启用
Socket Mode 连接失败确认 App Token 已包含 connections:write 权限
Bot Token 无效重新安装 Slack App 到工作区，重新获取 Bot Token
收不到消息事件确认 message.im 和 app_mention 事件已保存
连接中断检查网络连接，Tencent WorkBuddy 会自动尝试重连