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 或查閱 官方文件。