使用Yoctol/bottender配置Messenger聊天机器人

使用Yoctol/bottender配置Messenger聊天机器人

前言

Messenger作为全球最流行的即时通讯平台之一，为企业提供了与客户直接沟通的绝佳渠道。Yoctol/bottender作为一个现代化的聊天机器人框架，能够帮助开发者快速构建Messenger机器人。本文将详细介绍如何从零开始配置一个基于bottender的Messenger机器人。

准备工作

在开始配置之前，您需要准备好以下资源：

1. 有效的Facebook开发者账号
2. 为机器人创建的Facebook应用
3. 与机器人关联的Facebook公共主页

如果您还没有这些资源，建议先完成这些基础配置。

项目初始化

新建bottender项目

对于新项目，最快捷的方式是使用bottender提供的脚手架工具：

npx create-bottender-app my-messenger-bot

在创建过程中，选择messenger作为目标平台。这将自动生成包含Messenger配置的bottender.config.js和环境变量文件.env。

现有项目集成

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

module.exports = {
  channels: {
    messenger: {
      enabled: true,
      path: '/webhooks/messenger',
      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,
    },
  },
};

关键配置说明：

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

环境变量配置

在项目根目录下的.env文件中，需要配置以下关键信息：

MESSENGER_PAGE_ID=你的主页ID
MESSENGER_ACCESS_TOKEN=访问令牌
MESSENGER_APP_ID=应用ID
MESSENGER_APP_SECRET=应用密钥
MESSENGER_VERIFY_TOKEN=验证令牌

获取应用ID和密钥

1. 登录Facebook开发者后台
2. 进入应用设置→基本设置
3. 复制"应用ID"和"应用密钥"（查看密钥需要验证密码）

获取主页ID和访问令牌

1. 确保应用已添加Messenger产品
2. 进入Messenger设置→访问令牌
3. 添加主页并生成访问令牌
4. 复制主页ID和新生成的访问令牌

重要提示：访问令牌生成后只会显示一次，请务必妥善保存。如果丢失，需要重新生成。

设置验证令牌

验证令牌用于Facebook验证你的服务器身份。可以自定义一个复杂字符串作为验证令牌。

Webhook配置

开发环境

启动开发服务器：

npm run dev

设置webhook：

npx bottender messenger webhook set

生产环境

部署后，默认webhook路径为https://你的域名/webhooks/messenger。

手动设置webhook：

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

或者在Facebook开发者后台：

1. 进入Messenger设置→Webhook
2. 添加回调URL和验证令牌
3. 订阅必要的事件（建议至少包括：messages, messaging_postbacks等）

权限申请

在发布机器人前，需要向Facebook申请相关权限（如pages_messages）。建议仔细阅读Facebook的权限申请指南，确保包含机器人所需的所有权限。

最佳实践

1. 始终使用环境变量管理敏感信息
2. 定期轮换访问令牌
3. 为不同环境（开发/测试/生产）使用不同的Facebook应用
4. 实现完善的错误处理和日志记录

通过以上步骤，您已经成功配置了一个基于Yoctol/bottender的Messenger机器人基础环境。接下来可以专注于机器人业务逻辑的开发了。