---
sourceDocument: オーストラリアの対話型インターフェース
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/conversational-interfaces

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリアの対話型インターフェース

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# WhatsApp (WhatsApp Cloud API) の対話型統合 の設定

# WhatsApp (WhatsApp Cloud API) の対話型統合 の設定 {#ariaid-title1}

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

要求者をボットとの会話に参加させることができるように、 WhatsApp (WhatsApp Cloud API) の対話型統合 アプリケーションを設定します。ServiceNow仮想エージェント と統合すると、仮想エージェントまたはライブエージェントとチャットWhatsAppやり取りできます。

## 始める前に

開始する前に、次の操作を行います。

* 次の製品およびアプリケーションの ServiceNow エンタイトルメントを取得します。
  * 統合ハブ
  * WhatsApp (WhatsApp Cloud API) の対話型統合

  {#messg-direct-whatsapp-setup__ul_uh3_fyy_2mb}

  詳細については、次を参照してください。 [のエンタイトルメントを取得する ServiceNow 製品またはアプリケーション](https://store.servicenow.com/$appstore.do#!/store/help?article=KB0030186).
* ServiceNowインスタンスで次のアプリケーションを設定します。
  * 統合ハブ
  * WhatsApp (WhatsApp Cloud API) の対話型統合
  {#messg-direct-whatsapp-setup__ul_vh3_fyy_2mb}
{#messg-direct-whatsapp-setup__ul_qlh_4xb_cnb}

必要なロール:external_app_install_admin または va_admin

## 手順

1. メタ開発者アカウントと Facebook ビジネスアカウントでの設定が必要です。
   1. [WhatsApp Cloud API 入門](https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started)ガイドの前提条件とステップ 1 を完了して、Meta 開発者アプリを作成します。
   2. アプリシークレットをコピー:  
      * メタアプリケーションダッシュボードで、 アプリの設定基本.
      * アプリシークレットをメモします。後でこのトークンを使用して、ServiceNow インスタンスで WhatsApp アカウントを認証します。

      {#messg-direct-whatsapp-setup__ul_unv_gxc_yhc}
   3. 電話番号 ID をコピー:  
      * 移動先 WhatsAppAPI セットアップ.
      * \[メッセージの送受信\] セクションで、\[ 差出人\] ドロップダウン リストから WhatsApp 対応の電話番号を選択します。

        この ID は、 ServiceNow インスタンスでプロバイダーレコードを構成するために必要です。
      {#messg-direct-whatsapp-setup__ul_bnr_kxc_yhc}
   4. Meta Business Manager でシステムユーザーアクセストークンを作成します。

   {#messg-direct-whatsapp-setup__substeps_p52_1xc_yhc}  
   システム・ユーザー・アクセス・トークンの作成方法の詳細については、「 [システム・ユーザー・アクセス・トークンの生成](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens#generating-system-user-access-tokens)」を参照してください。アクセストークンの作成時に必要な権限を付与し、アクセストークンをコピーします。

   このトークンは、 ServiceNow インスタンスでトークン検証レコードを構成するために必要です。
2. ServiceNowインスタンスのWhatsAppからメッセージを受信するには、Webhook URL を確認して設定します。
   1. ナビゲーションフィルターで、「<kbd class="ph userinput">sys_properties.list</kbd>」と入力します。
   2. sn_va_whatsapp.webhook_verify_tokenプロパティを見つけて開きます。
   3. \[値\] フィールドに、選択したパスワードまたはシークレットを入力します。
   4. \[Save (保存)\] を選択します。
   5. Meta 開発者コンソールで、次の場所に移動します。 WhatsApp構成WhatsApp 構成.
   6. \[Webhook\] セクションの \[コールバック URL\] フィールドに、 <kbd class="ph userinput">https://&lt;instance-name&gt;.service-now.com/api/sn_va_whatsapp/va_whatsapp_adapter</kbd> の形式で URL を入力します。
   7. \[トークンを検証\] フィールドに、ステップ (c) で ServiceNow インスタンスで設定したパスワードを入力します。
   8. \[ 確認して保存\] を選択します。
   9. \[Webhook フィールド\] セクションで、\[ 登録 \] 切り替えスイッチを有効にしてメッセージを登録します。
   {#messg-direct-whatsapp-setup__substeps_oqf_4yc_yhc}
3. WhatsApp アカウントからの着信ハッシュメッセージを認証するには、認証トークンを格納するハッシュメッセージ検証レコードを作成します。
   1. ServiceNow インスタンスのナビゲーションフィルターで、「<kbd class="ph userinput">hash_message_verification.list</kbd>」と入力します。
   2. \[ハッシュメッセージの検証\] リストで、\[ 新規\] を選択します。
   3. フォームで、フィールドに入力します。  
      {#messg-direct-whatsapp-setup__table_rw5_syy_2mb__entry__2}

      | フィールド | 説明 |
      |-|-|
      | 名前 | 会社の WhatsApp 勤務先電話番号に関連付けられている認証トークンを格納するハッシュメッセージ検証 \[hash_message_verification\] テーブル内のレコードの名前。例: <kbd class="ph userinput">WhatsappTestAppInboundToken</kbd>。 |
      | 説明 | レコードの説明です。たとえば、「 <kbd class="ph userinput">WhatsApp テストアプリケーション認証トークン</kbd>」などです。 |
      | シークレット | Meta 開発者コンソールで設定されたアプリケーションのアプリシークレット。 |
      [表 : 1. \[ハッシュメッセージの検証\] フォーム]

      {#messg-direct-whatsapp-setup__table_rw5_syy_2mb}
   4. ハッシュメッセージ検証レコードの名前をメモしておきます。
   5. \[Submit (送信)\] を選択します。
   {#messg-direct-whatsapp-setup__substeps_tbd_ryy_2mb} {#messg-direct-whatsapp-setup__wa-hash}
{#messg-direct-whatsapp-setup__wa-hash}
4. 必要な認証ヘッダーを含むメッセージを WhatsApp アカウントに送信するには、システムユーザーアクセストークンを格納するトークン検証レコードを作成します。
   1. ServiceNow インスタンスのナビゲーションフィルターで、「<kbd class="ph userinput">token_verification.list</kbd>」と入力します。
   2. \[トークン検証\] リストで、\[ 新規\] を選択します。
   3. フォームで、フィールドに入力します。  
      {#messg-direct-whatsapp-setup__table_ldg_vyc_yhc__entry__2}

      | フィールド | 説明 |
      |-|-|
      | 名前 | 会社のメタビジネスアカウントに関連付けられているシステムユーザーアクセストークンを格納するトークン検証 \[token_verification\] テーブル内のレコードの名前。例: <kbd class="ph userinput">WhatsappTestAppOutboundToken</kbd>。 |
      | 説明 | レコードの説明です。たとえば、「WhatsApp Business Testing アプリケーション送信トークン」などです。 |
      | トークン | Meta Business Manager で作成されたシステムユーザーアクセストークン |
      [表 : 2. トークン検証フォーム]

      {#messg-direct-whatsapp-setup__table_ldg_vyc_yhc}
   4. トークン検証レコードの名前をメモしておきます。
   5. \[Submit (送信)\] を選択します。
   {#messg-direct-whatsapp-setup__substeps_kdg_vyc_yhc}
5. 送信メッセージレコードをメッセージ認証レコードに関連付けます。
   1. ServiceNowインスタンスのナビゲーションフィルターで、「<kbd class="ph userinput">message_auth.list</kbd>」と入力し、\[新規\] を選択します。
   2. フォームで、フィールドに入力します。  
      {#messg-direct-whatsapp-setup__table_nb4_vvr_cmb__entry__2}

      | フィールド | 説明 |
      |-|-|
      | 名前 | メッセージ認証 \[message auth\] テーブル内のレコードの名前。例: <kbd class="ph userinput">VA WhatsApp Test App Message Auth</kbd>。 |
      | プロバイダー | 認証トークンのプロバイダー。<kbd class="ph userinput">WhatsApp</kbd>を入力します。 |
      | グループ名 | 作成したグループの名前。 |
      | サービスポータル | 作成したカスタマーサービスポータル。 |
      | 送信サービスのトークン | 外部サービスまたは API へのアクセスを認証および承認するために ServiceNow AI Platform が使用する一意のトークン。トークンは、 ServiceNow AI Platform が他のシステムと安全にやり取りできるようにする認証情報です。このトークンは外部サービスによって生成され、プラットフォームが要求を行い、リソースにアクセスできるように ServiceNow AI Platform に提供されます。 |
      | 着信メッセージの検証 | 受信ハッシュメッセージ用に作成したハッシュメッセージ検証レコードの名前。 |
      | 送信メッセージの検証 | 受信ハッシュメッセージ用に作成した トークン メッセージ検証レコードの名前。 注: \[ 着信メッセージの検証 \] フィールドと \[ 着信メッセージの検証 \] フィールドの値は同じです。 |
      [表 : 3. メッセージ認証フォーム]

      {#messg-direct-whatsapp-setup__table_nb4_vvr_cmb}
   3. \[Submit (送信)\] を選択します。
   {#messg-direct-whatsapp-setup__substeps_dkx_yyy_2mb} {#messg-direct-whatsapp-setup__wa-auth-record}
{#messg-direct-whatsapp-setup__wa-auth-record}
6. メッセージ認証レコードを WhatsApp 対応の電話番号に関連付けます。
   1. ServiceNow インスタンスのナビゲーションフィルターで、「<kbd class="ph userinput">sys_cs_provider.list</kbd>」と入力します。
   2. \[プロバイダーチャネル\] リストで、WhatsAppチャネルに対応する \[名前\] 列から \[VA Whatsapp アダプタプロバイダー\] を選択します。  
      WhatsAppエントリが存在しない場合は、ナビゲーションフィルターに「<kbd class="ph userinput">sys_cs_provider_application.list</kbd>」と入力してリストを作成します。
   3. \[プロバイダーチャネル ID\] 関連リストで、\[ 新規\] を選択します。
   4. フォームで、フィールドに入力します。  
      {#messg-direct-whatsapp-setup__table_f34_25r_cmb__entry__2}

      | フィールド | 説明 |
      |-|-|
      | 名前 | ユーザーが連絡するエンティティの名前 (IT サービスデスクなど)。 |
      | 受信 ID | WhatsApp 対応の電話番号に対応する電話番号 ID。 |
      | メッセージ認証 | 作成したメッセージ認証。 |
      [表 : 4. \[プロバイダーチャネル ID\] フォーム]

      {#messg-direct-whatsapp-setup__table_f34_25r_cmb}
   5. \[Submit (送信)\] を選択します。
   {#messg-direct-whatsapp-setup__substeps_ads_mzy_2mb}
7. プロバイダーチャネル ID プロパティを設定します。
   1. 作成したプロバイダーチャネル ID を選択します。
   2. \[プロバイダーチャネル ID プロパティ\] セクションで \[ 新規\] を選択します。
   3. フォームで、フィールドに入力します。  
      {#messg-direct-whatsapp-setup__table_azm_k4d_yhc__entry__2}

      | フィールド | 説明 |
      |-|-|
      | 名前 | ユーザーが連絡するエンティティの名前。display_phone_numberを入力します。 |
      | 値 | 作成した電話番号 ID に対応する実際の電話番号を入力します。 |
      | 説明 | プロバイダーチャネルの説明を追加します。 |
      [表 : 5. \[プロバイダーチャネル ID\] フォーム]

      {#messg-direct-whatsapp-setup__table_azm_k4d_yhc}
   4. \[Submit (送信)\] を選択します。
   {#messg-direct-whatsapp-setup__substeps_zym_k4d_yhc}
8. 送信したメディアコンテンツをサーバーでダウンロードできるようにします。
   1. ServiceNow インスタンスのナビゲーションフィルターで、「<kbd class="ph userinput">sys_cs_provider.list</kbd>」と入力します。
   2. \[プロバイダーチャネル\] リストで、WhatsAppチャネルに対応する \[名前\] 列から \[VA Whatsapp アダプタプロバイダー\] を選択します。
   3. \[信頼できるメディアドメイン\] フィールドに <kbd class="ph userinput">lookaside.fbsbx.com</kbd> を入力します。
   4. \[Update (更新)\] を選択します。
   {#messg-direct-whatsapp-setup__substeps_bwc_w4d_yhc}
{#messg-direct-whatsapp-setup__steps_i1d_hyy_2mb}