Webhooksとは？
Webhookにより、Mercateerのフロントオフィスイベントがリアルタイムでお客様が管理するURLにプッシュされるため、APIをポーリングせずに自社システムが反応できます。各配信はHMACで署名されたJSONペイロードであり、エンドポイントはAPIまたはダッシュボードから登録・管理できます。配信失敗時にはバックオフ付きで再試行されます。
Webhooksでできること
新規リード取得および顧客情報作成
会話の開始・終了・引き継ぎ依頼
通話の終了
予約確定および予約再スケジュール
見積もりの承諾
受信時に検証可能なHMAC署名付きペイロード
APIまたはダッシュボードからエンドポイントを登録・管理
数分でインストール
1
エンドポイントを作成
APIまたは［設定］→［開発者］からURLを登録し、購読するイベントを選択してください。Mercateerはそのエンドポイント用の署名シークレットを返却します。APIアクセスはCrewプランおよびFleetプランに含まれています。
2
署名を検証
受信のたびに、署名ヘッダーからタイムスタンプ（t）と署名（v1）を読み取り、署名用シークレットを使って文字列 "{timestamp}.{raw request body}" のHMAC-SHA256を計算し、v1の値と照合します。一致しないリクエストや、タイムスタンプが5分以上前のリクエストは拒否してください。こうすることで、確実にMercateerから送られた新しいペイロードだけを処理できます。（当社SDKの検証ヘルパーが、この処理をすべて代行します。）
3
再試行をべき等性（idempotent）で処理
配信を迅速に2xxで応答して受領を通知してください。失敗した配信はバックオフ付きで再試行されるため、ハンドラーはイベントIDをキーにして重複を無視し、各イベントを一度だけ処理するようにしてください。
よくある質問
既存のツール群と完全連携
Mercateerは、すでにご利用中のツールと同じプロトコルで動作します。