Webhooks 是什麼？
Webhook 會即時將 Mercateer 前線辦公事件推送至您控制的 URL，讓您的系統無需輪詢 API 即可即時反應。每次傳遞均為經 HMAC 簽署的 JSON 資料，您可透過 API 或儀表板註冊與管理端點，失敗的傳遞會自動退避重試。
使用 Webhooks 可以做什麼
新潛在客戶已擷取且聯絡人已建立
IntegrationPages.Conversation started, closed, or handoff requested
IntegrationPages.Call completed
工作已預約且預約已重新安排
IntegrationPages.Quote accepted
接收時可驗證的 HMAC 簽署資料
透過 API 或儀表板註冊與管理端點
幾分鐘內完成安裝
1
建立端點
透過 API 或在「設定」>「開發者」中註冊您的 URL，並選擇要訂閱的事件。Mercateer 會為該端點返回簽署密鑰。Crew 與 Fleet 方案皆包含 API 存取權。
2
驗證簽章
IntegrationPages.On every delivery, read the timestamp (t) and signature (v1) from the signature header, then compute the HMAC-SHA256 of the string "{timestamp}_{raw request body}" with your signing secret and compare it to the v1 value_ Reject any request that does not match, or whose timestamp is more than 5 minutes old, so you only act on fresh payloads that truly came from Mercateer_ (Our SDK’s verify helper does all of this for you_)
3
以冪等方式處理重試
快速回應 2xx 狀態碼以確認接收。失敗的傳遞會自動退避重試，請以事件 ID 為依據設計處理程式，忽略重複項目，確保每個事件僅處理一次。
常見問題
與您的完整技術堆疊協作
Mercateer 採用與您現有工具相同的通訊協定。