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

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：3分

    • ServiceNow コールバック URL で Aha! アカウントのイベントを登録する Webhook を構成します。

    始める前に

    必要なロール：admin

    トークンを作成

    Aha!へのコールバック URL に埋め込むトークンを作成します。

    始める前に

    必要なロール：admin

    手順

    1. ナビゲーションフィルターで、「 token_verification.list」と入力します。
      トークン検証テーブルにレコードが表示されます。
    2. [New (新規)] を選択します。
    3. フォームの各フィールドに入力します。
      表 : 1. トークン検証フォーム
      フィールド 説明
      名前 トークンを識別する一意の名前を指定するオプション。たとえば、 Aha! コールバック URL トークン 。
      説明 トークンの説明を入力するオプション。
      トークン 一意の認証トークンを提供するオプション。このトークンは暗号化され、URL に埋め込まれます。
    4. [Submit (送信)] を選択します。

    で Aha! Webhook を作成する ServiceNow

    Aha! Webhook を登録して、Aha!で特定のイベントが発生したときにアプリに通知します。

    始める前に

    必要なロール：admin

    手順

    1. 移動先 すべて > Aha! スポーク > Webhook > Webhook レジストリ。
    2. [New (新規)] を選択します。
    3. フォームに入力します。
      表 : 2. Aha! Webhook レジストリー
      フィールド 説明
      名前 レコードを一意に識別するオプション。
      パス Webhook パスを指定するオプション。「api/sn_aha_spoke/aha_webhook」と入力します。
      トークン 作成したトークンを指定するオプション。「トークンを作成」を参照してください。
    4. フォームヘッダーを右クリックし、[保存] をクリックします。
    5. [コールバック URL] を選択します。
      Webhook コールバック URL が表示されます。
    6. Webhook コールバック URL をコピーして記録します。

    へのコールバック URL の追加 Aha!

    Webhook コールバック URL を Aha! アカウントに登録します。

    始める前に

    必要なロール：admin

    手順

    1. アドミニストレーターとして Aha! アカウントにログインします。
    2. 移動先 設定 > アカウント.
    3. [データ連携] の横にある [+] をクリックして、アクティビティ Webhook を作成します。
    4. [アクティビティ Webhook (Activity webhook)] タイルで [+ アクティビティ Webhook (+ Activity webhook)] をクリックします。
    5. フォームに、これらの値を入力します。
      フィールド 説明
      フック URL ServiceNow インスタンスからコピーした Webhook コールバック URL。
      選択されたアクティビティ 登録するアクティビティまたはイベント。
    6. [アクティビティを追加] をクリックします。

    Webhook ルーティングポリシーを設定

    要件に応じて、Webhook ルーティングポリシーとサブフローを作成します。

    始める前に

    必要なロール：admin

    このタスクについて

    Aha Webhook 決定ポリシーモジュールのデフォルトのルーティングポリシーは、[Aha Webhook の処理] サブフローをトリガーし、Aha! で特定のイベントが発生すると ServiceNow アプリに通知します。デフォルトのルーティングポリシーとサブフローがサポートするフィールドの詳細については、 Aha! スポーク を参照してください。カスタムサブフローで他のフィールドを使用し、ルーティングポリシーの条件をカスタマイズするには、次の手順を実行します。

    手順

    1. 移動先 すべて > Aha! スポーク > Webhook > Webhook ルーティングポリシー。
    2. [New (新規)] を選択します。
    3. フォームに入力します。
      表 : 3. 意思決定フォーム
      フィールド 説明
      ラベル ルーティングポリシーを識別する一意のラベルです。
      デフォルトの回答 この回答がデフォルトの回答かどうかを指定するオプションです。デフォルトの回答は、条件が満たされない場合に適用されます。
      条件 Aha!で必須イベントが発生したときに満たされるべき条件です。
      回答 指定された条件が満たされるとトリガーされるサブフローです。
      1. [ルックアップ] アイコン (ルックアップアイコン) をクリックします。
      2. ドキュメントリストから必要なサブフローを選択します。
        注:
        [テーブル名] がフロー [sys_hub_flow] であることを確認します。
    4. [Submit (送信)] を選択します。