TG Bot 與 TG-Staff 整合實戰：將你的 Telegram Bot 接入 Web 坐席工作台

如果你正在營運一個 Telegram Bot 並希望為它接入人工客服，那麼將你的 tg bot 與 TG-Staff 整合是一個值得考慮的方案。TG-Staff 是一個面向 Telegram Bot 的客服與營運 SaaS 平台，它把 Bot 的管理、團隊協作、對話分流和流量歸因統一到一個 Web 控制台中。本文將從零開始，帶你完成從註冊、配置到上線營運的完整操作。

為什麼需要將 TG Bot 接入 TG-Staff 工作台？

在深入操作前，先回答一個核心問題：為什麼不能直接用 Bot 的 API 或第三方機器人來管理客服？

傳統 Bot 客服的三大瓶頸

• 單人單設備，無法團隊協作：Telegram 原生 Bot 的訊息只能由一個帳號處理。當團隊需要多人同時接待用戶時，要嘛輪流登入同一帳號，要嘛讓用戶等待，體驗很差。
• 缺乏對話流轉與用戶追蹤能力：沒有對話佇列、沒有分配記錄。如果某個客服臨時離線，用戶訊息只能石沉大海，無法自動轉移給其他坐席。
• 營運數據難以沉澱：你無法知道每個用戶是從哪個渠道來的、對話了多少輪、轉換率如何。廣告投放的歸因分析更是無從下手。

TG-Staff 如何解決這些問題

• Web 控制台多坐席同時接待：每個坐席擁有獨立帳號，登入 Web 入口即可即時處理 Telegram 用戶的對話。支援對話轉移、分配記錄和協作便籤。
• 分流連結實現廣告歸因：透過 TG-Staff 提供的短鏈，可以擷取訪客的 IP、瀏覽器資訊和 URL 參數（如 utm_source）。廣告 → 分流連結 → Bot 自動回覆 → 人工坐席承接，形成完整的轉換鏈路。
• 用戶畫像與統計輔助營運決策：專業版提供用戶畫像和對話統計，讓你了解用戶活躍時段、常用語言和對話時長，從而最佳化服務策略。

準備工作：你需要哪些條件？

在開始整合前，請確保滿足以下條件：

1. 一個由 BotFather 建立的 Telegram Bot，並擁有完整的 HTTP API Token（格式如 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11）。
2. 一個 TG-Staff 帳號：前往 app.tg-staff.com 註冊，註冊即享 3 天免費試用。
3. 確定套餐需求：免費試用期可體驗標準版全部功能。如果團隊超過 3 個坐席，或需要內容風控、無限翻譯等功能，建議選擇專業版。套餐價格詳見 官網套餐頁。
4. 確保 Bot 已關閉隱私模式：在 BotFather 中傳送 /setprivacy，選擇你的 Bot 並設定為 Disable。否則 Bot 將無法接收非 / 開頭的用戶訊息。

第一步：在 TG-Staff 控制台創建專案並連接 Bot

登入 app.tg-staff.com，進入控制台首頁。

1. 點擊左側選單「專案」，然後點擊「建立專案」。
2. 為專案命名（例如「官方客服 Bot」），然後輸入你的 Bot Token。
3. 點擊「連線」。系統會驗證 Token 有效性，並自動拉取 Bot 的名稱和大頭貼。
4. 連線成功後，你可以在專案詳細頁看到 Bot 的線上狀態和最近訊息記錄。

連線完成後，TG-Staff 會自動開始接收所有使用者訊息。此時你的 Bot 已經具備了多席位接入的能力，只是還沒有分配席位。

第二步：配置席位與團隊權限

添加席位的兩種方式

• 手動新增：在「席位管理」頁面，點擊「新增席位」，輸入席位的 Telegram 使用者名稱或電子郵件，設定初始密碼。系統會自動生成一個登入帳號。
• 邀請連結：在席位管理頁面生成一個邀請連結，傳送給團隊成員。對方點擊連結後自行註冊並綁定 Telegram ID，自動成為席位。

權限分配最佳實務

TG-Staff 支援按專案配置席位的操作範圍。以下是典型的角色權限配置：

角色	典型權限	適用場景
管理員	所有專案、所有操作（包括席位管理、方案管理）	團隊負責人或技術維護
客服	指定專案的會話接待、使用者畫像檢視	一線客服人員
營運	指定專案的會話接待、分流連結管理、群發訊息	負責流量投放和使用者觸及的營運

建議：不要給所有席位分配管理員權限。如果某個席位只需要處理客戶諮詢，就只給他分配對應專案的「客服」角色。這樣可以避免誤操作，比如誤刪專案配置或修改方案。

第三步：設定會話分流與分流連結

會話分流決定了新使用者訊息如何分配給席位。TG-Staff 提供兩種分流規則：

• 輪流分配（預設）：按順序輪詢有權限的席位，確保每個人接待量大致均衡。
• 線上優先：優先分配給目前線上的席位。如果所有席位都離線，則回退到輪流分配。

