在Telegram机器人开发中，自定义回复键盘（ReplyKeyboard）是提升用户体验的核心工具之一。通过将常用指令转换成可点击的按钮，用户无需记忆复杂命令，即可快速完成操作。本文将从零开始，带你掌握ReplyKeyboard的创建、布局调整、事件处理及高级技巧。
一、ReplyKeyboard与InlineKeyboard的区别
在Telegram Bot API中，有两种主要键盘类型：回复键盘（ReplyKeyboard）和行内键盘（InlineKeyboard）。ReplyKeyboard出现在输入框下方，代替用户的键盘，用户点击按钮后直接发送对应的文本内容；而InlineKeyboard则嵌入在消息中，按钮可以附带回调数据，不发送消息。本教程聚焦ReplyKeyboard，它更适合做指令快速入口。
二、前置准备：创建机器人并获取Token
在Telegram中，通过BotFather创建机器人并获得Token。在会话中输入 /newbot，按提示设置名称和用户名，即可获取形如 123456:ABC-DEF... 的Token。后续API调用都需要它。
三、环境搭建与库安装（Python示例）
我们使用Python的python-telegram-bot库来演示。安装命令：pip install python-telegram-bot。
四、创建自定义回复键盘（ReplyKeyboardMarkup）
核心是构建一个ReplyKeyboardMarkup对象，并通过reply_markup参数发送。
示例代码：
from telegram import ReplyKeyboardMarkup
from telegram.ext import Application, CommandHandler
def start(update, context):
# 定义键盘按钮（一行一个按钮，多行用多个列表）
keyboard = [["/help", "/about"], ["联系方式"]]
reply_markup = ReplyKeyboardMarkup(keyboard, resize_keyboard=True)
update.message.reply_text("欢迎使用！请选择操作：", reply_markup=reply_markup)
application = Application.builder().token("YOUR_TOKEN").build()
application.add_handler(CommandHandler("start", start))
application.run_polling()运行后，在聊天中发送 /start 即可看到键盘。
五、布局与参数详解
ReplyKeyboardMarkup的常用参数：
- resize_keyboard：布尔值，是否让键盘自动适应按钮大小，推荐设为True。
- one_time_keyboard：布尔值，点击一次后是否自动隐藏键盘。
- selective：布尔值，是否只对特定用户显示（例如@提到的用户）。
同时，按钮可以自定义文本，也可以是工单等，但注意键盘上的按钮文本最终会以普通消息发送。
六、处理按钮点击事件
由于点击按钮会发送按钮文本到聊天，我们只需监听文本消息即可。例如监听"联系方式"：
def message_handler(update, context):
text = update.message.text
if text == "联系方式":
update.message.reply_text("邮箱：example@example.com")
else:
update.message.reply_text(f"你发送了：")然后通过MessageHandler(Filters.text & ~Filters.command, message_handler)添加到application。
七、高级技巧：动态更新与自动隐藏
可以通过edit_message_reply_markup或重新发送消息来更新键盘；使用one_time_keyboard=True可以让键盘在点击后消失。另外，你也可以结合webhook实现更复杂的逻辑。
总结
自定义回复键盘是Telegram机器人基础且强大的功能。通过灵活组合按钮布局和参数，可以显著提升用户操作效率。掌握了本文内容，你就能轻松构建出交互友好的机器人。建议继续深入学习和练习，探索更多Bot API的玩法。