Telegram Bot 坐席登不上？席位客服常見故障排查 FAQ 與解決方案

運營一個 Telegram Bot 客服團隊，最怕關鍵時刻坐席登不上、會話不同步、分流規則失靈。這些故障不僅影響客戶體驗，還可能讓團隊手忙腳亂。本文聚焦 TG-Staff 席位客服的常見故障，提供從登錄到分流的完整排查指南，幫助運營團隊快速定位並解決問題。無論你是剛註冊試用的新手，還是已經上線的老用戶，這份排障 FAQ 都能幫你少走彎路。

坐席登錄不上：帳號權限與網路環境排查

坐席無法登錄 Web 控制台是最高頻的故障之一。通常原因集中在帳號權限、套餐額度或網路環境上。以下步驟幫你逐步縮小問題範圍。

檢查坐席帳號權限與套餐額度

1. 確認坐席帳號是否被分配：登錄管理員控制台，進入「項目設置」→「坐席管理」，檢查該坐席是否已被添加到項目中，並擁有對應權限。如果坐席未被分配，登錄時會提示無權限。
2. 套餐坐席額度是否已滿：標準版支援 3 個坐席，專業版支援 5 個或 20 個（具體以官網套餐頁為準）。如果已用坐席數超過套餐額度，新坐席無法登錄。管理員可在「我的訂閱」中查看當前套餐與坐席使用情況。
3. 套餐是否過期：免費試用 3 天到期後，所有功能會受限。如果登錄後頁面顯示「套餐已過期」，需續費後恢復。注意：續費後可能需要重新登錄。

網路環境與瀏覽器相容性

• 檢查網路代理：如果使用 Telegram 客戶端正常，但 Web 控制台無法載入，請嘗試關閉代理或切換到直連網路。TG-Staff 控制台依賴 Stripe 與 Google 服務，部分代理可能攔截這些域名。
• 瀏覽器快取與 Cookie：清除瀏覽器快取和 Cookie，或使用無痕模式重新登錄。如果問題依舊，嘗試更換瀏覽器（推薦 Chrome 或 Edge 最新版）。
• 防火牆或企業網路：如果坐席在公司網路下，確保 app.tg-staff.com 和 docs.tg-staff.com 未被攔截。可聯繫 IT 部門放行這些域名。

會話不同步：訊息延遲與客服看不到新會話

當客服登入後，發現會話列表沒有新訊息，或者發送的訊息遲遲不顯示，這通常是會話不同步導致的。別急，按以下順序排查。

瀏覽器重新整理與 WebSocket 重新連線

• 手動重新整理頁面：最直接的修復方法。點擊瀏覽器重新整理按鈕或按 F5，等待 10 秒後檢查會話列表是否更新。
• 檢查 WebSocket 連線狀態：開啟瀏覽器開發者工具（F12），進入「網路」分頁，篩選類型為「WS」（WebSocket）。如果狀態顯示「斷開」或「錯誤」，表示即時連線中斷。重新整理頁面即可重建 WebSocket 連線。
• 清除快取並重啟瀏覽器：如果重新整理無效，徹底關閉瀏覽器，清除過去 1 小時的快取資料，再重新登入。

客服同時登入多個裝置的影響

• 避免多裝置登入：同一客服帳號在多個裝置（如筆電+手機瀏覽器）同時登入，可能導致會話狀態異常，例如訊息不同步或會話被自動轉移。建議每次只在一個裝置上登入。
• 強制退出其他裝置：在主控台「帳號設定」中點擊「退出所有裝置」，然後重新登入。這能清除所有異常會話狀態。

會話分流不生效：規則配置與優先順序檢查

分流規則（輪流分配或線上優先）是提升客服效率的關鍵，但有時客服明明線上，新會話卻全湧給一個人。問題可能出在規則配置上。

排查清單：分流規則生效條件

使用以下清單逐項檢查：

• 專案客服範圍：在「專案設定」→「客服範圍」中，確認是「全部客服」還是「指定客服」。如果選擇「指定客服」，未選中的客服將不會收到新會話。
• 分流類型：預設是「輪流分配」。如果改為「線上優先」，系統會優先分配給當前線上的客服。當所有客服離線時，會回退到輪流分配。檢查是否所有客服都離線了。
• 客服線上狀態：在主控台「客服列表」中，確認目標客服的線上狀態為綠色（線上）。如果顯示灰色（離線），請客服重新整理頁面或重新登入。
• 分流連結是否匹配專案：分流連結（魔法連結）綁定的是特定專案。如果連結指向專案 A，但客服只被分配到專案 B，則不會收到會話。

