TG Bot 客服不回复？从 Webhook 到坐席的全链路排查指南

TG Bot 客服不回复，是许多使用 Telegram 做客户服务的团队最头疼的问题。用户发了消息，Bot 没反应，坐席 Web 端也看不到新会话，整个客服链路像断了一样。本文从 Webhook 配置、会话分流、坐席权限到 TG-Staff 控制台，提供一份完整的 tg bot客服 故障排查清单，帮你快速恢复客服响应。

---

为什么 TG Bot 客服会「不回复」？常见原因全景图

导致 tg bot客服不回复的原因通常集中在以下几个环节。先看一眼全景图，便于快速定位：

1. Webhook 失效或配置错误：Bot 与服务器之间的通信中断，用户消息无法送达处理系统。
2. Bot Token 填写错误或项目未启用：TG-Staff 控制台中关联的 Bot Token 不正确，或项目处于禁用状态。
3. 会话分流规则未生效：坐席在线，但消息未被分配（例如分流规则为「轮流分配」且不在该坐席的轮次）。
4. 坐席离线或未分配权限：坐席未登录 Web 控制台，或项目设置中未勾选该坐席为客服。
5. 浏览器缓存或网络问题：Web 端页面缓存、广告拦截器或代理导致实时消息不刷新。
6. 内容风控规则拦截（专业版）：坐席发送消息命中风险词组，被系统阻止，误以为「不回复」。

接下来，我们按步骤逐一排查。

---

第一步：检查 Webhook 状态——TG Bot 与服务器是否正常通信

Webhook 是 Telegram Bot 与客服系统之间的桥梁。如果 Webhook 失效，用户消息根本到不了 TG-Staff 的服务器，坐席自然收不到。

如何在 TG-Staff 控制台一键检测 Webhook？

TG-Staff 控制台内置了 Webhook 状态检测功能。进入 项目设置 → Bot 配置，页面会显示当前 Webhook 的 URL 和状态（如「正常」「异常」）。如果显示异常，点击「重新设置 Webhook」按钮即可自动修复。

手动调用 Telegram API 验证 Webhook 的 curl 命令示例

你也可以通过 Telegram Bot API 手动验证：

curl https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getWebhookInfo

返回结果中关注以下字段：

• url：是否指向 TG-Staff 的 Webhook 地址（通常为 https://app.tg-staff.com/api/webhook/...）。
• last_error_date 和 last_error_message：如果存在错误，说明 Webhook 通信异常。
• pending_update_count：待处理消息数量，如果数字很大，说明消息积压未分发。

---

第二步：确认坐席在线状态与权限——坐席为什么收不到消息？

Webhook 正常，但坐席仍然收不到消息？问题可能出在坐席侧。

坐席离线时消息会去哪？「在线优先」与「轮流分配」的差异

TG-Staff 提供两种会话分流规则：

分流规则	工作方式	坐席全离线时的行为
轮流分配（默认）	按顺序轮询有权限的坐席，无论是否在线	消息仍会按顺序分配，但坐席离线无法接起，消息可能滞留
在线优先	优先分配给在线坐席，全离线时回退轮流分配	全离线时回退轮流分配，同样可能导致消息滞留

排查方法：在控制台「项目设置 → 会话分流」中确认规则。如果团队规模小、坐席少，建议使用「在线优先」，至少确保在线坐席能第一时间收到消息。

如何为坐席正确配置项目客服范围？

即使坐席账号存在，若未在项目设置中勾选该坐席，系统也不会向其分发会话。进入 项目设置 → 客服管理，检查：

• 该坐席是否被勾选为「项目客服」。
• 如果项目客服范围设置为「指定客服」，务必确认该坐席在列表中。

---

第三步：排查分流链接与引流链路——用户是否走到了人工坐席？

如果用户是通过广告或社交媒体上的分流链接（Diversion Link）进入 Bot 的，需要检查整个引流链路是否完整。

分流链接的跳转逻辑：用户点击链接 → 跳转至 Telegram Bot → Bot 自动回复（欢迎语/菜单） → 用户触发转人工 → 人工坐席承接。

常见断裂点：

• 自动回复流程中未配置「转人工坐席」动作，而是以「结束会话」或「回复固定消息」结尾。
• 自动回复流程中设置了条件分支，但用户输入未命中任何分支，导致流程无响应。

---

第四步：检查消息是否被内容风控规则拦截（专业版）

