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

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

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

前言

Bottender是一个优秀的聊天机器人框架，它支持多种消息平台（包括Messenger、Line等）。本文将详细介绍如何在Bottender项目中配置和使用Messenger频道功能。

创建Messenger机器人项目

新建项目

使用Bottender创建新项目最简单的方式是使用其脚手架工具：

npx create-bottender-app my-app

在创建过程中，请确保勾选了messenger选项。这将自动生成包含Messenger配置的bottender.config.js文件。

现有项目启用Messenger支持

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

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机器人所需的全部环境变量：

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

获取应用ID和密钥

1. 登录Facebook开发者后台
2. 进入你的应用设置页面
3. 在"基本设置"中可以找到应用ID
4. 点击"显示"按钮查看应用密钥（需要验证密码）

获取页面ID和访问令牌

1. 确保你的应用已添加Messenger产品
2. 在Messenger设置中找到"访问令牌"部分
3. 选择你的Facebook页面
4. 点击"生成令牌"按钮获取访问令牌

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

设置验证令牌

验证令牌用于验证webhook请求的来源。你可以自定义这个值，但需要确保.env文件中的MESSENGER_VERIFY_TOKEN与Facebook应用中的设置一致。

Webhook配置

开发环境

1. 启动开发服务器：

   npm run dev
   

2. 设置webhook：

   npx bottender messenger webhook set
   

生产环境

1. 部署你的Bottender应用
2. 默认webhook路径为/webhooks/messenger
3. 手动设置webhook：

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

Facebook应用页面配置

1. 进入你的Facebook应用设置
2. 导航至Messenger → 设置 → Webhook
3. 添加回调URL（你的webhook地址）
4. 输入验证令牌
5. 订阅以下事件（推荐）：
   • messages
   • messaging_postbacks
   • messaging_optins
   • messaging_referrals
   • messaging_handovers
   • messaging_policy_enforcement

上线前的注意事项

在发布你的Messenger机器人前，必须向Facebook提交应用审核，获取必要的权限（如pages_messaging）。未经审核的应用只能与管理员和测试用户交互。

常见问题

1. 令牌安全问题：所有令牌都应保存在.env文件中，不要提交到版本控制系统。
2. webhook验证失败：确保验证令牌一致，且服务器可公开访问。
3. 消息订阅问题：检查是否订阅了正确的事件类型。

通过以上步骤，你的Bottender应用就可以与Messenger平台完美集成了。Happy bot building!

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