Teleform Webhook 推送線索到 Telegram Bot：逐步配置與字段映射教程

在 B2B 跨國業務中，表單是獲取客戶線索的核心管道之一。但傳統郵件通知有延遲高、開啟率低、難以即時跟進等問題。當客戶提交諮詢、試用申請或活動報名表單後，如果客服團隊無法在第一時間回應，線索很可能會在幾分鐘內流失。

本文將教你如何透過 Teleform Webhook 將表單線索即時推送到 Telegram Bot，實現自動化通知與坐席即時承接。我們將以 TG-Staff 作為 Webhook 接收與訊息推送的中轉平台，提供完整的設定步驟、欄位對應技巧與常見問題排查指南。

為什麼需要將 Teleform Webhook 與 Telegram Bot 打通？

將表單線索直接推送到 Telegram，核心價值在於縮短回應時間與減少人工輪詢。具體來說：

• 即時性：表單提交後 1–2 秒內，客服坐席即可在 Telegram 收到訊息，無需登入信箱或刷新後台。
• 高開啟率：Telegram 訊息的開啟率遠高於郵件，尤其適合行動辦公室的遠端團隊。
• 可協作：訊息推送至群組或客服坐席後，可直接在 Telegram 內回覆、指派或標記跟進狀態。
• 可自動化：結合 Bot 的自動回覆與分流規則，複雜表單（如多步驟諮詢）也能妥善處理。

典型使用場景

以下場景特別適合將 Teleform Webhook 與 Telegram Bot 打通：

1. 活動報名即時通知：用戶提交活動報名表單後，Bot 自動將報名資訊（姓名、公司、聯絡資訊）推送至營運群組，營運人員可立即發送確認訊息或補充資料。
2. 售前諮詢即時分配：潛在客戶在官網填寫諮詢表單，Webhook 將線索推送至 TG-Staff 控制台，系統按分流規則自動分配給在線坐席，坐席在 Web 端或 Telegram 內直接回复。
3. 試用申請跟進：用戶提交 SaaS 產品試用申請後，Bot 即時推送試用資訊給銷售團隊，銷售可快速聯絡客戶並開通試用權限。
4. 售後工單自動建立：客戶提交故障報修表單，Webhook 將工單內容推送到技術支援群組，同時 Bot 自動回覆客戶一個工單編號。

Teleform Webhook 的工作原理簡介

Webhook 是一種反向 API 呼叫機制。當使用者在 Teleform 中提交表單時，Teleform 伺服器會向預先設定的 URL 傳送 HTTP POST 要求，請求體中包含表單的全部欄位資料（如姓名、郵件信箱、留言等）。

TG-Staff 作為接收端，會解析這個請求，將欄位資料對應為 Telegram 訊息的文字內容，然後透過 Bot API 推送到指定的 Telegram 聊天視窗（個人或群組）。整個過程無需編寫任何程式碼，只需在兩端完成 URL 配置。

前提條件：你需要準備什麼？

在開始設定之前，請確保已準備好以下四項資源：

1. 一個已註冊的 Telegram Bot：透過 @BotFather 建立 Bot，取得 Bot Token（格式類似 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11）。
2. 一個可接收訊息的 Chat ID：Bot 推播訊息的目標聊天視窗 ID（個人或群組）。
3. 一個可用的 Teleform 表單：已建立並發布，包含至少一個欄位（如姓名、郵箱）。
4. TG-Staff 帳號：用於建立 Bot 專案並取得 Webhook 接收 URL。

第一步：在 TG-Staff 中建立 Bot 專案並取得 API 端點

TG-Staff 提供了一個零程式碼的 Webhook 接收層，Teleform 提交的資料會自動被解析並推送到你的 Bot。

1. 登入 TG-Staff 控制台。
2. 點選「建立專案」，輸入你的 Bot Token（從 @BotFather 取得）。
3. 系統會自動驗證 Token 有效性，並完成 Bot 與 TG-Staff 的綁定。

配置 Bot 專案的基本設置

建立專案後，進入專案設定頁面：

• 設定 Bot 名稱與頭像：可直接在 TG-Staff 控制台內編輯，無需跳轉 BotFather。
• 設定歡迎語：當使用者首次透過 Bot 發送訊息時，Bot 會自動回覆此歡迎語（建議包含簡短的產品介紹與引導）。
• 確認 Bot 狀態：確保 Bot 在 Telegram 中處於活躍狀態，且未被使用者封鎖。

取得專屬 Webhook URL

在專案設定的「Webhook 設定」部分，你會看到一個自動產生的 URL，格式類似：

https://app.tg-staff.com/webhook/{unique-id}

這個 URL 就是你要填到 Teleform 中的目標位址。 TG-Staff 會自動處理接收、解析與推送邏輯，你不需要寫任何後端程式碼。

第二步：在 Teleform 中設定 Webhook 推播

接下來，將 TG-Staff 提供的 URL 設定到 Teleform 的 Webhook 設定中。

1. 登入 Teleform 後台，找到目標表單的「整合」或「Webhook」設定頁面。
2. 新增一個新的 Webhook 端點：
   • 目標 URL：貼上 TG-Staff 提供的 Webhook URL。
   • 請求方法：選擇 POST（絕大多數 Webhook 使用 POST）。
   • 資料格式：選擇 JSON 或 表单数据，TG-Staff 兩種格式皆支援。
3. 儲存配置。

第三步：測試與驗證推送鏈路

配置完成後，請務必進行端對端測試，確保連結通暢。