对于使用 TG-Staff 专业版的团队，内容风控（内控管理）可能成为「不回复」的隐形原因。

当坐席发送的消息命中风险词组（例如钱包地址、敏感词、特定收款地址），系统会：

• 弹窗要求坐席二次确认；
• 或直接阻止消息发送（取决于风控规则配置）。

坐席可能误以为消息已发出，但实际被拦截，从而造成「不回复」的假象。

排查方法：进入 内容风控 → 触发记录，查看是否有该坐席的拦截日志。日志会显示：

• 触发坐席与时间
• 命中的风险词组
• 触发时的消息内容

如果确认是误拦截，可以调整风险词组（如从「阻止」改为「弹窗确认」），或将该词组从当前项目中移除。

---

第五步：清理浏览器缓存与网络环境——Web 端显示的常见陷阱

有时问题不在服务器端，而是 Web 控制台本身的显示问题。

• 浏览器缓存：TG-Staff 的实时会话列表依赖 WebSocket 连接，缓存可能导致列表不更新。建议使用浏览器的无痕模式（Incognito）重新登录。
• 广告拦截器：某些广告拦截插件（如 uBlock Origin）可能阻止 WebSocket 连接，导致消息延迟或丢失。尝试将 TG-Staff 控制台域名加入白名单。
• 网络代理：如果坐席使用了代理或 VPN，可能影响 WebSocket 的稳定性。建议关闭代理后重试。

---

第六步：联系官方支持——当以上步骤都无效时

如果以上所有步骤都排查完毕，问题仍未解决，可以直接联系 TG-Staff 官方团队。

建议准备以下信息，以便加速排查：

• Bot Token（注意不要公开泄露）
• 项目 ID（在控制台项目设置中可找到）
• 问题描述：何时开始、影响范围（所有坐席还是个别坐席）、已尝试的排查步骤

求助渠道：

• 官方客服 Bot：@tgstaff_robot
• 官方文档：docs.tg-staff.com
• 控制台内帮助入口：页面右下角的「帮助」按钮

---

常见问题

问： TG Bot 客服不回复，但用户能收到 Bot 自动回复，是什么问题？

答： 自动回复正常说明 Webhook 与 Bot 本身无故障。问题通常出在会话分流配置或坐席权限上——检查坐席是否在线、是否在项目客服范围内，以及分流规则是否设置为「在线优先」且没有在线坐席。

问： 坐席明明在线，为什么还是收不到新会话？

答： 可能原因：① 坐席未在项目设置中被勾选为客服；② 当前会话已被其他坐席接起，或处于「已结束」状态；③ 分流规则为「轮流分配」，新消息被分配给了其他坐席。建议在 TG-Staff 控制台「会话列表」中查看所有活跃会话。

问： 使用分流链接后，用户进入 Bot 却无法转人工，怎么办？

答： 请检查 Bot 的可视化命令流程：确认「欢迎语」或「菜单」节点之后是否连接了「转人工坐席」动作。如果流程以「结束会话」或「回复固定消息」结束，用户将无法触发人工客服。

问： TG-Staff 专业版的内容风控会导致消息发不出去吗？

答： 会。当坐席发送的消息命中风险词组（如钱包地址、敏感词）时，系统会弹窗要求二次确认或直接阻止发送。请前往「内容风控 → 触发记录」查看是否有拦截日志，并根据需要调整风险词组。

问： 为什么我的 Webhook 显示正常，但 Bot 就是不回复？

答： 除了 Webhook 状态，还需确认：① Bot Token 是否在 TG-Staff 控制台中正确填写；② 项目是否处于「启用」状态；③ 套餐是否已到期（免费试用 3 天后需续费）。建议在控制台「项目设置」中重新保存 Bot Token 并触发一次测试消息。

---

结语：从排查到预防

tg bot客服不回复的问题，大多数情况下都能通过上述 6 步排查解决。但与其每次都「救火」，不如建立预防机制：

• 定期检查 Webhook 状态：每周一次，或每次修改 Bot 配置后立即检查。
• 为坐席设置离线通知：TG-Staff 支持坐席离线时的消息提醒（需在通知设置中开启）。
• 使用「在线优先」分流规则：减少消息滞留。
• 内容风控规则先测试再上线：在测试项目中先验证，避免误拦截。

如果你还没有使用 TG-Staff，现在可以 注册免费试用 3 天，体验一站式 TG Bot 客服管理。如需进一步排查，可联系 @tgstaff_robot 或查阅 官方文档。