Webhooks 是什麼？
Webhook 會即時將 Mercateer 前線辦公事件推送至您控制的 URL，讓您的系統無需輪詢 API 即可即時反應。每次傳遞均為經 HMAC 簽署的 JSON 資料，您可透過 API 或儀表板註冊與管理端點，失敗的傳遞會自動退避重試。
使用 Webhooks 可以做什麼
新潛在客戶已擷取且聯絡人已建立
對話開始、結束或要求轉真人
通話結束
工作已預約且預約已重新安排
報價被接受
接收時可驗證的 HMAC 簽署資料
透過 API 或儀表板註冊與管理端點
幾分鐘內完成安裝
1
建立端點
透過 API 或在「設定」>「開發者」中註冊您的 URL，並選擇要訂閱的事件。Mercateer 會為該端點返回簽署密鑰。Crew 與 Fleet 方案皆包含 API 存取權。
2
驗證簽章
每次收到推送時，先從簽章標頭讀取時間戳記（t）和簽章（v1），再用你的簽署密鑰計算字串 "{timestamp}.{raw request body}" 的 HMAC-SHA256，並與 v1 的值比對。凡是不相符、或時間戳記超過 5 分鐘的請求都應拒絕，這樣你只會處理確實來自 Mercateer 的最新內容。（我們 SDK 的驗證輔助函式會幫你完成這些步驟。）
3
以冪等方式處理重試
快速回應 2xx 狀態碼以確認接收。失敗的傳遞會自動退避重試，請以事件 ID 為依據設計處理程式，忽略重複項目，確保每個事件僅處理一次。
常見問題
與您的完整技術堆疊協作
Mercateer 採用與您現有工具相同的通訊協定。