Appearance
内联键盘
内联键盘模块用于配置 Telegram Bot 的内联键盘,提供交互式按钮。
功能特性
键盘列表
- 显示所有已配置的内联键盘
- 键盘名称和描述
- 键盘状态(启用/禁用)
- 快速操作入口
键盘配置
- 键盘名称 - 键盘的标识名称
- 按钮布局 - 配置按钮排列
- 按钮内容 - 按钮文字和功能
- 回调数据 - 按钮点击回调
- 关联命令 - 关联的命令
按钮类型
- 文本按钮 - 显示文本,点击发送回调
- URL 按钮 - 打开链接
- 切换按钮 - 切换状态
- 支付按钮 - 支付功能
操作功能
- 添加键盘 - 创建新键盘
- 编辑键盘 - 修改键盘配置
- 删除键盘 - 删除不需要的键盘
- 预览键盘 - 预览键盘效果
使用说明
创建内联键盘
- 点击"添加键盘"按钮
- 输入键盘名称
- 配置按钮布局
- 设置按钮内容和功能
- 保存键盘
按钮布局
按钮按行排列,每行可以有多个按钮。
示例布局:
[按钮1] [按钮2]
[按钮3]
[按钮4] [按钮5] [按钮6]按钮配置
文本按钮
- 按钮文字 - 显示在按钮上的文字
- 回调数据 - 点击后发送的数据
- 回调处理 - 处理回调的函数
URL 按钮
- 按钮文字 - 显示在按钮上的文字
- URL 地址 - 点击后打开的链接
按钮类型详解
文本按钮
用户点击后,机器人会收到回调数据,可以据此执行相应操作。
URL 按钮
用户点击后,会在浏览器中打开指定的 URL。
切换按钮
按钮可以在两种状态之间切换,显示不同的文字。
支付按钮
用于支付功能,需要配置支付参数。
回调处理
当用户点击按钮时,系统会:
- 接收回调数据
- 根据回调数据执行相应操作
- 可以更新按钮状态
- 可以发送回复消息
使用场景
- 菜单导航 - 提供菜单选择
- 操作确认 - 确认/取消操作
- 数据选择 - 选择选项
- 快捷操作 - 快速执行操作
最佳实践
- 合理布局 - 按钮不要太多,每行 2-3 个
- 清晰文字 - 按钮文字要简洁明了
- 逻辑分组 - 相关按钮放在一起
- 测试验证 - 创建后测试效果