TG-Staff 分流链接（魔法链接）配置指南：创建、复制与投放完整步骤

在 B2B SaaS 客服场景中，Telegram Bot 常被用于承接用户咨询。然而，追踪用户从哪个渠道进入 Bot 一直是个痛点——Telegram 原生不提供来源归因，运营人员难以区分广告投放、社媒推广或社群分享带来的流量。TG-Staff 的分流链接（魔法链接） 正是为解决这一问题而生。本文将从定义、场景、配置到投放，完整拆解如何通过官方域名短链 https://app.tg-staff.com/{code} 实现精准引流归因与客服会话分流。

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

分流链接（Diversion Link，也称魔法链接）是 TG-Staff 提供的一种官方域名短链，格式为 https://app.tg-staff.com/{code}。它的核心工作流程是：

1. 用户点击短链 → 2. 系统捕获访客的 IP 地址、浏览器信息（User-Agent）以及 URL 中附加的追踪参数 → 3. 自动跳转至您指定的 Telegram Bot，用户直接进入对话。

与普通 Bot 链接（如 t.me/YourBot?start=xxx）不同，分流链接在跳转前拦截并记录了访客来源信息，这些数据会沉淀到 TG-Staff 的用户画像中，供后续分析使用。该功能仅标准版及以上套餐可用（免费试用期也可体验）。

为什么需要分流链接？—— 适用场景与核心价值

分流链接解决的痛点很具体：Telegram Bot 本身无法区分用户从哪个渠道来。您可能同时投放了 Google Ads、Facebook 广告、KOL 推广和社群分享链接，但所有用户进入 Bot 后看到的都是同一套欢迎语，无法针对不同来源做差异化运营。以下是三个典型场景。

场景一：广告投放归因

假设您运营一个跨境 SaaS 产品，在 Google Ads、Facebook Ads 和 Twitter 上同时投放广告。使用分流链接，您可以为每个渠道创建独立的短链（如 https://app.tg-staff.com/abc 对应 Google Ads，https://app.tg-staff.com/def 对应 Facebook Ads）。当用户点击广告后跳转至 Bot，TG-Staff 会在用户画像中记录其来源渠道，您可据此评估各渠道的转化效果，优化广告预算分配。

场景二：多渠道运营追踪

除了付费广告，您可能还运营着多个 Telegram 社群、邀请 KOL 推广或在不同社交媒体发布帖文。通过分流链接，您可以在 URL 末尾追加自定义参数（如 ?source=telegram-group-a、?source=kol-john），从而区分不同社群的用户来源。这些参数会随请求被捕获，并显示在用户画像的「来源」字段中。

场景三：高峰时段客服分流

配合 TG-Staff 的会话分流规则（轮流分配 / 在线优先），分流链接还可以在咨询高峰时段起到缓冲作用。例如，您可以在广告文案中嵌入分流链接，当大量用户同时涌入时，系统自动按规则分配给在线坐席，避免单个坐席被冲垮。同时，由于来源信息被记录，坐席可以第一时间知道用户来自哪个活动，提供更精准的服务。

前置条件：套餐确认与权限准备

在开始配置前，请确保满足以下条件：

• 套餐要求：您的 TG-Staff 账号需为标准版或专业版（免费试用期内也可正常创建和使用分流链接；试用结束后需升级至标准版（$8.99/月）才能继续使用。年付方案更优惠，详见官网套餐页）。
• Bot 项目接入：您至少拥有一个已接入 TG-Staff 的 Telegram Bot 项目（即已完成 Bot Token 绑定）。
• 坐席权限：用于配置分流链接的坐席账号需具备「项目管理」或「分流链接」操作权限。如不确定，可联系项目管理员在「坐席管理」中调整权限。

步骤详解：创建与复制分流链接

以下是完整配置流程，建议按顺序操作。

第一步：进入分流链接管理页面

登录 TG-Staff 应用控制台，在左侧导航栏或项目设置中找到「分流链接」入口。不同版本的控制台布局可能略有差异，但通常位于「项目设置」或「营销工具」分组下。点击进入后，您会看到已创建的分流链接列表（新账号为空列表）。

第二步：创建新的分流链接

点击页面右上角的「创建链接」按钮，在弹出的表单中输入标识名称。建议使用有意义的名称，例如“2025 春季促销”、“Google Ads 投放”或“KOL 张三推广”，方便后续管理。系统会自动生成唯一的 code 字符串（如 abc123），并拼接成完整短链 https://app.tg-staff.com/abc123。

• 提示：名称仅用于内部管理，不会对外显示。code 是链接的唯一标识，创建后不可修改，但您可以随时删除并重建。
• 可选操作：部分版本允许您指定该链接跳转的目标 Bot 项目（如果账号下有多个项目）。选择正确项目，确保跳转无误。

第三步：复制链接与添加追踪参数