1. 在 Teleform 中提交一條測試資料（例如：姓名=“測試用戶”，郵箱=“[email protected]”，留言=“這是一條測試訊息”）。
2. 檢查你的 Telegram（目標 Chat ID 對應的聊天視窗）是否收到訊息。訊息內容應包含你提交的欄位資料。
3. 若收到訊息，確認欄位內容完整、格式正確。若未收到，進入下一步排查。

常見錯誤排查清單

問題	可能原因	解決步驟
404 錯誤	Webhook URL 填寫錯誤	檢查 URL 是否完整，有無多餘空格或字元
欄位對映失敗	欄位名稱包含中文或特殊字元	在 Teleform 中將欄位名稱改為英文（如 name、phone）
訊息格式異常	資料格式不符	確認 Teleform 的請求格式為 JSON，TG-Staff 預設解析 JSON
Bot 無回應	Bot Token 錯誤或 Bot 被刪除	在 TG-Staff 控制台重新驗證 Bot Token
推送延遲	Teleform 伺服器網路問題	檢查 Teleform 的 Webhook 發送日誌，確認請求已發出
訊息內容為空	表單欄位未正確對應	在 TG-Staff 的訊息範本中手動指定欄位對應（請參閱下一步）

如果以上步驟都無法解決，可以在 TG-Staff 控制台的「Webhook 日誌」中查看最近的請求記錄。日誌會顯示收到的原始資料與推播狀態，幫助你定位問題。

第四步：進階設定－欄位對應與訊息模板

預設情況下，TG-Staff 會將 Teleform 提交的所有欄位拼接為一條簡單訊息。但你可以透過自訂訊息範本，讓推播內容更清晰、可讀性更強。

在 TG-Staff 專案設定的「訊息範本」中，你可以使用佔位符來引用表單欄位。例如：

📋 新线索通知
━━━━━━━━━━━━━━━━━━
👤 姓名：{name}
📧 邮箱：{email}
📞 电话：{phone}
💬 需求：{message}
🕐 提交时间：{timestamp}

• {name}、{email} 等佔位符會自動替換為 Teleform 提交的對應欄位值。
• 支援 Markdown 格式（如加粗、清單），增強可讀性。
• 可新增固定前綴（如公司名稱、表單來源），方便區分不同管道的線索。

如果 Teleform 中的欄位名稱與佔位符不一致，你可以在訊息範本中使用欄位別名對應。例如，若 Teleform 欄位名為 full_name，但你要顯示為「姓名」，可寫成：

👤 姓名：{full_name}

最佳實踐：提升線索回應率

完成基礎配置後，以下幾個實操建議可以幫助你最大化線索轉換效果：

1. 設定坐席自動分配：在 TG-Staff 中配置會話分流規則。當線索推送後，系統會自動分配給線上坐席，減少人工分配延遲。
2. 使用分流連結追蹤來源：如果線索來自不同管道（如廣告、社媒、郵件），可在 Teleform 中嵌入 TG-Staff 的分流連結參數，實現管道歸因。
3. 結合自動翻譯處理多語言表單：如果客戶使用非母語填寫表單，TG-Staff 的自動翻譯功能可以將訊息翻譯為坐席的語言，避免溝通障礙。
4. 定期檢查 Webhook 健康狀態：在 TG-Staff 控制台中查看 Webhook 請求日誌與成功率。如果發現失敗率上升，及時檢查 Teleform 或 Bot 狀態。
5. 設定內容風控規則：對於敏感表單（如涉及付款、個人資訊），在 TG-Staff 中配置風險詞組，防止坐席誤發或違規發送訊息。

常見問題

**問：Teleform Webhook 是否支援同時推送到多個 Telegram Bot？ ** 答：TG-Staff 支援一個 Bot 專案綁定一個 Webhook 端點。如需推送到多個 Bot，可在 Teleform 中設定多個 Webhook URL，或使用 TG-Staff 的會話分流規則將線索指派給不同坐席。

**問：提交測試表單後 Telegram 收不到訊息，可能是什麼原因？ ** 答：常見原因包括：Bot Token 錯誤、Chat ID 未綁定、Teleform 的 Webhook URL 填寫錯誤、或 TG-Staff 項目未完成啟動。請依序檢查以上四項，並在 TG-Staff 控制台查看 Webhook 請求日誌。

**問：Teleform 中的中文欄位名稱會導致推送失敗嗎？ ** 答：部分 Bot API 對非 ASCII 欄位名處理可能不穩定。建議在 Teleform 中將欄位名稱改為英文（如 name、phone），在 TG-Staff 的訊息範本中再對應為中文顯示。

**問：如何避免 Webhook 推送被惡意呼叫？ ** 答：TG-Staff 的 Webhook URL 包含唯一識別碼，不易被猜測。如需更高安全性，可在 Teleform 側設定 IP 白名單或新增簽章驗證。

**問：Teleform Webhook 推送的資料量是否有限制？ ** 答：TG-Staff 對單一訊息長度有限制（約 4096 字元），超出部分可能會被截斷。建議在 Teleform 中精簡表單字段，或將長文字作為附件連結發送。

---

透過上述步驟，你已經掌握了將 Teleform Webhook 與 Telegram Bot 打通的完整方法。這套方案不僅適用於 B2B 線索通知，還能廣泛應用於活動報名、售後工單、內部分配等場景。

立即註冊 TG-Staff 免費試用（3 天），體驗 Webhook 自動推送與客服坐席協同。如需更詳細的 API 配置說明，請查閱 官方文件，或聯絡 @tgstaff_robot 以取得一對一技術支援。