Telegram 会话分流故障排查：新会话未分配与坐席收不到消息的修复指南

会话分流是 B2B SaaS 客服系统的核心功能之一——它决定了新用户进入 Telegram Bot 后，能否被及时分配给可用的坐席。然而，很多团队在配置 TG-Staff 时会遇到“新会话无人接”“坐席在线但收不到消息”“会话一直未分配”等问题。

本文是一份面向运营和客服团队管理者的会话分流故障排查指南。我们将从最常见的故障现象入手，一步步拆解配置逻辑，并提供一份可打印的排查清单。如果你正在用 Telegram Bot 做客户支持或社群运营，这篇文章能帮你快速定位问题，让客服系统恢复正常流转。

会话分流常见故障现象一览

在动手排查之前，先确认你遇到的是哪种情况。以下三种故障最常出现，且原因各不相同：

• 新会话始终不分配给任何坐席：用户进入 Bot 后，坐席端看不到新会话，或会话一直停留在“未分配”状态。
• 坐席在线但收不到新会话通知：坐席已登录 Web 门户，状态显示在线，但新会话不弹出，需手动刷新才发现。
• 消息丢失或延迟：坐席回复了消息，但用户收不到，或用户消息未出现在会话窗口。

本文主要聚焦前两种场景。如果你遇到的是消息延迟或丢失，请优先检查 Bot Token 是否有效、网络是否稳定，以及是否触发了内容风控规则（专业版）。

第一步：检查坐席在线状态与账号登录

这是最容易被忽视的故障根源。很多团队以为“坐席登录了 Telegram”就算在线，但在 TG-Staff 中，**坐席必须登录 Web 门户（https://app.tg-staff.com/）并保持会话页面打开**，才能接收新会话。

排查步骤：

1. 确认坐席账号已登录 Web 门户（查看右上角头像是否显示在线状态）。
2. 检查浏览器是否允许 TG-Staff 发送通知（Chrome 设置 → 隐私和安全 → 站点设置 → 通知，确保 app.tg-staff.com 未被阻止）。
3. 让坐席尝试手动刷新会话页面：按 F5 或点击浏览器刷新按钮，等待 5 秒观察新会话是否出现。
4. 如果坐席长时间未操作，登录可能过期。请退出账号后重新登录，并测试一次。

常见误区：坐席在手机端登录了 TG-Staff Bot（如 @tgstaff_robot），以为这样就能收到会话。实际上，坐席必须使用 Web 门户才能接待用户。

第二步：验证分流规则配置是否正确

如果坐席已登录且状态正常，但新会话仍不分配，下一步就是检查项目级的分流规则。

在 TG-Staff 控制台中，每个 Bot 项目都可以独立配置分流规则。目前支持两种模式：

轮流分配模式下坐席顺序与轮询逻辑

• 轮流分配是默认模式。系统会按坐席列表的顺序轮询，将会话分配给下一个可用的在线坐席。
• 如果某坐席离线，系统会跳过它，继续轮询下一个坐席。
• 关键点：如果所有坐席均离线，新会话会停留在“未分配”状态，直到有坐席上线后手动领取或系统重新分配。

示例：项目有 3 个坐席（A、B、C），顺序为 A → B → C。当新会话进入时，系统先检查 A 是否在线：若在线则分配；若离线则检查 B，以此类推。若 A、B、C 全部离线，则无分配。

在线优先模式下“全离线”回退机制

• 在线优先模式会优先将会话分配给当前在线的坐席（不按固定顺序，而是随机或按负载分配）。
• 当所有坐席离线时，系统回退到轮流分配逻辑。这意味着，如果所有坐席都离线，新会话同样会停留在“未分配”状态。
• 建议：如果你的团队有多个坐席且部分坐席不常在线，建议使用“在线优先”模式，确保在线坐席能及时收到会话。

排查步骤：

1. 进入 TG-Staff 控制台 → 项目设置 → 会话分流规则。
2. 确认当前模式是你期望的（轮流分配 vs 在线优先）。
3. 检查坐席列表是否为空——如果列表中没有坐席，则无人能接收会话。
4. 如果使用“指定客服”范围，确保所有目标坐席都已添加（见第三步）。

第三步：检查项目客服范围设置

这是一个非常隐蔽的配置点。在 TG-Staff 的项目设置中，有一个“客服范围”选项，分为：

• 全部客服：项目中的所有坐席都能接收该 Bot 的会话。
• 指定客服：只有被选中的坐席才能接收会话。

如果你选择了“指定客服”，但忘记将目标坐席加入列表，那么即使该坐席在线，也收不到新会话。

排查步骤：

1. 进入项目设置 → 客服范围。
2. 确认当前是“全部客服”还是“指定客服”。
3. 如果是“指定客服”，检查列表中是否包含所有需要接待的坐席账号。
4. 如果坐席不在列表中，点击“添加坐席”将其加入，然后保存。

