接收網路鉤子

接收網路鉤子整合允許您從現有系統將潛客資訊和更新推送到 ABC Salesbot。

概覽

網路鉤子提供強大的方式來：

• 自動建立和更新潛客
• 觸發自動化
• 從外部系統同步資料
• 與自訂應用程式整合

API 金鑰和驗證

安全功能

• 所有網路鉤子請求都需要安全的 API 金鑰
• Bearer token 驗證
• 可顯示/隱藏金鑰以確保安全
• 建議定期輪換金鑰

網路鉤子設定

• 每個帳戶的自訂端點 URL
• JSON 負載支援
• 詳細的請求日誌
• 完整的錯誤處理

自動化控制

網路鉤子負載中的 automations 欄位支援三種強大的模式來管理潛客自動化：

1. 訂閱模式

將潛客新增至特定自動化，同時保留現有註冊：

{
  "automations": {
    "subscribe": ["automation-name-first", "automation-name-second"],
    "unsubscribe": null,
    "replace": null
  }
}

2. 取消訂閱模式

從特定自動化中移除潛客：

{
  "automations": {
    "subscribe": null,
    "unsubscribe": ["automation-to-remove"],
    "replace": null
  }
}

3. 替換模式

確保潛客僅註冊於指定的自動化：

{
  "automations": {
    "subscribe": null,
    "unsubscribe": null,
    "replace": ["only-automation-to-keep"]
  }
}

自訂欄位支援

可用欄位類型

• 文字欄位：用於一般資訊
• 日期欄位：用於排程和追蹤
• 數字欄位：用於定量資料

欄位功能

• 必填欄位驗證
• 資料類型驗證
• 預設值
• 欄位相依性

包含自訂欄位的範例負載

{
  "name": "John Doe",
  "email": "john@example.com",
  "custom_fields": {
    "company_name": "Acme Corp",
    "contract_renewal_date": "2024-12-31",
    "employee_count": 500
  }
}

最佳實踐

1. 錯誤處理

   • 實作重試邏輯
   • 記錄失敗的請求
   • 監控網路鉤子健康狀態

2. 安全性

   • 定期輪換 API 金鑰
   • 使用 HTTPS 端點
   • 驗證負載資料

3. 效能

   • 保持負載簡潔
   • 盡可能批次更新
   • 監控回應時間

測試和除錯

測試環境

• 使用 curl 進行基本測試
• 實作網路鉤子監控
• 記錄所有網路鉤子活動

常見問題

• 驗證錯誤
• 格式錯誤的負載
• 缺少必填欄位
• 速率限制

下一步

• 網路鉤子範例
• API 參考