Yoctol/bottender 项目：Slack 机器人接入完整指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00592/article/details/148527470

Yoctol/bottender 项目：Slack 机器人接入完整指南

bottender ⚡️ A framework for building conversational user interfaces. 项目地址: https://gitcode.com/gh_mirrors/bo/bottender

前言

在现代工作场景中，Slack 已成为团队协作的重要工具。通过 Yoctol/bottender 框架，开发者可以轻松构建功能强大的 Slack 机器人。本文将详细介绍如何从零开始配置 Slack 机器人并将其接入 bottender 应用。

准备工作

在开始之前，请确保您已具备以下条件：

有效的 Slack 账户
一个 Slack 工作区（建议为测试专门创建一个新工作区）

第一步：创建 Slack 应用

访问 Slack API 管理页面
点击"创建新应用"按钮
填写应用名称并选择开发工作区
点击"创建应用"完成初步设置

配置应用权限

Slack 应用需要特定权限才能正常工作：

进入 OAuth & Permissions 页面
在 Bot Token Scopes 部分添加 chat:write 权限
- 该权限允许机器人以用户身份发送消息
保存权限设置

安装应用到工作区

权限配置完成后，"安装应用到工作区"按钮将变为可用状态
点击该按钮并按照提示完成安装
授权页面点击"允许"按钮完成授权

获取关键凭证

安装完成后，您需要记录以下重要信息：

Bot User OAuth Access Token：用于 bottender 与 Slack API 的认证
Signing Secret：用于验证 Slack 请求的真实性

创建 bottender 应用

新建项目方式

运行创建命令：
```
npx create-bottender-app my-app
```
在交互式菜单中选择 Slack 选项
项目创建完成后会自动生成配置文件和环境变量文件

已有项目配置

对于已有 bottender 项目，需要手动配置 bottender.config.js 文件：

module.exports = {
  channels: {
    slack: {
      enabled: true,
      path: '/webhooks/slack',
      accessToken: process.env.SLACK_ACCESS_TOKEN,
      signingSecret: process.env.SLACK_SIGNING_SECRET,
    },
  },
};

关键配置说明：

enabled: 必须设为 true 以启用 Slack 通道
path: 定义接收 Slack 请求的路径
敏感信息建议通过环境变量配置

环境变量配置

在项目根目录下的 .env 文件中添加：

SLACK_ACCESS_TOKEN=您的Slack访问令牌
SLACK_SIGNING_SECRET=您的Slack签名密钥

配置 Webhook

启动开发服务器

运行以下命令启动服务：

npm run dev

开发模式下，bottender 会自动启动 ngrok 服务，并在控制台输出 webhook URL。

配置 Slack 事件订阅

进入 Slack 应用管理界面的 Event Subscriptions 页面
开启事件订阅功能
输入 bottender 提供的 webhook URL
验证成功后，订阅以下机器人事件：
- message.im: 直接消息
- message.groups: 私密频道消息
- message.channels: 公开频道消息
- message.mpim: 多人直接消息