設定ガイド
レビューを Webhook に送る
組み込みの連携がないツール向けに、一致するレビューを JSON の POST リクエストとして自社のエンドポイントに送ります。Enterprise で利用できます。
Webhook を接続する
- 1
アプリを接続する
まず Apps & Businesses でアプリを追加します(App Store、Google Play)。 - 2
送信先を開く
Automation & AI Replies を開き、Manage destinations(または Add destination)を選びます。 - 3
受信側を用意する
JSON 本文の POST リクエストを受け付け、2xx ステータスを返す HTTPS エンドポイントを作成します。 - 4
Webhook を追加する
Webhook を選び、HTTPS の URL を貼り付けて保存します。署名シークレットをコピーしてください。表示されるのは一度だけです。 - 5
フィルターを設定する
評価の範囲とキーワードを選ぶか、空のままにしてすべてのレビューを受け取ります。
リクエストを検証する
- 各リクエストには X-ReviewExpert-Timestamp と X-ReviewExpert-Signature が含まれます。署名は v1= に続けて、タイムスタンプ、ドット、生の本文をつないだ文字列を署名シークレットで HMAC-SHA256 計算した 16 進値です。
- 署名を再計算して定数時間で比較し、5 分より古いタイムスタンプは拒否してください。
- X-ReviewExpert-Delivery は再試行でも変わらないため、重複排除に使えます。