创建完成后，点击链接旁的「复制」按钮，即可获得完整短链。此时，您可以在末尾追加自定义 URL 参数，用于进一步区分流量来源。推荐使用标准的 UTM 参数格式，例如：

https://app.tg-staff.com/abc123?utm_source=google&utm_medium=cpc&utm_campaign=spring_sale

或更简洁的自定义参数：

https://app.tg-staff.com/abc123?source=google-ads&campaign=spring

参数格式要求：仅支持字母、数字、下划线（_）与短横线（-）。若参数值包含中文或特殊符号（如空格、&），请先进行 URL 编码（encodeURIComponent），否则可能导致跳转失败或归因数据丢失。

投放实践：如何将分流链接用于广告与社媒

创建好分流链接后，接下来就是投放环节。以下是针对不同渠道的最佳实践。

广告平台投放

• Google Ads：在广告系列的「最终到达网址」中填入分流链接（含 UTM 参数）。建议同时设置「跟踪模板」以传递 Click ID 等附加值参数，但需确保最终 URL 仍然指向 TG-Staff 短链。
• Meta Ads（Facebook/Instagram）：在「网站链接」字段中填入分流链接。Meta 会自动附加 fbclid 参数，但您仍需手动添加 utm_source=facebook 以区分来源。
• Twitter Ads / LinkedIn Ads：类似操作，在广告目标 URL 中填入分流链接。

社媒与社群投放

• Telegram 群组/频道：直接发送分流链接。由于 Telegram 会生成链接预览，建议在描述中说明「点击链接即可与客服对话」。
• Twitter / LinkedIn 帖文：在帖文中嵌入短链，或使用 Bio Link 工具（如 Linktree）将分流链接作为其中一个跳转目标。
• KOL 推广：为每位 KOL 创建独立分流链接（或使用不同 UTM 参数），方便后续结算与效果评估。

数据查看

用户通过分流链接进入 Bot 后，其来源信息会自动记录到 TG-Staff 的用户画像中。您可以在「用户管理」中查看单个用户的 IP 地址、浏览器信息以及 URL 参数（如 utm_source、source 等）。专业版用户还可获得更详细的来源分析报表。

常见问题与故障排查

配置过程中可能遇到以下问题，请对照排查：

• 链接无法跳转：检查 Bot 是否在线（Bot Token 是否有效、项目是否被暂停）。分流链接本身不依赖 Bot 在线（它只负责跳转），但若 Bot 被封禁或 Token 失效，用户点击后将无法进入对话。
• 参数未生效：确认参数格式正确（无中文、无空格、无特殊符号），且已正确编码。在浏览器中手动打开分流链接，查看地址栏是否显示完整参数。若不显示，说明参数未成功传递。
• 坐席未收到会话：检查会话分流规则是否配置正确。如果使用「在线优先」且所有坐席离线，系统会回退到轮流分配；若仍无坐席承接，请确认坐席账号在线且具备该项目的承接权限。
• 用户画像中来源为空：分流链接捕获的信息仅在用户首次点击时记录。如果用户重复点击或通过其他方式进入 Bot，来源字段可能被覆盖或留空。建议为每个用户会话创建独立链接。

常见问题

问：分流链接的有效期是多久？是否需要手动续期？
答： 分流链接一经创建即长期有效，除非您在控制台中手动删除或项目被移除。无需续期，但建议定期清理不再使用的链接以保持管理清晰。

问：我可以在一个项目下创建多个分流链接吗？
答： 可以。TG-Staff 不限制单个项目的分流链接数量，您可根据不同活动、渠道或时间阶段创建多个链接，方便独立追踪。

问：分流链接是否支持 HTTPS？对用户隐私安全吗？
答： 是的，所有分流链接均强制使用 HTTPS 加密传输。捕获的信息（IP、浏览器、URL 参数）仅用于归因分析，不会用于其他用途，符合一般隐私保护要求。

问：如果用户从分流链接跳转到 Bot 后没有坐席在线，会发生什么？
答： 用户会正常进入 Bot 的自动回复流程。若您配置了「在线优先」分流规则且无坐席在线，系统会回退到轮流分配模式；若所有坐席均离线，会话将保留在队列中，待坐席上线后承接。

问：标准版和专业版的分流链接功能有区别吗？
答： 核心创建与投放功能一致。专业版额外支持在用户画像中查看更详细的来源分析数据，以及将分流链接与内控规则关联（如限制特定链接仅允许指定坐席承接）。

---

立即体验 TG-Staff 分流链接：前往 app.tg-staff.com 注册免费试用，按本文步骤创建您的第一条魔法链接。如需进一步了解高级配置（如 UTM 参数管理、内控关联），请查阅官方文档。配置过程中遇到任何问题，欢迎联系 @tgstaff_robot 获取实时支持。