第四步：排查分流链接与 Bot 关联问题

如果你使用了**分流链接（魔法链接）**来引导用户从广告、社媒进入 Bot，还需要检查链接本身是否配置正确。

分流链接是 TG-Staff 提供的官方域名短链（如 https://app.tg-staff.com/{code}），跳转前会捕获访客的 IP、浏览器信息与 URL 参数。如果链接失效或配置错误，用户可能无法触发会话分流。

排查步骤：

1. 在 TG-Staff 控制台 → 分流链接管理，找到对应的链接。
2. 检查该链接关联的 Bot Token 是否有效——如果 Token 被重置或 Bot 被删除，链接会失效。
3. 确认链接未过期（分流链接可以设置有效期）。
4. 用无痕浏览器打开分流链接，观察跳转目标是否正确（应跳转到你的 Telegram Bot 对话页）。
5. 如果跳转后 Bot 无响应，检查 Bot 是否已启动（在 Telegram 中向 Bot 发送 /start 测试）。

快速测试方法：在 Chrome 无痕窗口中打开分流链接，观察地址栏最终跳转到的 URL。如果跳转到了错误的 Bot 或显示 404，说明链接配置有误，需重新生成。

第五步：查看系统日志与用户画像辅助排查

如果以上步骤都检查过，但问题依然存在，可以借助 TG-Staff 专业版提供的用户画像与数据统计功能进行深度排查。

• 用户画像：查看特定会话的完整记录，包括分配时间、坐席操作、是否触发内容风控等。这能帮你判断是配置问题还是偶发网络延迟。
• 数据统计：查看会话分配的成功率、坐席在线时长、平均响应时间等指标。如果某段时间内分配成功率骤降，说明可能发生了批量故障。

标准版用户：如果无法使用高级统计功能，可以直接联系 TG-Staff 客服 Bot（@tgstaff_robot），提供你的项目 ID 和故障描述，技术支持团队会协助排查。

会话分流故障排查清单（速查版）

以下是一份可打印的排查清单，方便你快速逐一检查：

序号	检查项	状态（✓ / ✗）
1	坐席已登录 Web 门户（https://app.tg-staff.com/）？	☐
2	坐席状态显示为“在线”？	☐
3	浏览器允许 TG-Staff 发送通知？	☐
4	分流规则未设置为空（项目设置中至少有一个坐席）？	☐
5	分流规则模式正确（轮流分配或在线优先）？	☐
6	项目客服范围包含该坐席（若为“指定客服”）？	☐
7	Bot Token 有效且 Bot 仍在运行？	☐
8	分流链接未过期且指向正确的 Bot？	☐
9	坐席未手动将会话标记为“已完成”导致无法接收新会话？	☐
10	尝试重新加载会话页面或登出后重新登录？	☐

如果以上 10 项全部通过，但问题依然存在，建议联系 TG-Staff 客服或查阅官方文档（https://docs.tg-staff.com/）获取更多配置细节。

常见问题

问：新会话显示“未分配”，但坐席明明在线，怎么办？

答： 首先确认坐席是否已登录 TG-Staff Web 门户（而非仅登录 Telegram）。然后检查项目客服范围是否包含该坐席，以及分流规则是否设置为“指定客服”但未添加该坐席。最后，尝试重新加载会话页面或登出后重新登录。

问：坐席离线时，新会话会自动分配给谁？

答： 取决于分流规则。在“轮流分配”模式下，系统会跳过离线坐席，将会话分配给下一个可用的在线坐席。若所有坐席均离线，则新会话会停留在“未分配”状态，直到有坐席上线后手动领取或系统重新分配。在“在线优先”模式下，同样会回退到轮流分配逻辑。

问：分流链接失效了，如何排查？

答： 检查分流链接是否使用了正确的 Bot Token，以及该 Token 对应的 Bot 是否仍在运行。尝试用无痕浏览器重新打开链接，观察跳转目标是否正确。若链接过期，需在 TG-Staff 控制台重新生成。

问：为什么坐席收不到新会话通知（无弹窗/无声音）？

答： 检查浏览器是否允许 TG-Staff Web 门户发送通知（Chrome/Safari 设置）。另外，坐席必须保持会话页面打开（不能最小化或切换到其他标签页），否则通知可能被浏览器抑制。

问：免费试用版是否支持会话分流？

答： 支持。免费试用期间，会话分流功能完全可用，包括轮流分配与在线优先两种模式。试用结束后需订阅标准版或专业版才能继续使用（具体价格详见官网套餐页）。

---

立即体验稳定的会话分流功能：注册 TG-Staff 免费试用 3 天，无需信用卡，即可在真实项目上测试所有配置。如果遇到无法解决的故障，直接联系 @tgstaff_robot 获取技术支持。更多配置细节，请查阅官方文档（https://docs.tg-staff.com/）。