設定ガイド

レビューを Webhook に送る

組み込みの連携がないツール向けに、一致するレビューを JSON の POST リクエストとして自社のエンドポイントに送ります。Enterprise で利用できます。

Webhook を接続する

  1. 1

    アプリを接続する

    まず Apps & Businesses でアプリを追加します(App Store、Google Play)。
  2. 2

    送信先を開く

    Automation & AI Replies を開き、Manage destinations(または Add destination)を選びます。
  3. 3

    受信側を用意する

    JSON 本文の POST リクエストを受け付け、2xx ステータスを返す HTTPS エンドポイントを作成します。
  4. 4

    Webhook を追加する

    Webhook を選び、HTTPS の URL を貼り付けて保存します。署名シークレットをコピーしてください。表示されるのは一度だけです。
  5. 5

    フィルターを設定する

    評価の範囲とキーワードを選ぶか、空のままにしてすべてのレビューを受け取ります。

リクエストを検証する

  • 各リクエストには X-ReviewExpert-Timestamp と X-ReviewExpert-Signature が含まれます。署名は v1= に続けて、タイムスタンプ、ドット、生の本文をつないだ文字列を署名シークレットで HMAC-SHA256 計算した 16 進値です。
  • 署名を再計算して定数時間で比較し、5 分より古いタイムスタンプは拒否してください。
  • X-ReviewExpert-Delivery は再試行でも変わらないため、重複排除に使えます。