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 獲取一對一排查協助。