系統整合傳出 Webhook 指南

傳出 Webhook 功能讓 ABC Sales Bot 能夠在特定事件發生時，向你的外部系統發送即時通知。對於需要在多個平台之間保持資料同步的企業來說，這項功能至關重要，例如 CRM、庫存管理系統或客製化的數據分析儀表板。

你不必持續輪詢我們的 API 來檢查變更（這樣效率很低），而是可以訂閱事件。當事件發生時（例如潛在客戶被建立或更新），我們會立即將相關資料推送到你提供的 URL。

主要使用情境

• 即時 CRM 同步： 在潛在客戶於 ABC Sales Bot 中建立或修改的那一刻，立即在你的 CRM（例如 Salesforce、HubSpot）中建立或更新聯絡人
• 自動化執行與營運： 在你的內部系統中觸發一個流程，例如將新的潛在客戶指派給區域銷售團隊，或在你的行銷平台上啟動歡迎序列
• 資料倉儲中心化： 將所有潛在客戶和對話資料推送到集中的數據分析平台（如 Google BigQuery 或客製化儀表板），以進行進階報表分析
• 客製化通知： 當重要事件發生時（例如潛在客戶被升級轉真人），向 Slack 或 Microsoft Teams 等團隊溝通平台發送客製化通知

如何設定傳出 Webhook

設定 Webhook 的流程非常簡單。

1. 從主選單前往 Outgoing Webhooks（傳出 Webhooks）頁籤
2. 點擊 Create Webhook（建立 Webhook）按鈕
3. 會出現一個設定視窗，填寫以下詳細資訊
4. 點擊 Create Webhook 儲存並啟用它

設定欄位：

• Webhook URL（必填）： 最重要的欄位。輸入你的外部系統中已準備好接收資料的專屬 URL。
• Event Types（事件類型）： 選擇你想訂閱的特定事件。你可以訂閱單一事件，也可以訂閱全部事件。
• Custom Headers（自訂標頭，選填）： 為你的 Webhook 請求加入靜態標頭值，可用於你伺服器上的身分驗證或路由。
• Max Retries（最大重試次數）： 當你的服務停機或回傳錯誤時，我們嘗試重新發送事件的次數。重試採用指數退避策略，以避免你的系統負載過高。
• Max Concurrency（最大並發數）： 我們同一時間可以發送的 Webhook 數量。預設值通常足以應付大多數使用情境。

主要事件類型包括：

• leads_created
• leads_updated
• leads_deleted
• leads_escalation_requested
• conversation_created

你可以建立多個 Webhook，例如你想把不同的事件發送到不同的系統。

安全性：使用密鑰驗證負載

為了確保你的伺服器收到的請求確實來自 ABC Sales Bot，我們會對每個 Webhook 負載進行簽名。

檢視密鑰

1. 在 Outgoing Webhooks 頁面上，點擊你的 Webhook 旁邊的三點選單，選擇 Edit（編輯）
2. 點擊 Show Secret Key（顯示密鑰）
3. 該密鑰是你的 Webhook 獨有的。你必須在伺服器上使用該密鑰來驗證傳入負載的簽名

驗證邏輯

我們會在每個請求的標頭中包含一個加密簽名。你的伺服器可以使用共享的密鑰，根據請求主體重新計算簽名。如果兩者相符，你就可以確定該請求是真實的且未被竄改。

重新生成密鑰

如果你認為密鑰已經外洩，可以隨時重新生成。重新生成後，請記得同步更新你伺服器上的密鑰。

了解負載

當事件被觸發時，我們會向你的 URL 發送一個帶有 JSON 主體的 POST 請求。負載中始終包含：

• event_type： 發生的事件名稱（例如 leads_updated）
• company_id： 你公司的唯一識別碼
• 相關的物件資料： 對於 leads_created 和 leads_updated，這是完整的潛在客戶物件；對於 leads_deleted，我們只發送 lead_id，因為完整物件已不存在

疑難排解：Webhook 日誌

為了診斷 Webhook 傳送問題，每個端點都提供了詳細的日誌。

1. 在主列表中點擊一個已設定的 Webhook
2. 這會開啟 Webhook Log（Webhook 日誌）畫面，顯示發送到該 URL 的所有事件歷史

對於每個事件，你可以看到：

• 狀態： 成功顯示綠色勾號，失敗顯示紅色警告
• 嘗試次數： 已進行的重試次數
• 請求時長： 你的系統回應所花費的時間。這對於發現你這一端的效能緩慢或逾時問題很有幫助
• 查看詳情： 點擊可查看我們發送的確切請求負載，以及從你的伺服器收到的回應主體（和狀態碼）。這對除錯非常有價值，因為一旦出錯，它會準確地告訴你問題出在哪裡