Telegram Bot 会话卡住怎么办？从命令冲突到转人工分流的完整排查指南

运营 Telegram Bot 的团队常常遇到一个棘手问题：用户明明在 Bot 菜单里点了「转人工」，消息却石沉大海，或者用户卡在欢迎语循环里无法联系到坐席。这种 Telegram Bot 会话卡住 的现象，本质上是 Bot 自动回复流程与人工坐席分流链路之间出现了断点。

本文将从命令配置、分流规则、坐席状态、套餐限制四个维度，结合 TG-Staff 等客服工具的操作细节，提供可复现的排查步骤。无论你是刚接入 Bot 客服的新团队，还是遇到间歇性卡顿的老手，都可以按顺序检查。

为什么 Telegram Bot 会话会卡在流程里？

会话卡住通常不是单一原因导致的，而是多个环节的连锁反应。以下是三类最常见的根因：

• 命令冲突：Bot 内的自定义命令（如 /start、/menu）覆盖或拦截了转人工指令，导致用户无法进入坐席分配队列。
• 分流规则未生效：分流范围设置错误（如指定了未在线的坐席），或者分流链接未正确配置，用户从 Bot 直接进入后无法触发分流逻辑。
• 坐席离线或额度不足：坐席未登录 Web 控制台，或套餐坐席额度已耗尽，导致系统无法分配会话。

理解了这些根因，接下来按步骤逐一排查。

第一步：检查 Bot 命令是否与转人工指令冲突

常见命令冲突场景与解决

很多 Bot 运营者会在 BotFather 中注册大量命令，比如 /start、/help、/support、/pricing。如果 /support 被定义为返回一个菜单按钮（而不是触发转人工节点），用户点击后就会卡在菜单里。

典型冲突示例：

命令	错误配置	正确配置
/support	显示帮助菜单，无转人工按钮	连接到「转人工」节点
/help	返回静态文本	添加「联系客服」按钮
/start	仅显示欢迎语	欢迎语后提供转人工入口

解决建议：

• 在 BotFather 中删除或重命名可能冲突的命令，或者将转人工设为独立命令（如 /staff）。
• 如果使用 TG-Staff 的流程编辑器，确保「转人工」节点不会被其他菜单分支覆盖。

使用可视化流程编辑器检查命令路径

TG-Staff 的拖拽式流程编辑器可以直观查看每条命令的走向。操作步骤如下：

1. 登录 TG-Staff 控制台，进入目标项目的「流程编辑」页面。
2. 找到用户触发转人工的入口节点（通常是 /start 或 /support）。
3. 检查该节点的分支：是否有一个箭头指向「转人工」或「联系客服」节点？如果没有，添加一个按钮或关键词匹配条件指向它。
4. 保存并发布流程。

如果流程编辑器里根本没有转人工节点，说明用户永远无法被分配给坐席。这是最常见也最容易修复的问题。

第二步：确认会话分流规则是否生效

会话分流是决定用户消息能否到达坐席的核心机制。TG-Staff 提供两种分流模式：轮流分配 和 在线优先。两种模式都需要正确配置项目客服范围。

分流范围：指定客服 vs 全部客服

在 TG-Staff 的项目设置中，你可以选择分流的范围：

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

卡住场景：如果你选择了「指定客服」，但指定的坐席全部离线或额度已用完，用户消息就会一直排队，不会自动分配给其他坐席。

解决：临时切换到「全部客服」，或确保指定客服中有至少一人保持在线登录状态。

分流链接是否被误用或未配置

分流链接（魔法链接） 是 TG-Staff 提供的短链（如 https://app.tg-staff.com/{code}），它的作用是：

• 捕获访客的 IP、浏览器信息与 URL 参数（用于广告归因）。
• 确保用户点击后进入 Bot 并触发分流规则。

如果用户直接从 Bot 内点击菜单按钮进入（而非通过分流链接），分流规则可能不会触发，导致会话卡在自动回复阶段。

检查清单：

• 确认广告或社交媒体上的链接使用的是 TG-Staff 分流链接，而非普通 Bot 链接。
• 在 TG-Staff 控制台的「分流链接」页面，检查链接是否正确关联到目标项目。
• 如果已经配置了分流链接，测试时从该链接进入 Bot，而不是直接打开 Bot。

