开发文档

Telegram Bot 命令、按钮、菜单与资料

区别输入框菜单与消息按钮,处理回调、资料缓存、Bot ID 和托管机器人权限,构建一致的机器人界面。

GetTGAPI 编辑团队更新于
文档解读核对日期

依据官方资料整理,由 GetTGAPI 独立维护。 文档目录与术语表 →

本页内容
  1. 三类入口分别设计
  2. 资料和身份分别保存
  3. 托管 Bot 有额外授权链
  4. 实现建议

三类入口分别设计

命令列表、输入框旁菜单和消息中的按钮不是同一控件。Reply keyboard 会改变输入选择,inline keyboard 则可以产生回调;菜单还可指向 Mini App。按当前会话状态展示相应入口,避免旧按钮仍能重复提交。

按钮回调应及时应答,即使没有需要弹出的文本。较慢业务在后续状态中反馈,不让客户端一直转圈等待。

资料和身份分别保存

名称、简介、描述及头像支持相应修改和本地化,变化后需要刷新缓存。展示名可以变化,稳定身份不能用名称或用户名代替。MTProto 与 Bot API 的 ID 表示有转换规则,类型范围也需核对。

托管 Bot 有额外授权链

Managed bots 涉及所有者与 manager bot 的独立角色,创建、访问控制和 Token 导出不是普通客服用户都能执行的动作。接口能力存在不等于可以绕过所有者授权。

实现建议

菜单配置与业务路由放在同一版本管理,成功发布后回读核验。多 Bot 环境按 Bot 身份隔离会话、令牌和订单。删除或停用 Bot 时清理其菜单与服务绑定,保留必要审计但不暴露历史秘密。