TG 分流链接（魔法链接）完整指南：生成、跳转 Bot 与广告归因

如果你运营一个 Telegram Bot 用于客服或销售，你可能已经习惯在社交媒体、广告或官网上直接粘贴 Bot 的 t.me/your_bot?start=xxx 链接。但你是否想过：点击这些链接的用户，究竟来自哪个渠道？他的 IP 地址和浏览器信息是什么？能否在用户跳转 Bot 之前就捕获这些数据，用于广告归因和会话分流？

这就是 TG 分流链接（魔法链接 / Diversion Link） 要解决的核心问题。本文将以 TG-Staff 平台为例，从原理到实战，详解分流链接的生成、参数捕获、会话分配与多渠道追踪，帮助你提升 Telegram Bot 客服承接效率。

什么是 TG 分流链接（魔法链接）？

TG 分流链接，又称魔法链接，是一种特殊的短链（如 https://app.tg-staff.com/{code}）。与普通 Bot 链接直接跳转到 Telegram Bot 不同，分流链接先经过 TG-Staff 的服务器，在跳转前捕获访客的 IP 地址、浏览器信息和 URL 参数，然后再将用户引导至你的 Telegram Bot。

简单来说，它相当于一个智能跳板：用户点击 → 记录数据 → 跳转 Bot → 自动回复 → 人工坐席承接。

与普通 Bot 链接的核心区别：

特性	普通 Bot 链接（t.me/...）	分流链接（app.tg-staff.com/...）
数据捕获	无，Telegram 不提供来源信息	捕获 IP、浏览器 UA、URL 追踪参数
广告归因	无法区分渠道	可区分 utm_source、campaign 等
会话分流	依赖 Bot 内逻辑	支持 TG-Staff 项目级分流规则
跳转体验	直接跳转 Bot	先记录后跳转，延迟几乎不可感知

对于跨境、出海、Web3 团队而言，分流链接是打通广告投放 → Bot 转化 → 人工客服的关键工具。

分流链接如何工作？从点击到会话的完整流程

用户点击分流链接后，发生的事件序列如下：

1. 用户点击分流链接（例如广告中的 https://app.tg-staff.com/XyZ123）
2. TG-Staff 服务器接收请求，记录以下数据：
   • 用户 IP 地址
   • 浏览器 User-Agent（设备、操作系统、浏览器类型）
   • URL 中携带的所有查询参数（如 ?utm_source=google&utm_campaign=spring_sale）
3. 服务器 302 重定向到 Bot 的 t.me/... 链接或 Bot 内指定深度链接
4. 用户进入 Bot，触发欢迎语或自动回复流程（如菜单、表单等）
5. 会话分流系统根据项目配置的分流规则，将用户分配给在线坐席（或进入等待队列）
6. 坐席在 TG-Staff Web 控制台看到用户信息，包括上方捕获的来源数据，开始接待

捕获哪些参数？

TG-Staff 分流链接捕获的主要字段：

• IP 地址：用于大致地理位置判断（非精确，仅归因参考）
• User-Agent：浏览器、操作系统、设备类型
• URL 追踪参数：支持所有标准 UTM 参数（utm_source、utm_medium、utm_campaign、utm_term、utm_content）以及自定义参数（如 campaign_id、channel、ref）

这些数据会出现在 TG-Staff 后台的会话详情页和用户画像中，你可以按参数维度筛选和导出。

分流链接与普通 Bot 链接的区别

除了上表，需要特别强调两点：

• 普通链接无法归因：Telegram 本身不提供「用户从哪个链接点进来」的数据。你无法知道哪些广告带来了 Bot 会话。
• 分流链接支持「预分流」：在用户进入 Bot 前，系统已根据规则（如全部客服/指定客服）决定后续分配逻辑，比纯 Bot 内代码更灵活。

如何生成与配置分流链接（TG-Staff 实操）

以下操作假设你已在 TG-Staff 控制台添加了 Bot 项目并确保其在线。

步骤 1：进入项目设置

登录 TG-Staff 控制台，选择目标 Bot 项目，点击左侧菜单「分流链接」。

步骤 2：生成新链接

点击「生成链接」按钮，系统会自动生成一个唯一短链（如 https://app.tg-staff.com/aBcDeF）。你可以：

• 直接复制链接使用
• 在链接后附加追踪参数（如 ?utm_source=twitter&utm_campaign=post1）
• 设置链接有效期（可选，适用于限时活动）

步骤 3：复制并嵌入渠道

将生成的链接粘贴到你的广告系统、社交媒体帖子、邮件签名或官网按钮中。建议在每条链接中附加 UTM 参数，以便后续归因。

步骤 4：验证

自己点击一次链接，确认是否正常跳转到 Bot，并在 TG-Staff 后台查看会话详情中是否出现了 IP、UA 和参数数据。

会话分流规则：如何确保咨询被正确分配？

分流链接触发后，用户进入 Bot，但谁去接待他？这取决于 TG-Staff 的项目级分流规则。

轮流分配 vs 在线优先：场景选择