分流連結無法跳轉或歸因失敗

分流連結（魔法連結）用於廣告引流歸因，但如果連結無法正常跳轉或無法捕獲訪客資訊，整個投放鏈路就會斷裂。

排查步驟

1. 檢查 URL 參數：分流連結格式為 https://app.tg-staff.com/{code}。如果連結被截斷或參數錯誤，跳轉可能失敗。建議在後台複製連結時，確保完整複製。
2. 瀏覽器權限：部分瀏覽器會攔截第三方跳轉。測試時使用無痕模式，或檢查瀏覽器是否禁止了跨域跳轉。
3. 廣告平台跳轉鏈：如果分流連結放在廣告平台（如 Facebook、Google Ads），平台可能會添加自己的追蹤參數，導致原始連結被修改。建議在廣告後台使用「最終到達網址」或「追蹤模板」功能，保留原始連結。
4. 測試跳轉流程：在正式投放前，用不同裝置（手機、電腦）和不同瀏覽器點擊分流連結，檢查是否能正常跳轉到 Bot 並啟動會話。同時可在後台「分流連結」頁面查看訪問記錄（IP、瀏覽器資訊等）。

內容風控誤觸發或未生效

專業版的內容風控功能用於監控坐席發送的訊息，防止誤發收款地址或敏感詞。但配置不當可能導致誤報或漏報。

調整風險詞配置

• 檢查風險詞組：在「內容風控」→「風險詞組」中，確認關鍵詞是否過於寬泛。例如，如果只配置了「錢包地址」作為關鍵詞，系統可能匹配到任何類似格式的文字。建議使用完整地址或地址片段（如 TXXXXX 格式），減少誤報。
• 分組關聯項目：每個風險詞組可以關聯到特定項目。如果詞組未關聯到坐席所在項目，則風控規則不會生效。
• 測試後調整：在審計記錄中查看觸發詳情，包括坐席、會話、觸發時間和風險詞。根據記錄優化關鍵詞列表，比如將誤報的詞移出或改為更精確的匹配。

其他常見問題：套餐、支付與 Bot 配置

除了上述故障，以下問題也值得留意：

• 套餐到期後功能受限：免費試用到期後，所有功能會暫停。續費後通常需要 1–5 分鐘才能恢復。如果長時間未恢復，聯繫 @tgstaff_robot。
• USDT 支付延遲：鏈上支付需要等待網路確認（通常 1–30 分鐘）。如果超過 1 小時仍未生效，請提供交易哈希給客服。
• Bot 資料編輯未同步：在控制台編輯 Bot 頭像、名稱後，Telegram 端可能需要幾分鐘同步。如果超過 10 分鐘仍未更新，檢查 BotFather 是否被其他工具修改過。

常見問題

問：坐席登不上控制台，但帳號和密碼都正確，怎麼辦？
答：先檢查套餐是否過期或坐席額度是否已用完。如果套餐正常，嘗試清除瀏覽器快取、關閉代理，或在無痕模式下重新登入。

問：為什麼坐席能看到會話，但訊息發不出去？
答：可能是會話被其他坐席佔用或已結束。請返回會話列表重新整理，確認會話狀態為「進行中」。如果問題持續，聯繫管理員檢查坐席權限。

問：分流連結打開後跳轉到 Bot 卻沒有任何反應？
答：請確認 Bot 是否已配置歡迎語或命令流程。分流連結僅負責跳轉與歸因，Bot 的自動回覆需在可視化命令流程中設定。

問：內容風控總是誤報正常地址，怎麼調整？
答：在風險詞組中檢查錢包地址關鍵詞是否過於寬泛。建議使用完整地址或地址片段，並測試後調整規則。可在審計記錄中查看觸發詳情，優化關鍵詞列表。

問：USDT 支付後套餐未立即生效，怎麼辦？
答：鏈上支付需要等待網路確認（通常 1–30 分鐘）。如果超過 1 小時仍未生效，請聯繫 @tgstaff_robot 客服並提供交易哈希。

總結與下一步行動

Telegram Bot 席位客服的故障大多集中在登入、會話同步、分流規則和內容風控四個環節。透過本文的排查指南，你可以快速定位問題，減少停機時間。如果問題仍未解決，建議：

• 註冊免費試用 TG-Staff：https://app.tg-staff.com/
• 查閱官方文件：https://docs.tg-staff.com/
• 聯繫技術支援：https://t.me/tgstaff_robot

掌握這些排障技巧，你的 Telegram Bot 席位客服團隊將更加穩定高效。