分流链接

分流链接在 TG-Staff 控制台中显示为 魔法链接。它使用 TG-Staff 官方域名作为跳转入口，在用户打开 Telegram Bot 之前 记录访客信息，适合广告投放、渠道追踪与 会话分流 引流。

与直接链接的区别

	直接链接	魔法链接（分流链接）
格式	https://t.me/机器人用户名	https://app.tg-staff.com/{魔法码}
追踪能力	无	记录 IP、浏览器、Referer、URL 参数
适用场景	日常分享	广告投放、渠道统计、UTM 归因
生成方式	Bot 激活后自动可用	项目创建时自动生成

两种链接最终都会让用户进入同一个 Telegram Bot；魔法链接多一步 访问记录 再跳转。

获取魔法链接

项目 激活机器人 后即可使用：

1. 进入 项目详情。
2. 在链接区域找到 魔法链接。
3. 点击复制，或点击链接预览跳转行为。

激活成功弹窗中也会展示魔法链接，可与 直接链接 一并复制。

TIP

每个项目拥有唯一的魔法码，无需手动创建。魔法码同时用于 Telegram Webhook 安全校验。

投放如何使用

将魔法链接作为广告落地页或按钮链接，可按需附加查询参数，例如：

https://app.tg-staff.com/xxxxxxxxxx?utm_source=facebook&utm_campaign=spring_sale

用户访问时系统会：

1. 记录访问时间、IP、User-Agent、Referer
2. 保存 URL 中的查询参数（如 UTM）
3. 跳转至 t.me/{bot}?start={魔法码}，用户进入 Bot 对话

用户随后在 Bot 中发送消息或触发命令，即创建聊天会话，并按项目配置的 会话分流 规则分配给客服席位。

典型引流漏斗

flowchart LR
  A[广告素材] --> B[魔法链接 + UTM]
  B --> C[访问记录入库]
  C --> D[跳转 Telegram Bot]
  D --> E[用户咨询]
  E --> F[会话分流到坐席]
  F --> G[客服端接待转化]

使用建议

建议	说明
区分渠道	不同广告渠道使用不同 UTM 参数
配合坐席	投放前配置好 项目客服 与分流规则
保留直接链接	老用户或私域分享仍可使用直接链接，无需追踪时更简单

套餐说明

魔法链接在项目激活后即可使用。营销文案中「分流链接」即指此功能；与客服席位、会话分流配合使用时，免费版即可体验分流接待能力。

常见问题

用户打开魔法链接没反应？

• 确认项目 Bot 已 激活 且 Token 有效
• 确认链接完整，魔法码未被篡改

访问记录在哪里查看？

• 访问数据在系统后台记录，用于归因分析；具体报表能力以控制台为准

魔法链接会过期吗？

• 不会随时间过期；删除项目或撤销 Bot 激活后链接将失效

相关文档

• 激活机器人 — 绑定 Token 与获取链接
• 会话分流 — 引流后的坐席分配
• 客服席位 — 团队接待配置