---
sourceDocument: Yokohama データと自動化
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/integrate-applications

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama データと自動化

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

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

# Aha! スポーク用の双方向 Webhook の設定 {#ariaid-title1}

* リリースバージョン: Yokohama
* 
* 更新日 2025年06月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：5分

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

## 始める前に

必要なロール：アドミン

## 手順

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

      | フィールド | 説明 |
      |-|-|
      | フック URL | ServiceNow インスタンスからコピーした Webhook コールバック URL。 |
      | 選択されたアクティビティ | 登録するアクティビティまたはイベント。 |
      [ ]

      {#setup-aha-webhook__table_pwg_ffn_q5b}
   6. \[アクティビティを追加\] をクリックします。
   {#setup-aha-webhook__substeps_ok1_t2n_q5b}

## トークンを作成 {#ariaid-title2}

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

### 始める前に

必要なロール：アドミン

### 手順

1. ナビゲーションフィルターで、「 <kbd class="ph userinput">token_verification.list</kbd>」と入力します。  
   トークン検証テーブルにレコードが表示されます。
2. \[新規\] を選択します。
3. フォームの各フィールドに入力します。  
   {#create-a-token-for-aha-spoke__table_uzr_l41_1jb__entry__2}

   | フィールド | 説明 |
   |-|-|
   | 名前 | トークンを識別する一意の名前を指定するオプション。たとえば、 <kbd class="ph userinput">Aha! コールバック URL トークン</kbd>。 |
   | 説明 | トークンの説明を入力するオプション。 |
   | トークン | 一意の認証トークンを指定するオプション。このトークンは暗号化され、URL に埋め込まれます。 |
   [表 : 1. トークン検証フォーム]

   {#create-a-token-for-aha-spoke__table_uzr_l41_1jb}
4. \[送信\] を選択します。
{#create-a-token-for-aha-spoke__steps_g2z_12y_52c}

## ServiceNow での Aha!Webhook の作成 {#ariaid-title3}

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

### 始める前に

必要なロール：アドミン

### 手順

1. 移動先 すべてAha! スポークWebhookWebhook レジストリ。
2. \[新規\] を選択します。
3. フォームに入力します。  
   {#create-an-aha-webhook-in-servicenow__table_rcq_kgy_52c__entry__2}

   | フィールド | 説明 |
   |-|-|
   | 名前 | レコードを一意に識別するオプション。 |
   | パス | Webhook パスを指定するオプション。<kbd class="ph userinput">api/sn_aha_spoke/aha_webhook</kbd>と入力します。 |
   | トークン | 作成したトークンを指定するオプション。「[トークンを作成](https://servicenow-prod.fluidtopics.net/jFAO8LFqcR4OZOHrOgCsEg#create-a-token-for-aha-spoke "Aha!するコールバック URL に埋め込まれるトークンを作成します。")」を参照してください。 |
   [表 : 2. Aha! Webhook レジストリー]

   {#create-an-aha-webhook-in-servicenow__table_rcq_kgy_52c}
4. フォームヘッダーを右クリックし、\[保存\] をクリックします。
5. \[コールバック URL\] を選択します。  
   Webhook コールバック URL が表示されます。
6. Webhook コールバック URL をコピーして記録します。
{#create-an-aha-webhook-in-servicenow__steps_crj_hfy_52c}

## Aha!へのコールバック URL の追加 {#ariaid-title4}

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

### 始める前に

必要なロール：アドミン

### 手順

1. アドミニストレーターとして Aha! アカウントにログインします。
2. 移動先 設定アカウント.
3. \[データ連携\] の横にある \[+\] をクリックして、アクティビティ Webhook を作成します。
4. \[アクティビティ Webhook (Activity webhook)\] タイルで \[+ アクティビティ Webhook (+ Activity webhook)\] をクリックします。
5. フォームに、これらの値を入力します。  
   {#add-callback-url-to-aha__table_pwg_ffn_q5b__entry__2}

   | フィールド | 説明 |
   |-|-|
   | フック URL | ServiceNow インスタンスからコピーした Webhook コールバック URL。 |
   | 選択されたアクティビティ | 登録するアクティビティまたはイベント。 |
   [ ]

   {#add-callback-url-to-aha__table_pwg_ffn_q5b}
6. \[アクティビティを追加\] をクリックします。

## Webhook ルーティングポリシーの設定 {#ariaid-title5}

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

### 始める前に

必要なロール：アドミン

### このタスクについて

Aha Webhook 意思決定ポリシーモジュールのデフォルトのルーティングポリシーは、\[Process Aha Webhooks\] サブフローをトリガーし、Aha!で特定のイベントが発生すると ServiceNow アプリに通知します。デフォルトのルーティングポリシーとサブフローがサポートするフィールドの詳細については、「 [Aha! スポーク](https://servicenow-prod.fluidtopics.net/23YJo48UT2ksbuYvxf9~sA "ServiceNow インスタンスを使用して Aha! アカウントを管理します。Aha! のデータ使用状況を分析し、アイドル状態のアカウントを再利用します。") 」を参照してください。カスタムサブフローで他のフィールドを使用し、ルーティングポリシーの条件をカスタマイズするには、次の手順を実行します。

### 手順

1. 移動先 すべてAha! スポークWebhookWebhook ルーティングポリシー。
2. \[新規\] を選択します。
3. フォームに入力します。  
   {#set-webhook-routing-policy__table_awj_xgv_z3b__entry__2}

   | フィールド | 説明 |
   |-|-|
   | ラベル | ルーティングポリシーを識別する一意のラベルです。 |
   | デフォルトの回答 | この回答がデフォルトの回答かどうかを指定するオプションです。デフォルトの回答は、条件が満たされない場合に適用されます。 |
   | 条件 | Aha!で必須イベントが発生したときに満たされるべき条件です。 |
   | 回答 | 指定された条件が満たされるとトリガーされるサブフローです。 1. \[ルックアップ\] アイコン (![ルックアップアイコン]()) をクリックします。 2. \[ ドキュメント\] リストから必要なサブフローを選択します。 注: \[テーブル名\] が<kbd class="ph userinput">フロー [sys_hub_flow]</kbd> であることを確認します。 {#set-webhook-routing-policy__ol_sdf_ftb_1jb} |
   [表 : 3. 意思決定フォーム]

   {#set-webhook-routing-policy__table_awj_xgv_z3b}
4. \[送信\] を選択します。