潛在客戶網路鉤子問題
本指南協助您疑難排解接收的潛在客戶網路鉤子，讓來自外部來源（廣告表單、登陸頁面、CRM）的新潛在客戶可靠地抵達 ABC Sales AI。
網路鉤子返回錯誤
問題： 傳送網路鉤子的系統報告失敗或非成功狀態代碼。
可能原因：
- 網路鉤子 URL 不正確或已變更
- 驗證 token 或密鑰缺少或錯誤
- 請求酬載不是有效的 JSON
- 傳送服務無法觸及我們的端點
解決方案：
- 從您的 ABC Sales AI 設定中複製確切的網路鉤子 URL，並確認沒有多餘的空格
- 在每個請求中包含所需的驗證標頭或 token
- 在傳送前驗證酬載是格式正確的 JSON
- 檢查狀態頁面以了解任何端點中斷
未建立潛在客戶
問題： 網路鉤子返回成功，但沒有潛在客戶出現。
可能原因：
- 酬載中缺少必填欄位（例如姓名或電話號碼）
- 酬載中的欄位名稱與預期的對應不符
- 潛在客戶已與現有聯絡人去重複
- 篩選或路由規則排除了該潛在客戶
解決方案：
- 確認酬載包含所有必填欄位且欄位名稱正確
- 檢閱您的欄位對應，使傳入的鍵對應到正確的潛在客戶屬性
- 檢查潛在客戶是否符合現有聯絡人而被合併而非建立
- 檢閱任何可能丟棄潛在客戶的傳入篩選或路由規則
已建立潛在客戶但資料不完整或錯誤
問題： 潛在客戶出現，但某些欄位為空或包含錯誤的值。
可能原因：
- 欄位對應不符或部分對應
- 資料格式異常（例如沒有國家代碼的電話號碼）
- 酬載中未對應的巢狀欄位
解決方案：
- 端對端稽核欄位對應，並新增任何缺少的欄位
- 在來源處正規化值（使用國際電話格式，例如 +15551234567）
- 攤平或明確對應巢狀酬載欄位
驗證網路鉤子
> 提示： 在上線前，使用已知的範例酬載傳送測試請求。這可確認 URL、驗證和對應都能協同運作。
- 傳送一個測試潛在客戶，並確認它以正確的資料出現
- 檢閱傳送平台上的傳遞日誌，以查看我們返回的回應
- 驗證後，啟用即時整合
仍有問題？
如果潛在客戶仍無法抵達：
- 擷取確切的請求酬載和回應狀態代碼
- 記下傳送網路鉤子的來源平台
- 聯絡我們的支援團隊，並提供這些詳細資訊以及失敗請求的大約時間