TG-Staff 团队 avatar TG-Staff 团队

TG機器人客服不回覆?從坐席到用戶的完整排查指南

tg-robot-cs 故障排除 Telegram客服 Bot故障 Webhook

TG機器人客服不回覆?從座席到用戶的完整排查指南

搭建了 Telegram Bot 客服系統,最讓人頭痛的情境莫過於:用戶發訊息沒回應,座席端也收不到任何通知。這種「tg機器人客服不回覆」的問題,可能是網路、設定、權限或規則任何一個環節出了差錯。

本文從底層網路到上層業務邏輯,提供一套完整的排查步驟。無論你用的是 TG-Staff 還是其他 Bot 管理平台,這套方法都能幫你快速定位原因並恢復正常接待。


為什麼TG機器人客服不回覆?先定位問題層級

遇到 Bot 不回覆,別急著懷疑系統壞了。先問三個問題:

  • 用戶端:用戶發訊息後,Bot 是否顯示「在線」?用戶是否收到自動回覆(如歡迎語)?
  • 座席端:座席在 Web 控制台是否能看到新會話?是否嘗試過回覆但訊息沒送達?
  • 系統端:Bot Token 是否有效?方案是否到期?Webhook 是否正常?

將問題歸類到這三個層級,後續排查會更有方向。下面按步驟逐一驗證。


第一步:檢查基礎網路與Telegram API連通性

網路不通是 tg機器人客服不回覆 的最常見原因。Telegram Bot API 依賴穩定的網際網路連線,如果你的伺服器或本地網路無法存取 api.telegram.org,Bot 自然無法收發訊息。

快速驗證方法:

  1. 用瀏覽器或命令列存取 https://api.telegram.org/bot<你的Token>/getMe
    • 如果回傳 JSON 中包含 Bot 的 ID 和名稱,表示 API 連通正常。
    • 如果逾時或報錯,表示網路被封鎖或 DNS 解析失敗。
  2. 檢查 Bot 在 Telegram 客戶端的狀態:打開 Bot 對話頁,如果顯示「在線」或「最近上線」,表示 Bot Token 有效且能接收訊息。
  3. 如果使用 TG-Staff,在控制台 → 專案管理 → 對應 Bot 的「Webhook 狀態」處查看是否顯示「正常」。

常見網路故障處理:

  • 伺服器 IP 被 Telegram 封禁(更換 IP 或使用代理)。
  • 本地開發環境無法直連 Telegram API(需設定代理或使用海外伺服器)。
  • 防火牆規則誤攔截了 Telegram 的 IP 段。

第二步:確認Bot Token與Webhook設定是否正確

Token 錯誤或 Webhook 失效,是導致 tg機器人客服不回覆 的第二大原因。

驗證 Token:

  1. 在 Telegram 中打開 @BotFather,傳送 /mybots,選擇你的 Bot,點選「API Token」。
  2. 複製 Token 並與 TG-Staff 控制台 → 專案管理 → Bot Token 欄位比對。如果不一致,用正確的 Token 更新。
  3. 如果 Token 被重設過(例如 BotFather 上點了「Revoke token」),舊 Token 會立即失效。

檢查 Webhook:

  • 在 TG-Staff 控制台 → 專案管理 → 對應 Bot 的「Webhook 設定」中,點選「檢查狀態」。
  • 如果顯示「未設定」或「錯誤」,點選「設定 Webhook」重建。
  • 你也可以手動驗證:存取 https://api.telegram.org/bot<你的Token>/getWebhookInfo,確認 url 欄位指向 TG-Staff 的 Webhook 地址。

注意:Webhook 衝突

如果同一個 Bot Token 被多個平台(如 TG-Staff + 其他 Bot 框架)同時設定 Webhook,會導致訊息路由混亂,出現 TG 機器人客服不回覆的現象。請確保 Token 只綁定一個 Webhook 位址。如果之前用過其他 Bot 服務,建議在 BotFather 中先 Revoke Token,再重新產生並綁定到 TG-Staff。


第三步:排查座席端——為什麼座席看不到用戶訊息?

有時 Bot 能正常接收訊息,但座席在 Web 控制台看不到新對話。問題往往出在座席端。

座席未登入或登入狀態過期

TG-Staff 的 Web 控制台會話有有效期。如果座席長時間未操作,登入狀態可能過期。

解決方法: 重新整理頁面,如果被重新導向到登入頁,重新登入。建議座席在開始工作前確認自己處於已登入狀態。

座席沒有該專案的客服權限

如果專案設定了「指定客服」,未在名單中的座席無法接收該 Bot 的訊息。

檢查步驟:

  1. 進入 TG-Staff 控制台 → 專案管理 → 選擇對應 Bot。
  2. 找到「客服範圍」,確認目前座席是否在「指定客服」列表中。
  3. 如果專案設為「全部客服」,所有座席都能接收;如果只選了部分座席,其他座席即使線上也會看不到訊息。

第四步:檢查對話分流規則是否導致訊息遺失

TG-Staff 支援兩種分流規則:輪流分配(預設)和 線上優先。如果規則設定不當,訊息可能被分配到離線座席,導致用戶等待。

兩種規則對比:

規則行為適合場景
輪流分配依序輪詢所有有權限的座席,無論是否線上團隊座席數量多且輪班制
線上優先優先分配給線上的座席;全部離線時回退輪流分配小團隊或座席隨時線上

