使用Yoctol/Bottender构建Slack机器人的完整指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00546/article/details/148549340

使用Yoctol/Bottender构建Slack机器人的完整指南

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

前言

在现代工作环境中，Slack已成为团队协作的重要工具。通过Yoctol/Bottender框架，开发者可以轻松构建功能强大的Slack机器人，实现自动化工作流程、智能问答等功能。本文将详细介绍如何从零开始配置一个Slack机器人。

准备工作

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

有效的Slack账户
一个Slack工作区（建议为开发目的创建独立的工作区）

创建Slack应用

第一步：新建应用

访问Slack开发者控制台
点击"Create New App"按钮
填写应用名称并选择开发工作区
点击"Create App"完成创建

建议为测试目的创建专门的工作区，避免影响正式工作环境。

第二步：配置权限

在应用创建后，需要配置必要的权限才能安装应用到工作区：

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

第三步：安装应用到工作区

点击"Install App to Workspace"按钮
在授权页面点击"Allow"完成安装
记录生成的Bot User OAuth Access Token，后续配置会用到

配置Bottender项目

新建Bottender项目

对于全新项目，推荐使用以下命令创建：

npx create-bottender-app my-app

在创建过程中选择slack作为目标平台，系统会自动生成包含Slack配置的bottender.config.js和.env文件。

已有项目配置

对于已有项目，需要在bottender.config.js中添加Slack配置：

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 webhook请求的路径
accessToken: 使用环境变量存储敏感信息
signingSecret: 用于验证请求的安全性凭证

环境变量配置

Bottender使用dotenv包管理环境变量，需要在项目根目录创建.env文件并配置以下内容：

SLACK_ACCESS_TOKEN=<你的Slack访问令牌>
SLACK_SIGNING_SECRET=<你的Slack签名密钥>

获取凭证

访问令牌：在Slack开发者控制台的OAuth & Permissions页面获取
签名密钥：在Basic Information页面的App Credentials部分获取

注意：Slack Verification Token已被弃用，建议使用签名密钥替代。

Webhook配置

启动服务

运行以下命令启动服务：

# 生产模式
npm start

# 开发模式(推荐)
npm run dev

在开发模式下，Bottender会自动启动ngrok服务，提供临时公网URL用于接收Slack事件。

配置事件订阅

在Slack开发者控制台导航至Event Subscriptions页面
启用事件订阅
输入Bottender提供的webhook URL
验证成功后，订阅以下关键事件：
- message.im: 直接消息
- message.groups: 私有频道消息
- message.channels: 公开频道消息
- message.mpim: 多用户直接消息
保存更改后重新安装应用