在專案設定中找到「會話分流」，選擇你需要的規則，然後指定客服範圍（「全部客服」或「指定客服」）。

生成分流連結

分流連結是 TG-Staff 的特色功能之一，用於將外部流量（廣告、社群媒體貼文）引導至你的 Bot，並自動觸發人工席位接待。操作步驟如下：

1. 在專案設定中點擊「分流連結」。
2. 點擊「生成連結」，系統會建立一個類似 https://app.tg-staff.com/abc123 的短網址。
3. 將此連結嵌入到你的廣告、社群媒體貼文或網站落地頁中。
4. 當使用者點擊該連結時，系統會自動捕獲 IP、瀏覽器資訊和 URL 參數，然後跳轉到你的 Bot 並傳送一則預設訊息（如「您好，有什麼可以幫您？」）。
5. 該會話會自動進入佇列，由分流規則分配給線上席位。

第四步：用視覺化命令流程搭建自動接待

在人工坐席介入前，Bot 需要能夠處理常見問題。TG-Staff 提供了一個拖曳式流程編輯器，讓你零程式碼搭建歡迎語、選單和多步驟互動。

1. 進入「命令流程」模組，點擊「新建流程」。
2. 從左側拖曳「歡迎語」節點到畫布，編輯傳送內容（如「歡迎來到官方客服，請輸入數字選擇服務：1. 產品諮詢 2. 售後問題 3. 轉人工」）。
3. 拖曳「選單」節點，配置按鈕選項。每個按鈕可以指向另一個流程節點或觸發轉人工。
4. 拖曳「轉人工」節點，配置轉接時的自動提示語（如「正在為您轉接人工客服，請稍候……」）。
5. 儲存並發布流程。之後所有新用戶都會先經歷這個自動流程，只有在選擇轉人工或輸入特定關鍵字時才會進入人工佇列。

最佳實踐：不要把所有邏輯都放在自動流程中。對於複雜問題或緊急情況，盡快讓用戶進入人工佇列，避免用戶因等待而流失。

第五步：上線測試與營運檢查清單

整合完成後，建議按以下清單進行全鏈路測試：

• Bot 連線測試：在 Telegram 中向你的 Bot 發送一則訊息，確認控制台「訊息日誌」中能即時顯示。
• 坐席登入測試：用坐席帳號登入 Web 控制台，確認能看到該對話並可以回覆。
• 對話流轉測試：讓兩個坐席同時在線，發送第二則訊息，確認對話分配規則生效（輪流或在線優先）。
• 分流連結測試：在一個無痕瀏覽器中點擊分流連結，確認跳轉到 Bot 且自動發送了預設訊息；然後在控制台查看該對話的歸因資訊（IP、瀏覽器、URL 參數）。
• 自動翻譯測試：如果啟用了翻譯，用非中文語言發送訊息，確認坐席側能看到翻譯後的文字。
• 內容風控測試（專業版）：如果配置了風險詞組，嘗試發送包含關鍵字的訊息，確認坐席側會觸發彈窗或攔截。

常見問題

問：連線 Bot 時提示 Token 無效怎麼辦？ 答：請確保從 BotFather 取得的是完整的 HTTP API Token（格式如 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11），且沒有多餘空格。如果仍無效，嘗試在 BotFather 中 /revoke 後重新產生。

問：坐席登入後看不到任何對話，如何排查？ 答：請檢查以下三項：① 坐席帳號是否已分配該專案的權限；② 對話分流規則是否包含該坐席；③ Bot 是否已收到新用戶訊息（可在控制台查看訊息日誌）。

問：分流連結可以用於 Google Ads 追蹤嗎？ 答：可以。分流連結會自動擷取訪客 IP、瀏覽器資訊和 URL 參數（包括 utm_source 等），你可以在控制台查看每條對話的歸因來源，用於廣告效果分析。

問：免費試用期間可以使用所有功能嗎？ 答：是的。註冊即享 3 天免費試用，期間可體驗標準版全部功能（包括分流連結與坐席）。到期後需選擇方案續費才能繼續使用。

問：如何將現有 Bot 的用戶資料遷移到 TG-Staff？ 答：TG-Staff 不要求用戶資料遷移。你只需將 Bot Token 接入控制台，新訊息會自動進入系統。歷史訊息可透過 Bot API 的 getUpdates 方法手動拉取，但建議直接開始新對話記錄。

總結與下一步行動

透過以上五個步驟，你已經將你的 tg bot 成功接入 TG-Staff 統一控制台。現在，你的團隊可以在 Web 工作台上協作處理客服對話，利用分流連結追蹤廣告轉換，並透過視覺化流程實現自動化接待。整個整合過程無需編寫程式碼，只需在控制台中進行配置即可。

下一步，建議你：

• 點擊 app.tg-staff.com 免費試用 3 天，體驗完整功能。
• 查閱 官方文件 了解更高階的配置（如自訂命令、資料匯出）。
• 如果遇到問題，直接聯繫 @tgstaff_robot 取得一對一技術支援。