排查方法:

  1. 在 TG-Staff 控制台 → 專案管理 → 分流規則,查看目前設定。
  2. 如果選擇「輪流分配」,檢查是否有座席處於離線狀態。離線座席被輪詢到時,訊息會進入佇列,但不會立即分配。
  3. 如果所有座席都離線,訊息會進入等待佇列。用戶端不會收到回覆,直到有座席上線並手動領取。

分流規則小技巧

如果團隊坐席數量少(如 1–2 人),建議將分流規則設為「在線優先」,這樣只要有一名坐席在線,訊息就能被分配。若設成「輪流分配」,訊息可能會輪詢到離線坐席,造成延遲。


第五步:排查機器人指令流程與自動回覆設定

如果使用者發送的訊息觸發了 Bot 的自動指令流程(例如歡迎詞、選單),但未正確轉移到真人客服,也會表現為 TG 機器人客服不回覆

檢查重點:

  • 在 TG-Staff 控制台 → 可視化指令流程,開啟目前 Bot 的流程編輯器。
  • 確認自動回覆節點之後是否連接了「轉真人」節點。
  • 常見錯誤:使用者輸入關鍵字後,Bot 只回覆了自動訊息,但沒有觸發會話分配。需要在流程中加入一個「轉真人」節點,並將其設為流程的終點。

測試方法: 用另一個 Telegram 帳號模擬使用者發送訊息,觀察流程是否按預期執行。如果自動回覆正常但未建立真人會話,表示流程缺少轉真人環節。


第六步:檢查內容風控與訊息攔截(專業版)

如果你使用的是 TG-Staff 專業版,內容風控規則可能攔截了客服發出的訊息,導致使用者收不到回覆。

如何查看內容風控觸發記錄

  1. 進入 TG-Staff 控制台 → 內容風控 → 觸發記錄。
  2. 按時間範圍、客服、風險詞組篩選。
  3. 查看被攔截的訊息內容和觸發時間。如果客服的回覆被攔截,這裡會顯示詳細記錄。

錢包地址監控是否誤傷正常回覆

許多 Web3 和加密貨幣團隊會在內容風控中配置錢包地址類關鍵字(例如 TRC20/ERC20 地址片段),防止客服誤發收款地址。但此類規則可能誤傷正常回覆——例如客服回覆「交易哈希:xxxx」時,如果哈希中包含配置的地址片段,訊息會被攔截。

解決方案:

  • 在風險詞組中,將錢包地址配置為「精確匹配」而非「模糊匹配」。
  • 定期查看觸發記錄,將誤報的字串加入白名單(如果支援)。
  • 若不需要此功能,可暫時關閉風險詞組或降低攔截等級。

第七步:檢查自動翻譯是否導致訊息發送失敗

TG-Staff 的自動翻譯功能依賴第三方 API(例如 DeepL、Google 翻譯)。如果 API 配額耗盡或網路異常,翻譯失敗可能導致訊息未發送。

檢查方法:

  1. 在 TG-Staff 控制台 → 設定 → 翻譯,查看目前方案的翻譯配額使用情況。
  2. 如果配額已用完,翻譯功能會自動停止。此時客服發送的訊息會失敗,使用者收不到回覆。
  3. 如果配額充足但翻譯仍失敗,檢查控制台是否有翻譯錯誤日誌(如有)。

臨時對策: 關閉自動翻譯功能,讓客服手動回覆原文。待配額恢復或網路穩定後再開啟。


常見問題

問:TG 機器人客服不回覆,但 Bot 在使用者端顯示「在線」,怎麼辦?

答:Bot 顯示「在線」僅表示 Bot Token 有效且能接收訊息,不代表客服已登入或會話已分配。請依上述步驟檢查客服狀態、分流規則和專案權限。如果所有客服都離線,使用者訊息會進入佇列,但不會收到回覆。

問:為什麼客服能看到使用者訊息,但使用者收不到客服回覆?

答:通常由以下原因導致:1)客服發送的訊息被內容風控規則攔截(專業版);2)自動翻譯 API 呼叫失敗導致訊息未投遞;3)使用者主動封鎖了 Bot(需引導使用者解除封鎖)。建議先檢查內容風控觸發記錄和翻譯配額。

問:同一個 Bot 之前能正常回覆,突然不回覆了,可能是什麼原因?

答:常見原因為:1)Webhook 被意外修改(例如透過 BotFather 重設了 Token);2)TG-Staff 方案到期或試用結束,導致服務暫停;3)Telegram API 短暫故障(較少見)。建議先檢查控制台「我的訂閱」狀態,再驗證 Webhook。

問:使用 TG-Staff 時,客服數量超過方案額度會怎樣?

答:如果目前專案分配的客服數量超過方案支援的客服額度(例如標準版 3 個客服),新增的客服將無法接收新訊息,已存在的客服不受影響。建議在控制台「我的訂閱」中查看目前方案客服上限,並合理分配客服範圍。

問:TG 機器人客服不回覆,是否與使用者使用的 Telegram 客戶端版本有關?

答:可能性極低。Telegram Bot API 是伺服器端標準介面,與使用者客戶端版本無關。如果使用者能正常發送訊息並看到 Bot「在線」狀態,問題幾乎都出在伺服器端配置而非客戶端。


讓 TG 機器人客服穩定運作的下一步

排查完以上七個步驟,絕大多數 TG 機器人客服不回覆 的問題都能找到根因並解決。如果你正在尋找一個穩定、功能全面的 Telegram Bot 客服管理平台,TG-Staff 提供了從基礎聊天到高級內控的完整方案。