使用node-telegram-bot-api时，点击内联按钮无callback_query更新

架构老林

2026-6-22

解决node-telegram-bot-api无法接收callback_query的问题

核心问题分析

你的代码存在两个关键问题：

WebHook模式未处理callback_query类型更新：handleUpdate函数仅判断req.body.message，但用户点击内联键盘时，Telegram推送的是callback_query类型更新，既不会触发现有逻辑，也未传递给bot实例处理。
内联键盘构造错误：sendMessage的reply_markup被手动JSON序列化，而node-telegram-bot-api支持直接传入对象，序列化后的字符串会导致Telegram无法识别回调配置，进而无法触发事件。

修复方案

1. 修正内联键盘构造代码

修改sendTypesKeyboard函数，移除JSON.stringify，同时确保callback_data为字符串类型（Telegram强制要求）：

const sendTypesKeyboard = async (chatId) => {
    const types = await typeDbHandler.getAll();
    const options = {
        reply_markup: {
            inline_keyboard: types.map((type) => 
                [{"text": type.name, "callback_data": type.id.toString()}]
            )
        }
    }
    bot.sendMessage(chatId, "Choose the type", options);
}

2. WebHook模式下处理全部更新类型

更新BotController的handleUpdate方法，将所有更新传递给bot实例处理，同时保留原有消息逻辑：

class BotController {
    async handleUpdate(req, res, next){
        console.log(req.body);

        // 把更新传递给bot实例，触发对应的事件监听器
        bot.processUpdate(req.body);

        if (req.body.message?.text === "/getTypes"){
            await sendTypesKeyboard(req.body.message.chat.id);
        }
        return res.json({message: "update handled"});
    }    
}