Bottender项目：Messenger频道配置完全指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01167/article/details/148548928

Bottender项目：Messenger频道配置完全指南

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

引言

在构建聊天机器人时，Messenger平台因其庞大的用户基础和丰富的功能而成为开发者的首选。Bottender作为一个优秀的对话机器人框架，提供了与Messenger平台无缝集成的能力。本文将详细介绍如何在Bottender项目中配置Messenger频道，帮助开发者快速搭建自己的Messenger机器人。

创建Messenger机器人项目

初始化新项目

使用Bottender提供的脚手架工具可以快速创建Messenger机器人项目：

npx create-bottender-app my-messenger-bot

在初始化过程中，确保勾选了Messenger选项。项目创建完成后，会自动生成包含Messenger配置的bottender.config.js文件。

为现有项目添加Messenger支持

如果已有Bottender项目需要添加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,
    },
  },
};

配置环境变量

Messenger集成需要以下关键环境变量，它们应存储在项目根目录的.env文件中：

# Messenger配置
MESSENGER_PAGE_ID=你的页面ID
MESSENGER_ACCESS_TOKEN=你的访问令牌
MESSENGER_APP_ID=你的应用ID
MESSENGER_APP_SECRET=你的应用密钥
MESSENGER_VERIFY_TOKEN=你的验证令牌

获取应用ID和应用密钥

登录Facebook开发者平台
进入你的应用设置页面
在"基本设置"中查找"应用ID"和"应用密钥"
将这两个值分别填入.env文件的MESSENGER_APP_ID和MESSENGER_APP_SECRET

注意：查看应用密钥时需要再次验证Facebook密码。

获取页面ID和访问令牌

确保你的应用已添加Messenger产品
在Messenger设置中找到"访问令牌"部分
将你的Facebook页面关联到应用
生成访问令牌并立即复制保存（Facebook只会显示一次）

重要提示：访问令牌生成后务必立即保存，否则需要重新生成。

设置验证令牌

验证令牌(MESSENGER_VERIFY_TOKEN)用于验证请求来源，可以自定义一个复杂字符串。这个令牌将在后续webhook设置中使用。

Webhook配置与订阅管理

开发环境设置

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

生产环境部署

部署应用并确保服务运行：
```
npm start
```
默认webhook路径为/webhooks/messenger，完整URL如https://yourdomain.com/webhooks/messenger

手动设置webhook：

npx bottender messenger webhook set -w https://yourdomain.com/webhooks/messenger

通过Facebook开发者平台配置

进入应用设置 → Messenger → Webhook
添加回调URL并填写验证令牌
启用必要的订阅事件，通常包括：
- messages
- messaging_postbacks
- messaging_optins
- messaging_referrals
- messaging_handovers
- messaging_policy_enforcement