如何用node-telegram-bot-api实现Telegram机器人命令参数引导回复功能？

核心需求拆解 #

• 当用户发送/add-date 1997这类带参数的命令时，直接处理日期逻辑；
• 当用户仅发送/add-date且处于群组时，发送带图片的询问消息，用户回复该消息等同于执行/add-date [回复内容]，且输入框自动关联该询问消息。

实现步骤与代码示例 #

1. 初始化机器人并处理基础命令判断

首先监听/add-date命令，区分带参数和无参数的情况，仅在群组中触发引导流程：

const TelegramBot = require('node-telegram-bot-api');
const botToken = '你的机器人Token';
const bot = new TelegramBot(botToken, { polling: true });

// 存储用户上下文（生产环境建议用Redis/数据库替代内存存储）
const userContext = {};

// 处理/add-date命令
bot.onText(/^\/add-date(?:\s+(\S+))?$/, (msg, match) => {
  const chatId = msg.chat.id;
  const userId = msg.from.id;
  const dateParam = match[1];
  const isGroup = ['group', 'supergroup'].includes(msg.chat.type);

  // 带参数时直接处理
  if (dateParam) {
    bot.sendMessage(chatId, `已添加日期：${dateParam}`);
    // 这里可以加入你的业务逻辑，比如存储日期到数据库等
    return;
  }

  // 无参数时判断是否在群组
  if (!isGroup) {
    bot.sendMessage(chatId, '请在命令后附带日期，例如：/add-date 1997');
    return;
  }

  // 群组内发送带图片的引导消息，强制用户回复
  const guideImageUrl = '替换为你的引导图片URL';
  bot.sendPhoto(chatId, guideImageUrl, {
    caption: '请输入你要添加的日期：',
    reply_markup: {
      force_reply: true, // 让输入框自动关联此消息
      selective: true    // 仅对发送命令的用户生效，不干扰群组其他人
    }
  }).then(sentMsg => {
    // 记录用户上下文：标记等待add-date参数，关联引导消息ID
    userContext[userId] = {
      waitingFor: 'add-date',
      guideMsgId: sentMsg.message_id
    };
  });
});

2. 监听回复消息，映射为命令参数

监听所有文本消息，判断是否为对引导消息的回复，若匹配则按/add-date [回复内容]处理：

// 监听所有消息，处理回复引导的场景
bot.on('message', (msg) => {
  // 过滤非回复消息、非机器人消息、无文本内容的情况
  if (!msg.reply_to_message || !msg.reply_to_message.from.is_bot || !msg.text) return;

  const userId = msg.from.id;
  const context = userContext[userId];

  // 验证上下文：用户是否在等待add-date参数，且回复的是对应引导消息
  if (context?.waitingFor === 'add-date' && msg.reply_to_message.message_id === context.guideMsgId) {
    const dateParam = msg.text.trim();
    if (!dateParam) {
      bot.sendMessage(msg.chat.id, '请输入有效的日期内容');
      return;
    }

    // 执行add-date的业务逻辑
    bot.sendMessage(msg.chat.id, `通过回复添加的日期：${dateParam}`);
    // 清除上下文，避免重复触发
    delete userContext[userId];
  }
});

关键细节说明 #

• force_reply参数：这是实现输入框自动关联引导消息的核心，Telegram客户端会自动将输入框设置为回复该消息的状态；
• selective: true：确保只有发送/add-date命令的用户看到强制回复提示，群组其他成员不受影响；
• 上下文存储：内存对象仅适合测试环境，生产环境需用Redis、MongoDB等持久化存储，同时可添加过期逻辑（比如10分钟未回复则清除上下文）；
• 边界处理：加入对空回复的判断，避免无效参数进入业务逻辑。

内容的提问来源于stack exchange，提问作者Estif