Yoctol/bottender项目：Messenger消息发送全指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01002/article/details/148548926

Yoctol/bottender项目：Messenger消息发送全指南

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

引言

在当今数字化时代，Messenger已成为企业与客户沟通的重要渠道。Yoctol/bottender作为一款优秀的聊天机器人开发框架，为开发者提供了丰富的Messenger消息发送功能。本文将全面介绍如何在Yoctol/bottender项目中实现各种类型的Messenger消息发送，帮助开发者构建功能丰富的聊天机器人。

基础消息类型

文本消息

文本消息是最基础也是最常用的消息类型，适用于传递简单信息。

async function SendHi(context) {
  await context.sendText('您好！');
}

文本消息的特点：

支持动态内容插入
加载速度快
适用于股票报价、天气信息等实时数据展示

富媒体消息

富媒体消息包括图片、视频、音频和文件，能显著提升用户体验。

四种发送方式比较

| 方式 | 优点 | 缺点 | 适用场景 | |------|------|------|---------| | URL发送 | 实现简单 | 加载速度慢 | 原型开发 | | 附件ID发送 | 加载速度快 | 需要预上传 | 生产环境 | | 流式发送 | 本地文件处理 | 需要文件系统访问 | 本地资源发送 | | 缓冲区发送 | 灵活处理二进制 | 内存占用高 | 动态生成内容 |

最佳实践：附件ID发送

// 使用预上传的附件ID发送图片
await context.sendImage({ attachmentId: 'YOUR_ATTACHMENT_ID' });

注意点：

附件ID是页面作用域的
开发和生产环境需要分别上传
适用于需要快速加载的商业项目

模板消息

模板消息提供结构化交互体验，是提升用户参与度的关键。

通用模板(Generic Template)

await context.sendGenericTemplate([
  {
    title: "欢迎光临",
    imageUrl: 'https://example.com/welcome.jpg',
    subtitle: "我们提供优质服务",
    buttons: [
      {
        type: 'postback',
        title: '开始咨询',
        payload: 'START_CONSULTATION',
      },
    ],
  },
]);

特点：

最多10个条目
每个条目包含标题、副标题、图片和最多3个按钮
适用于产品展示、服务推荐等场景

按钮模板(Button Template)

await context.sendButtonTemplate('请选择您需要的服务', [
  {
    type: 'web_url',
    url: 'https://example.com/services',
    title: '查看服务',
  },
  {
    type: 'postback',
    title: '在线咨询',
    payload: 'ONLINE_CONSULTATION',
  },
]);

与通用模板的区别：

不包含图片
更简洁的布局
适用于简单的选项选择

快速回复(Quick Reply)

快速回复是引导用户交互的有效方式。

三种类型对比

文本快速回复

await context.sendText('请选择您的问题类型', {
  quickReplies: [
    {
      contentType: 'text',
      title: '账户问题',
      payload: 'ACCOUNT_ISSUE',
    },
    {
      contentType: 'text',
      title: '支付问题',
      payload: 'PAYMENT_ISSUE',
    },
  ],
});

用户电话号码快速回复

await context.sendText('请分享您的联系方式', {
  quickReplies: [
    {
      contentType: 'user_phone_number',
    },
  ],
});

用户邮箱快速回复

await context.sendText('请分享您的邮箱', {
  quickReplies: [
    {
      contentType: 'user_email',
    },
  ],
});

使用建议：

最多13个快速回复按钮
点击后按钮消失，保持界面整洁
适用于上下文相关的即时选择

高级功能

个性化发送(Persona)

await context.sendText('您好，我是客服代表', {
  personaId: 'YOUR_PERSONA_ID',
});

应用场景：

区分机器人和人工客服
创建虚拟角色形象
提升品牌一致性

速率限制(Rate Limits)

重要数据：

默认发送速率：250请求/秒
24小时调用限制：200 × Messenger受众数量

优化建议：

实现消息队列系统
高峰时段分散发送
监控错误代码613

总结

Yoctol/bottender提供了全面的Messenger消息发送功能，从基础的文本消息到复杂的模板消息，开发者可以根据业务需求选择合适的消息类型。在实际开发中，建议：

优先考虑用户体验，选择合适的消息类型
生产环境使用附件ID发送富媒体
合理使用快速回复引导用户
大规模活动前评估速率限制

通过合理运用这些功能，开发者可以构建出既美观又实用的Messenger聊天机器人，有效提升用户参与度和满意度。

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考