开发文档

Telegram 深度链接、聊天操作栏与 Web 事件

按链接类型处理 Telegram 跳转,核对聊天操作栏权限与 WebView 事件来源,避免链接触发越权操作。

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

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

本页内容
  1. 链接应先解析,再决定动作
  2. 操作栏来自当前上下文
  3. Web 事件需要接收边界
  4. 实现建议

链接应先解析,再决定动作

t.me 与 tg: 有多类链接,参数可能表示消息、邀请、主题、发票或其他能力。未知类型应按官方后备规则处理,不能猜测为用户名。协议内 ID 与 Bot API ID 也不能直接混用。

操作栏来自当前上下文

聊天顶部的添加联系人、举报、Business Bot 管理等动作由 peer settings 决定,设置变化会影响显示。旧页面上的按钮不能绕过当前权限重新执行。

Web 事件需要接收边界

游戏、支付页面和 Mini Apps 通过约定事件与客户端通信;不同运行环境有不同桥接方式。事件名称相同并不能证明发送者可信。

实现建议

对 WebView 来源、消息结构和允许动作建立白名单;忽略未知字段不能变成接受任意命令。支付、授权和加入等写操作需进入对应确认流程。日志保留类型与结果,避免完整记录含登录令牌的深度链接。