第三步：验证坐席在线状态与坐席额度

很多团队以为坐席安装了 Telegram 就算在线，实际上坐席需登录 TG-Staff Web 控制台才能接单。

验证步骤：

1. 登录控制台，进入「坐席管理」页面。
2. 查看每个坐席的「在线状态」列：绿色表示已登录 Web 控制台并在线，灰色表示离线。
3. 检查「坐席额度」：当前套餐支持的坐席数是否已用满？如果额度已耗尽，新坐席无法登录，旧坐席也无法接单。
4. 确认坐席被分配到正确的项目：在项目设置中查看「客服范围」，确保坐席在列表内。

如果坐席在线但额度显示为 0，需要升级套餐或释放一个坐席名额。

第四步：检查套餐限制与功能权限

免费试用期到期或套餐降级会影响关键功能，导致转人工失败。

具体影响：

• 免费试用期：3 天后自动过期，分流链接、会话分流、消息批量群发等功能暂停。
• 标准版：支持分流链接、会话分流、坐席（按额度），但无内容风控与用户画像。
• 专业版：含内容风控、无限翻译/群发、用户画像等。

如果套餐过期，所有配置仍然保留，但功能暂停。续费后立即恢复。所以如果用户卡住，先确认套餐是否在有效期内。

第五步：测试与监控转人工链路

完成以上排查后，建议做一次端到端测试。

模拟用户测试的检查清单

1. 准备测试账号：使用一个未登录的 Telegram 账号（或浏览器无痕模式）。
2. 从分流链接进入：点击 TG-Staff 分流链接，跳转到 Bot。
3. 触发转人工：发送「人工」「客服」或点击菜单按钮。
4. 检查坐席端：登录控制台，查看「会话列表」是否出现新会话，坐席是否收到通知。
5. 确认分配记录：在「会话历史」中查看分配记录，确认消息被分配给哪个坐席。

如果测试中用户消息始终未出现在坐席端，回到第一步逐一排查。

利用内容风控与审计日志排查异常

专业版用户可以通过内容风控审计日志排查坐席行为。例如，坐席发送的消息因包含风险词被拦截，可能导致用户无法收到回复，误以为会话卡住。

操作：

• 进入控制台「内容风控」→「审计日志」。
• 筛选时间范围，查看是否有坐席消息被「阻止发送」或「二次确认后发送」。
• 如果发现风险词误杀，调整风险词组或关闭对应规则。

常见问题

问：用户卡在 Bot 菜单里点任何按钮都没反应，怎么办？
答： 检查 Bot 命令是否覆盖了转人工关键词，或菜单分支未连接到人工坐席节点。使用 TG-Staff 的流程编辑器查看命令路径，确保有「转人工」或「联系客服」按钮指向坐席分配节点。

问：我的坐席明明在线，为什么收不到用户消息？
答： 坐席需登录 TG-Staff Web 控制台（app.tg-staff.com）并处于在线状态，仅 Telegram 在线不够。同时检查坐席额度是否已用完，以及分流范围是否包含该坐席。

问：分流链接和普通 Bot 链接有什么区别？
答： 分流链接是 TG-Staff 提供的短链（如 https://app.tg-staff.com/{code}），可捕获用户 IP、浏览器信息与 URL 参数用于归因，并确保用户进入后触发分流规则。普通 Bot 链接无法实现这些追踪与分流。

问：免费试用到期后，会话分流功能还能用吗？
答： 不能。免费试用到期后，分流链接、会话分流、消息批量群发等功能将暂停。续费后会自动恢复，所有配置保留。

问：如何避免用户因命令冲突卡在欢迎语里？
答： 在流程编辑器中，将「转人工」设为独立命令（如 /staff），并确保它不受其他菜单分支影响。同时建议开启会话分流中的「在线优先」模式，减少用户等待。

---

下一步行动：

• 注册 TG-Staff 免费试用 3 天，体验分流链接与流程编辑器。
• 查阅 TG-Staff 文档 获取分流配置与命令编辑详细指南。
• 联系客服 Bot @tgstaff_robot 获取一对一排查协助。