Box スポーク用の双方向 Webhook の設定

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：3分

    • ServiceNow コールバック URL を使用して、Box を登録する Webhook を構成します。

    始める前に

    • 統合ハブサブスクリプションを要求します。
    • Box スポークを有効にします。
    • 必要なロール：admin

    Box アカウントにエンドポイント URL を追加する

    Box アカウントでエンドポイント URL を指定して、Box スポーク用 Webhook を作成します。

    始める前に

    必要なロール：admin

    手順

    1. Box 開発者コンソールにログインします。
    2. 要件に従ってアプリを作成します。

      アプリ作成の詳細については、「OAuth アプリケーションの作成」を参照してください。

    3. アプリのプライマリキーとセカンダリキーを生成し、キー値を記録します。
      1. [自分のアプリ] で、アプリケーションを選択します。
        アプリケーションの [全般設定] が表示されます。
      2. [Webhooks] に移動します。
      3. [署名キーの管理 (Manage Signature Keys)] を選択します。
      4. [プライマリキー ] セクションで、[キーの生成] を選択します。
      5. [セカンダリキー] セクションで、[キーの生成] を選択します。
      6. 後で使用するために両方のキー値をコピーして保存します。
    4. [Webhooks] セクションに移動します。
    5. V1 webhook を作成するには、[Webhook を作成] を選択し、[V1] を選択します。
      1. フィールドに入力します。

        フィールド

        値

        名前

        Chatter フィードを更新

        説明

        変更が発生したときに Chatter フィードを自動的に更新する

        イベントタイプ

        		 少なくとも 1 つのオプションを有効にする

        エンドポイント URL

        下記フォーマットの ServiceNow インスタンスのエンドポイント URL：https://<instance-name>.service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint

        ペイロードフォーマット

        適切なペイロードデータフォーマットを選択します

        コールバックパラメーター

        [コールバックパラメーターの追加 (add callback parameter)] を選択して、GET または POST メソッドを構成します
      2. [Webhoook の保存 (Save Webhoook)] を選択します。
    6. V2 webhook を作成するには、[Webhook を作成] を選択し、[V2] を選択します。
      注:
      V2 Webhook を作成するには、[構成] 設定で [Webhook の管理 (Manage webhooks)] を有効にする必要があります。詳細については、「OAuth アプリケーションの作成」を参照してください。
      1. URL アドレスについては、下記フォーマットの ServiceNow インスタンスのエンドポイント URL を入力してください：https://<instance-name>.service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint。
      2. [Webhook をトリガーするアイテムの種類 (The type of item to trigger a webhook)] で、[アイテムを選択] を選択します。
      3. Webhook で構成されたファイルまたはフォルダーを選択します。
      4. 確定するには [選択] を選択します。
        構成された Webhook トリガーのリストが [Webhook を作成] ページに表示されます。
      5. トリガーごとに適切な GET メソッドと POST メソッドを有効にします。
      6. 確定するには、[Webhook を作成] を選択します。

    タスクの結果

    エンドポイント URL が Box アカウントに追加されます。要件に従って Webhook レジストリとサブフローを作成できます。

    ServiceNow に Box Webhook を登録する

    ServiceNow に Box Webhook レジストリを作成して、Box アカウントで特定のイベントが発生したときに ServiceNow アプリに通知します。

    始める前に

    必要なロール：admin

    手順

    1. ServiceNowで、 すべて > ボックス > Box Webhook レジストリ.
    2. [新規] を選択します。
    3. フィールドに入力します。

      フィールド

      値

      名前

      必要に応じて、Webhook レジストリに名前を付けます。

      トリガー名

      適切なイベントトリガーを選択します。

      プライマリキー

      Box アカウントにエンドポイント URL を追加する で生成したプライマリキー

      フロー名

      イベントがトリガーされたときに発生するフロー

      セカンダリキー

      Box アカウントにエンドポイント URL を追加する で生成したセカンダリキー

      説明

      必要に応じて、レコードの目的を説明します
    4. 確認するには、[送信] を選択します。

    タスクの結果

    Box Webhook が ServiceNow インスタンスに登録されます。