Box スポークの双方向 Webhook のセットアップ

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む3読むのに数分

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

    始める前に

    • IntegrationHub Professional サブスクリプションの要求
    • Box スポークの有効化
    • 必要なロール：admin

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

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

    始める前に

    必要なロール：admin

    手順

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

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

    3. アプリのプライマリ キーとセカンダリ キーを生成し、値を記録します。
      1. [ 自分のアプリ] で、アプリケーションを選択します。
        アプリケーションの 一般設定にいます。
      2. [ Webhooks] に移動します。
      3. [ 署名キーの管理] を選択します。
      4. [主キー] セクションで、[ キーの生成] を選択します。
      5. [セカンダリ キー] セクションで、[ キーの生成] を選択します。
      6. 後で使用するために両方のキー値をコピーして保存します。
    4. [ Webhooks ] セクションに移動します。
    5. V1 ウェブフックを作成するには、 [ ウェブフックの作成 ] を選択し、 V1 を選択します。
      1. フィールドに入力します。

        フィールド

        値

        名前

        Chatter フィードを更新

        説明

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

        イベントタイプ

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

        エンドポイント URL

        インスタンスのServiceNowエンドポイント URL (https://<instance-name>.service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint の形式

        ペイロード形式

        適切なペイロードデータ形式を選択します

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

        [ コールバックパラメーターの追加 ] を選択して、GET または POST メソッドを構成します
      2. [ ウェブフックの保存] を選択します。
    6. V2 Webhook を作成するには、[ Webhook を作成 ] を選択し、[ V2] を選択します。
      注:
      V2 Webhook を作成するには、[構成] 設定で [Webhook の管理] を有効にする必要があります。詳細については、「OAuth アプリケーションの作成」を参照してください。
      1. [URL アドレス] に、インスタンスの ServiceNow エンドポイント URL を https://<instance-name>.service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint の形式で入力します。
      2. [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 インスタンスに登録されます。