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

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

引言

在构建Messenger聊天机器人时，消息发送是最核心的功能之一。Yoctol/bottender框架为开发者提供了简洁而强大的API来处理各种类型的消息发送需求。本文将全面介绍如何在Messenger平台上使用bottender发送各类消息，包括文本消息、富媒体消息、模板消息等，并分享最佳实践和注意事项。

文本消息发送

文本消息是最基础也是最常用的消息类型，适用于大多数交互场景。在bottender中，发送文本消息非常简单：

async function SendHi(context) {
  await context.sendText('Hi!');
}

技术要点：

• 文本消息支持动态内容插入
• 适合发送股票价格、天气信息等实时数据
• 消息长度限制为640个字符

富媒体消息发送

富媒体消息包括图片、视频、音频和文件，能显著提升用户体验。bottender提供了四种发送方式：

1. 通过URL发送（最简单但不推荐生产环境使用）

await context.sendImage('https://example.com/image.jpg');

适用场景：快速原型开发

2. 使用附件ID发送（推荐生产环境使用）

await context.sendImage({ attachmentId: '<ATTACHMENT_ID>' });

优势：

• 利用Facebook缓存，加载速度更快
• 需要先通过Attachment Upload API获取附件ID

注意事项：

• 附件ID是页面(Page)级别的
• 开发环境和生产环境需要分别上传

3. 通过文件流发送

const fs = require('fs');
await context.sendImage(fs.createReadStream('image.jpg'));

4. 通过Buffer发送

await context.sendImage(imageBuffer, { filename: 'image.jpg' });

模板消息发送

模板消息提供了丰富的交互式界面，是提升用户体验的关键。

通用模板(Generic Template)

await context.sendGenericTemplate([
  {
    title: "Welcome",
    imageUrl: 'https://example.com/image.png',
    buttons: [
      {
        type: 'postback',
        title: 'Start Chatting',
        payload: 'PAYLOAD',
      },
    ],
  },
]);

特点：

• 最多10个条目
• 每个条目包含标题、副标题、图片和最多3个按钮
• 适合展示产品目录等场景

按钮模板(Button Template)

await context.sendButtonTemplate('What do you want to do next?', [
  {
    type: 'web_url',
    url: 'https://example.com',
    title: 'Show Website',
  },
]);

特点：

• 简化版的通用模板，没有图片
• 适合简单的选项选择

收据模板(Receipt Template)

await context.sendReceiptTemplate({
  recipientName: 'Customer Name',
  orderNumber: '123456',
  elements: [
    {
      title: 'Product Name',
      price: 50,
    },
  ],
});

特点：

• 专为订单确认设计
• 包含订单详情、价格汇总等信息

媒体模板(Media Template)

await context.sendMediaTemplate([
  {
    mediaType: 'image',
    attachmentId: '1854626884821032',
  },
]);

特点：

• 简洁的媒体展示方式
• 适合"一图胜千言"的场景

快速回复(Quick Reply)

快速回复是引导用户交互的有效方式，bottender支持三种类型：

文本快速回复

await context.sendText('Hi!', {
  quickReplies: [
    {
      contentType: 'text',
      title: 'Option 1',
    },
  ],
});

用户电话号码快速回复

await context.sendText('Hi!', {
  quickReplies: [
    {
      contentType: 'user_phone_number',
    },
  ],
});

用户邮箱快速回复

await context.sendText('Hi!', {
  quickReplies: [
    {
      contentType: 'user_email',
    },
  ],
});

最佳实践：

• 最多13个快速回复按钮
• 快速回复适合当前上下文的短暂交互
• 按钮适合持久性操作

速率限制(Rate Limits)

重要限制：

• 24小时内调用次数 = 200 × Messenger受众总数
• 建议发送速率不超过250请求/秒

应对策略：

• 对突发流量进行时间上的分布
• 监控错误代码613（速率限制错误）

结语

通过bottender框架，开发者可以轻松实现Messenger平台上的各种消息发送需求。本文涵盖了从基础文本到复杂模板的所有消息类型，并提供了实际代码示例和最佳实践建议。合理运用这些功能，可以构建出交互丰富、用户体验优秀的聊天机器人应用。