Skip to content

内联键盘

内联键盘模块用于配置 Telegram Bot 的内联键盘,提供交互式按钮。

功能特性

键盘列表

  • 显示所有已配置的内联键盘
  • 键盘名称和描述
  • 键盘状态(启用/禁用)
  • 快速操作入口

键盘配置

  • 键盘名称 - 键盘的标识名称
  • 按钮布局 - 配置按钮排列
  • 按钮内容 - 按钮文字和功能
  • 回调数据 - 按钮点击回调
  • 关联命令 - 关联的命令

按钮类型

  • 文本按钮 - 显示文本,点击发送回调
  • URL 按钮 - 打开链接
  • 切换按钮 - 切换状态
  • 支付按钮 - 支付功能

操作功能

  • 添加键盘 - 创建新键盘
  • 编辑键盘 - 修改键盘配置
  • 删除键盘 - 删除不需要的键盘
  • 预览键盘 - 预览键盘效果

使用说明

创建内联键盘

  1. 点击"添加键盘"按钮
  2. 输入键盘名称
  3. 配置按钮布局
  4. 设置按钮内容和功能
  5. 保存键盘

按钮布局

按钮按行排列,每行可以有多个按钮。

示例布局:

[按钮1] [按钮2]
[按钮3]
[按钮4] [按钮5] [按钮6]

按钮配置

文本按钮

  • 按钮文字 - 显示在按钮上的文字
  • 回调数据 - 点击后发送的数据
  • 回调处理 - 处理回调的函数

URL 按钮

  • 按钮文字 - 显示在按钮上的文字
  • URL 地址 - 点击后打开的链接

按钮类型详解

文本按钮

用户点击后,机器人会收到回调数据,可以据此执行相应操作。

URL 按钮

用户点击后,会在浏览器中打开指定的 URL。

切换按钮

按钮可以在两种状态之间切换,显示不同的文字。

支付按钮

用于支付功能,需要配置支付参数。

回调处理

当用户点击按钮时,系统会:

  1. 接收回调数据
  2. 根据回调数据执行相应操作
  3. 可以更新按钮状态
  4. 可以发送回复消息

使用场景

  • 菜单导航 - 提供菜单选择
  • 操作确认 - 确认/取消操作
  • 数据选择 - 选择选项
  • 快捷操作 - 快速执行操作

最佳实践

  1. 合理布局 - 按钮不要太多,每行 2-3 个
  2. 清晰文字 - 按钮文字要简洁明了
  3. 逻辑分组 - 相关按钮放在一起
  4. 测试验证 - 创建后测试效果

相关功能