Telegram 机器人深链怎么设计：启动参数、群组安装与来源识别
说明 Telegram 机器人 start 与 startgroup 深链的设计方式、64 字符限制、来源归因、安全边界和可验收的首次使用流程。
同一个 Telegram 机器人可能从官网、活动页、合作伙伴链接或群组邀请进入。如果所有入口都只打开机器人首页，用户还要重新说明来意，运营方也很难判断哪个入口真正带来了启动或安装。
Telegram 机器人深链可以把一小段启动参数带入首次交互。它适合选择欢迎流程、识别活动来源或在添加到群组后执行对应的初始化，但不应被当成登录凭证、永久权限或不可伪造的订单证明。
私聊和群组使用不同入口
私聊常用链接是：
https://t.me/your_bot?start=campaign_oct
用户按下 Start 后，机器人会收到带参数的 /start 消息。群组安装使用 startgroup：
https://t.me/your_bot?startgroup=community_a
它会先让用户选择一个可添加机器人的群组，再把对应参数交给机器人。Telegram 还允许群组或频道链接声明希望授予机器人的管理员权限，但用户和 Telegram 最终决定实际权限；机器人必须在运行时检查自己真正拥有的权限。
对网页、二维码和可以转发的内容，优先使用 https://t.me/...。Telegram 也定义了 tg:// URI，但 HTTPS 链接更容易在浏览器和外部应用中分享。
启动参数应短、无敏感信息且可以失效
Telegram 官方文档规定，机器人启动参数最长 64 个 base64url 字符，常用字符范围为大小写字母、数字、下划线和连字符。
不要把邮箱、手机号、访问令牌、完整订单号或用户权限直接放在链接里。链接可能出现在浏览器历史、分析日志、截图和转发消息中。更稳妥的做法是传递一个短的、不透明标识，例如：
https://t.me/your_bot?start=src_7K2pQ
机器人再从自己的业务记录中查询这个标识对应的来源和允许动作。若标识用于一次性绑定，应设置过期时间、使用次数和目标用户，并在服务器侧验证；“参数看起来很随机”不是授权机制。
归因应记录启动，不要把点击当成完成
深链被打开不等于用户已经启动机器人，也不等于注册、安装或购买完成。可把漏斗拆成：
- 网页或二维码被访问；
- 用户在 Telegram 中按下 Start；
- 机器人成功识别参数并显示对应欢迎内容；
- 用户完成目标动作，例如提交报名或把机器人加入群组。
只有机器人实际收到带参数的启动消息，才能确认第二步。群组场景还应记录群组标识、发起安装的用户、机器人实际权限和初始化结果，而不是只保存 startgroup 参数。
参数也可能被重复打开或转发。来源统计可以累计每次有效启动，但兑换券、邀请奖励和账号绑定等有副作用的动作必须有独立幂等规则。
一份可以直接修改的深链需求
请为机器人增加私聊和群组深链。私聊支持
start参数，群组安装支持startgroup参数。只接受 1–64 个由字母、数字、下划线或连字符组成的参数；未知、过期或格式错误的参数显示通用欢迎页，不报出内部信息。参数仅作为来源和流程选择，不直接授予权限。每次有效启动记录来源、用户、时间和结果；同一个一次性标识重复使用时不得重复发放权益。群组安装后检查机器人实际权限，缺少必要权限时逐项说明，不自动声称安装成功。没有参数的/start继续使用默认流程。
这份需求没有要求任意外部 API。来源映射可以先存放在机器人现有业务数据中，后续再决定是否连接网站或分析系统。
至少测试这些边界
- 无参数
/start仍能正常进入默认欢迎流程。 - 已知参数显示对应内容，并记录一次有效启动。
- 未知、超长、含空格或特殊字符的参数不会触发敏感动作。
- 同一一次性参数第二次使用时不会重复发券、绑定或创建记录。
- 用户 A 的绑定参数被用户 B 打开时，按规则拒绝或重新确认。
- 群组深链在普通成员没有添加权限时，不把选择失败记为成功安装。
- 机器人权限不足时，指出缺少的具体权限，并允许管理员修复后重试。
- 转发旧链接或在活动结束后打开时，显示可理解的失效提示。
与 BotFatherV2 的关系和边界
在 BotFatherV2 中，可以通过 AI 对话把上述来源规则、欢迎文案、数据记录和异常分支写成机器人需求，再用虚构参数完成验收。
BotFatherV2 是独立产品，与 Telegram 官方 BotFather 无隶属关系。AI 辅助创建不意味着机器人自动拥有网站分析、第三方登录或支付能力；如需连接外部服务，应单独确认运行时支持、凭据管理、费用和隐私要求。当前首版的固定 SDK 也不支持任意 npm 模块或 Node/Bun API。
来源与核验日期
- Telegram，《Deep links》，英文官方技术文档，页面未标注发布日期；2026 年 10 月 12 日核验。
- BitBear Studio，BotFatherV2 《使用 AI 开发》，中文产品文档，页面未标注发布日期；2026 年 10 月 12 日核验。