Bottender项目：Messenger机器人开发环境配置指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00071/article/details/148549060

Bottender项目：Messenger机器人开发环境配置指南

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

前言

Messenger作为全球最流行的即时通讯平台之一，为企业提供了强大的客户沟通渠道。本文将详细介绍如何在Bottender框架中配置Messenger机器人开发环境，帮助开发者快速搭建自己的聊天机器人。

项目初始化

新建Bottender项目

使用Bottender提供的脚手架工具可以快速初始化项目：

npx create-bottender-app my-app

在交互式命令行中，确保勾选了messenger选项。项目创建完成后，会自动生成包含Messenger配置的bottender.config.js文件。

现有项目集成Messenger

对于已有项目，需要在配置文件中启用Messenger通道：

// bottender.config.js
module.exports = {
  channels: {
    messenger: {
      enabled: true,
      path: '/webhooks/messenger',  // 默认webhook路径
      pageId: process.env.MESSENGER_PAGE_ID,
      accessToken: process.env.MESSENGER_ACCESS_TOKEN,
      appId: process.env.MESSENGER_APP_ID,
      appSecret: process.env.MESSENGER_APP_SECRET,
      verifyToken: process.env.MESSENGER_VERIFY_TOKEN,
    },
  },
};

环境变量配置

Bottender采用.env文件管理敏感信息，以下是Messenger机器人必需的配置项：

# .env文件示例
MESSENGER_PAGE_ID=你的页面ID
MESSENGER_ACCESS_TOKEN=你的访问令牌
MESSENGER_APP_ID=你的应用ID
MESSENGER_APP_SECRET=你的应用密钥
MESSENGER_VERIFY_TOKEN=你的验证令牌

获取应用凭证

应用ID和密钥：
- 访问Facebook开发者后台
- 进入应用设置→基本设置页面
- 复制应用ID到MESSENGER_APP_ID
- 验证身份后获取应用密钥，填入MESSENGER_APP_SECRET
页面访问令牌：
- 确保应用已添加Messenger产品
- 进入Messenger设置→访问令牌页面
- 添加页面后生成访问令牌
- 特别注意：访问令牌只显示一次，请立即保存
验证令牌：
- 可自定义任意字符串作为验证令牌
- 用于Facebook验证webhook请求来源

Webhook配置

开发环境设置

启动开发服务器：
```
npm run dev
```
设置webhook：
```
npx bottender messenger webhook set
```

生产环境部署

部署项目后启动服务：
```
npm start
```

设置webhook地址：

npx bottender messenger webhook set -w https://你的域名/webhooks/messenger

手动配置webhook

进入Facebook应用→Messenger→设置→Webhook
添加回调URL（你的webhook地址）
输入验证令牌（与.env中一致）
订阅必要的事件类型：
- messages
- messaging_postbacks
- messaging_optins
- messaging_referrals
- messaging_handovers
- messaging_policy_enforcement