← 所有文章
指南

Telegram Bot 深链:处理 start 参数与账号绑定

Telegram Bot 深链会通过私聊中的 /start 命令传入参数,但它本身不能证明网站账号与 Telegram 用户属于同一个人。应把参数作为服务端待处理请求的查询凭据,等待机器人实际收到更新,再明确确认敏感的账号绑定。打开链接不等于完成绑定。

重点结论

  • 启动参数最长 64 个字符,允许字母、数字、下划线和连字符。
  • start 用于私聊入口;startgroup 属于另一套添加到群组的流程。
  • 活动来源代码可以公开;账号绑定令牌应不可预测、短期有效且只能使用一次。
  • 启动机器人与授权现有 Telegram 消息账号是两种不同的接入方式。

Telegram start 链接实际发送什么

Telegram 的机器人功能文档介绍了深链机制,包括将 Telegram 用户与其他平台账号关联的用途。链接语法为 https://t.me/<bot_username>?start=<parameter>。尖括号内容只是语法说明,不是可用机器人或生产令牌。

客户端深链规范说明,Start 按钮会携带参数执行机器人启动操作。因此,应以实际收到的命令推进界面,而不是以浏览器点击或假定的自动消息作为依据。机器人会收到类似 /start airplane 的命令文本,其中 airplane 来自 Telegram 官方示例。

参数允许 A-Z、a-z、0-9、_ 和 -,最长 64 个字符。Telegram 建议使用 base64url 编码二进制等内容。但编码不是加密,也不构成信任依据。不要在链接里放密码、bot token、API hash、邮箱地址或可重复使用的登录凭据。

群组添加入口使用另外记录的 startgroup。不要把群里的命令当作私聊账号绑定的证明。

把路由参数与身份验证分开

用途建议参数收到参数能说明什么
打开帮助主题公开、在允许列表中的主题代码用户请求该主题
记录活动入口公开活动代码某次入口归因,不是已验证身份
绑定已登录的网站账号不透明、单次使用的服务端引用有一个仍需确认的待绑定关系

用户可以手动输入命令,也可以转发链接。因此,参数里带客户编号,不代表发送者拥有该客户记录。即使令牌不可预测,也可能被转发或泄露;随机性不能单独证明两端账号属于预期的人。

如果不清楚凭据边界,先阅读 Telegram API ID、API hash 与 bot token 的区别。启动参数是应用输入,不是上述任何一种凭据。

建议的账号绑定流程

下面是应用架构建议,不是 Telegram 提供的令牌服务,也不是新增的 UnifyPort 接口。

  1. 从已登录的网站会话发起。 展示即将绑定的账号,要求用户主动操作,并使用网站现有的会话与防请求伪造措施。
  2. 在服务端创建待处理请求。 生成密码学安全的随机 URL 安全令牌。保存令牌哈希、目标网站账号、目标机器人、用途、到期时间和待处理状态。这些是建议的本地记录,不是 Telegram API 字段。有效期由业务风险策略决定,Telegram 的参数格式没有替应用设定令牌有效期。
  3. 接收并验证真实更新。 验证接收入口,只接受目标机器人的私聊消息,准确解析 /start 命令并检查参数长度和字符集。使用消息中的发送者身份,不使用参数中自报的用户 ID。Bot API 参考定义了 Update 和 Message 对象。
  4. 登记认领,但不直接授予权限。 原子地将待处理请求关联到实际 Telegram 用户。拒绝过期请求,以及令牌已被认领后由其他用户发起的尝试。不要向尚未确认的 Telegram 发送者披露网站账号详情。
  5. 在原网站会话确认配对。 展示待关联的 Telegram 身份,请已登录的网站账号所有者批准。身份不符时取消请求,不要覆盖现有绑定。敏感业务还应在 Telegram 侧增加适当确认。
  6. 只提交一次,并保留最少必要审计记录。 令牌最终消费与账号关联应原子完成。重复投递或再次按 Start 不得创建另一条关联、转移绑定或重复发放权益。解绑应是独立的已认证操作。

原始令牌不应进入分析系统、日志、截图或客服工单。限制无效尝试的频率。如果用户一直没有确认,应让请求到期,不授予访问权。

按缺失的环节排查

现象下一步检查
链接打开,但没有命令机器人用户名、Start 操作及更新接收链路
收到不带参数的 /start提供普通引导,不从缺失输入推断账号
参数无效或已过期请用户从已登录的网站重新发起
同一更新再次到达复用已保存的处理结果,不重复绑定
另一位用户提交已认领令牌拒绝并提供新流程,不自动转移关联
机器人收到命令,网站仍显示等待检查应用认领与确认状态,而非只看传输

接收方式的选择见 Bot API webhook 与统一入站 webhook 对比。轮询或 webhook 都不能替代身份确认。

UnifyPort 适合哪一层

上述流程属于官方 Telegram Bot。UnifyPort 的 Telegram 授权参考记录的是通过非官方接口连接现有账号的验证码、二维码和会话导入流程。机器人启动参数不会授权该账号,也不能替代账号所有者的批准。

如果真正的目标是接收现有消息账号的消息,应使用该授权流程和已记录的 message.received 事件。不要假设机器人深链会进入已连接普通账号的收件箱。即使后续客服同时覆盖 WhatsApp、LINE 或 Zalo,身份绑定仍应由应用单独管理。

常见问题

打开链接是否就完成绑定?

不是。必须等待机器人命令及应用自己的确认事务。点击不能证明消息已收到,更不能证明账号所有权。

start 参数可以放客户 ID 吗?

可以作为非敏感路由输入,但不能作为授权依据。账号绑定应使用随机服务端引用并明确确认。

base64url 能保护秘密吗?

不能,它只是编码。敏感信息留在服务端;令牌消费或到期前,应将绑定链接视为敏感数据。

这等同于 Telegram 用户账号登录吗?

不等同。启动机器人不会创建已授权的用户账号会话,应按应用需要操作的身份选择接入方式。

下一步与参考资料

从 Telegram 的深链规范开始,再测试参数缺失、链接转发、到期、重复更新、身份冲突和取消。这些是建议的验收项,不是已执行的测试结果。

官方资料核对日期:2026-11-10。

UnifyPort API

让消息接入变成一条稳定的产品管线。

先用统一 API 跑通发送,再用标准事件把所有入站消息接回业务系统。