Bottender框架中的Messenger事件处理详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00564/article/details/148548640

Bottender框架中的Messenger事件处理详解

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

前言

在构建聊天机器人时，正确处理各种消息事件是核心功能。Bottender作为一款优秀的聊天机器人框架，为开发者提供了完善的Messenger事件处理机制。本文将深入解析Bottender中Messenger事件的类型判断和属性访问方法，帮助开发者更好地构建功能丰富的聊天机器人应用。

原始事件与基础属性

每个Messenger事件都包含原始数据，可以通过rawEvent属性访问：

event.rawEvent;
// 典型结构示例
{
  sender: { id: '1423587017700273' },  // 发送者ID
  recipient: { id: '404217156637689' }, // 接收者ID
  timestamp: 1491796363181,  // 时间戳
  message: {  // 消息内容
    mid: 'mid.$cAAE1UUyiiwthh0NPrVbVf4HFNDGl',
    seq: 348847,
    text: 'Awesome.',
  },
}

消息类型判断与处理

Bottender提供了一系列便捷方法来判断消息类型：

基础消息判断

event.isMessage; // 是否为消息事件
event.isText;    // 是否为文本消息
event.text;      // 获取消息文本内容

附件处理

现代聊天应用支持多种附件类型，Bottender提供了完整的支持：

// 判断附件类型
event.hasAttachment;  // 是否有附件
event.isImage;       // 是否为图片
event.isAudio;       // 是否为音频
event.isVideo;       // 是否为视频
event.isFile;        // 是否为文件
event.isLocation;    // 是否为位置信息

// 获取附件内容
event.image;    // 图片附件信息
event.audio;    // 音频附件信息
event.video;    // 视频附件信息
event.file;     // 文件附件信息
event.location; // 位置信息

特殊消息类型

// 贴纸消息
event.isSticker;       // 是否为贴纸
event.sticker;         // 贴纸ID
event.isLikeSticker;   // 是否为点赞贴纸

// 快速回复
event.isQuickReply;    // 是否为快速回复
event.quickReply;      // 快速回复内容

系统事件处理

除了用户消息，Bottender还能处理各种系统事件：

回传事件

event.isPostback;     // 是否为回传事件
event.postback;       // 回传数据
event.isPayload;      // 是否为包含payload的事件
event.payload;        // 获取payload内容

支付相关事件

event.isPayment;           // 是否为支付事件
event.payment;             // 支付信息
event.isCheckoutUpdate;    // 是否为结账更新
event.checkoutUpdate;      // 结账更新信息
event.isPreCheckout;       // 是否为预结账
event.preCheckout;         // 预结账信息

消息状态事件

event.isRead;        // 消息已读事件
event.read;          // 已读信息
event.isDelivery;    // 消息送达事件
event.delivery;      // 送达信息

高级功能事件

线程控制

在多应用协作场景下，线程控制非常重要：

event.isPassThreadControl;     // 传递线程控制权
event.passThreadControl;       // 传递控制权信息
event.isTakeThreadControl;     // 接管线程控制权
event.takeThreadControl;       // 接管控制权信息
event.isRequestThreadControl;  // 请求线程控制权
event.requestThreadControl;    // 请求控制权信息

其他高级事件

// 推荐事件
event.isReferral;    // 是否为推荐事件
event.referral;      // 推荐信息
event.ref;           // 推荐参数

// 应用角色变更
event.isAppRoles;    // 应用角色变更事件
event.appRoles;      // 角色信息

// 品牌相机事件
event.isBrandedCamera;   // 品牌相机事件
event.brandedCamera;     // 相机事件信息