TG-Staff 提供两种核心分流模式：

• 轮流分配（默认）：按顺序轮询有权限的坐席，每人接一个，适合负荷均衡场景（如客服团队在固定工位，人数稳定）。
• 在线优先：优先分配给当前在线坐席，全离线时回退为轮流分配。适合快速响应场景（如客服团队不固定，希望在线的人先接）。

选择建议：

• 团队坐席数量固定、排班明确 → 轮流分配
• 团队坐席灵活、远程办公、忙碌程度不均 → 在线优先

配置项目客服范围

在项目设置中，你可以指定分流链接的客服范围：

• 全部客服：所有有项目权限的坐席都可能接到会话
• 指定客服：仅特定坐席组（如「售前组」或「中文客服组」）接收该链接带来的会话

这对于多团队、多项目场景非常实用。例如，一个 Bot 同时服务售前和售后，你可以生成两个分流链接，分别绑定不同客服组，实现自动分流。

广告归因实战：用分流链接追踪每条线索来源

假设你正在同时投放 Google Ads、Facebook 广告和 Twitter 帖子，希望知道每个渠道带来了多少 Bot 会话和转化。

操作步骤：

1. 为每个渠道生成独立的分流链接（或使用同一链接 + 不同 UTM 参数）

   • Google Ads: https://app.tg-staff.com/code?utm_source=google&utm_campaign=product_launch
   • Facebook: https://app.tg-staff.com/code?utm_source=facebook&utm_campaign=product_launch
   • Twitter: https://app.tg-staff.com/code?utm_source=twitter&utm_campaign=post1

2. 将链接放入各渠道的广告或帖子中

3. 在 TG-Staff 后台查看归因数据

   • 进入「会话」或「用户画像」模块
   • 可按 UTM 参数筛选、排序
   • 查看每个来源的会话数量、用户 IP 分布、转化情况（需结合 Bot 内行为）

进阶用法：

• 结合引流分流功能：当某个渠道流量暴增时，自动将部分用户引导至指定坐席组，避免单一坐席过载。
• 利用用户画像：将捕获的 IP 和参数写入用户标签，后续可根据来源做差异化运营（如来自 Google 的用户推送折扣码）。

分流链接的局限性、常见问题与排查

尽管分流链接功能强大，但并非万能。以下常见问题及排查方法：

问题	可能原因	解决方式
链接无法跳转	Bot 项目被删除或离线	检查 Bot 在线状态，重新生成链接
参数未捕获	参数格式错误（如缺少 ?）或使用了特殊字符	确保参数格式为 ?key=value&key2=value2
会话未分配给坐席	所有坐席离线，且分流规则为「在线优先」	配置离线回退为「轮流分配」，或确保至少一个坐席在线
用户反映跳转后进入空白页	链接被第三方平台（如微信内置浏览器）拦截	尝试使用短链服务缩短后再嵌入，或引导用户手动复制链接到浏览器打开
归因数据不准确	用户开启了 VPN 或隐私模式	IP 数据仅供参考，建议结合 UTM 参数做主要归因

排查通用步骤：

1. 用无痕浏览器点击链接，确认跳转正常
2. 在 TG-Staff 后台查看该会话的「详情」，确认是否有 IP 和 UA 记录
3. 检查分流规则配置，确保坐席在线且有权限
4. 联系 TG-Staff 客服 Bot 获取技术支持

常见问题

问：分流链接生成的短链有有效期吗？

答：TG-Staff 生成的分流链接无固定过期时间，只要对应 Bot 项目未删除即可持续使用。建议定期检查链接有效性，特别是在更换套餐或 Bot 配置后。

问：分流链接能否用于多个不同渠道？

答：可以。同一分流链接可同时用于广告、社媒、邮件等渠道，通过 URL 参数（如 utm_source）区分来源。TG-Staff 后台会按参数维度展示归因数据，方便对比各渠道效果。

问：用户通过分流链接点击后，会话一定会分配给坐席吗？

答：不一定。如果所有坐席离线且分流规则为「在线优先」，用户会先收到 Bot 自动回复；坐席上线后，会话会自动分配。建议配置「轮流分配」作为离线回退策略，确保用户不会被遗忘。

问：分流链接捕获的 IP 数据是否合规？

答：TG-Staff 仅捕获用户 IP 用于归因统计，不存储长期记录。建议运营者遵循所在地区隐私法规（如 GDPR），并在隐私政策中说明数据用途。对于敏感行业（如金融、医疗），可考虑不启用 IP 捕获或仅捕获匿名化数据。

问：免费试用版能否使用分流链接？

答：分流链接属于标准版及以上套餐功能。免费试用期（3 天）可体验全部功能，试用结束后需订阅标准版或专业版继续使用。套餐详情请参考 TG-Staff 官网套餐页。

---

想要立即体验 TG 分流链接？ 注册 TG-Staff 免费试用，3 天内可体验全部功能，包括分流链接生成、会话分流与归因数据查看。详细配置说明请查阅 官方文档。如有疑问，随时联系 @tgstaff_robot。