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

  • リリースバージョン: Yokohama
  • 更新日 2025年06月12日
  • 所要時間：5分

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

    始める前に

    必要なロール：アドミン

    手順

    1. ServiceNow インスタンスから Webhook コールバック URL を生成します。
      1. アドミニストレーターとして ServiceNow インスタンスにログインします。
      2. 移動先 Aha! スポーク > Webhook > Webhook レジストリー.
      3. レコード [Aha Webhook] を開きます。
      4. [コールバック URL] をクリックします。
        Webhook コールバック URL が生成され、表示されます。
        Webhook コールバック URL。
      5. Webhook コールバック URL をコピーして記録します。
    2. ServiceNow インスタンスで Webhook ルーティングポリシーを指定します。
      1. アドミニストレーターとして ServiceNow インスタンスにログインします。
      2. 移動先 Aha! スポーク > Webhook > Webhook ルーティングポリシー.
      3. Aha! Webhook ルーティングポリシーレコードを開きます。
      4. 満たす必要がある [条件] を指定します。
      5. [答え (Answer)] に対して、指定された条件が満たされたときにトリガーされる必要がある必須のサブフローを選択します。
        デフォルトのルーティングポリシーレコードでは、 [Process Aha] Webhook サブフローが [答え (Answer)] として選択されています。
      6. [更新] をクリックします。
    3. Webhook コールバック URL を Aha! アカウントで登録します。
      1. アドミニストレーターとして Aha! アカウントにログインします。
      2. 移動先 設定 > アカウント.
      3. [データ連携] の横にある [+] をクリックして、アクティビティ Webhook を作成します。
      4. [アクティビティ Webhook (Activity webhook)] タイルで [+ アクティビティ Webhook (+ Activity webhook)] をクリックします。
      5. フォームに、これらの値を入力します。
        フィールド 説明
        フック URL ServiceNow インスタンスからコピーした Webhook コールバック URL。
        選択されたアクティビティ 登録するアクティビティまたはイベント。
      6. [アクティビティを追加] をクリックします。

    トークンを作成

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

    始める前に

    必要なロール：アドミン

    手順

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

    ServiceNow での Aha!Webhook の作成

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

    始める前に

    必要なロール：アドミン

    手順

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

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

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

    始める前に

    必要なロール：アドミン

    手順

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

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

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

    始める前に

    必要なロール：アドミン

    このタスクについて

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

    手順

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