---
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


---

# Web ページへの 仮想エージェント の追加

# ポータブルチャットウィジェットを使用して Web ページに 仮想エージェント を追加する {#ariaid-title1}

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

ポータブルチャットウィジェットは、サードパーティの Web ページ、サービスポータル、または UI ビルダー ポータルで実行できます。
ポータブルチャットウィジェットは、 仮想エージェント チャットをページに簡単に追加できるようにする新しい Seismic コンポーネントです。構成を簡素化し、次の機能を提供します。

* 簡単に構成可能
* 簡素化されたシングルサインオン (SSO) 認証フロー
* サービスポータルに接続 エージェントチャット
* システムパラメーターとコンテキスト変数は以前と同様に機能  
  注:  
  スタンドアロンのページ構成として /$sn-va-web-client-app.do? または /sn_va_web_client_app_embed.do 使用しないでください。代わりに、仮想エージェントチャットウィジェットを正常に埋め込む方法については、[仮想エージェント URL パラメーター](https://servicenow-prod.fluidtopics.net/p9Pk9gCuVsRUkhX4RSKGXA "仮想エージェント には、アドミニストレーターがインスタンス URL に追加してページコンテンツのレンダリング方法を制御できるさまざまなシステムパラメーターが用意されています。")の情報を参照してください。
{#use-portable-va-web-client__ul_pl5_ndk_ktb}

## ポータブル 仮想エージェント チャットウィジェットを使用するための前提条件 {#use-portable-va-web-client__section_q4m_3qp_r5b}

ポータブルチャットウィジェットは、インラインフレーム要素 (iframe) を使用します。サードパーティの Web サイトは、ServiceNow® インスタンスと同じ親ドメインの下にある必要があります。たとえば、 site1.company.com と site2.company.com は同じ親ドメインを共有しています。ServiceNowインスタンスと共有されていないサブドメインにチャットウィジェットを埋め込む場合、URL はカスタムインスタンス URL である必要があります。ブラウザーのセキュリティ強化のため、カスタム URL を使用しないとチャットウィジェットのロードに失敗する場合があります。  
開始する前に、次の操作を行います。

1. [インスタンスでカスタム URL プラグイン (com.snc.customurl) をアクティブ化します。](https://www.servicenow.com/docs/access?context=activate-custom-url-plugin&version=australia&pubname=australia-platform-security&ft:locale=en-US)
2. [カスタム URL (以前に購入して登録したもの) をインスタンスに追加します。](https://www.servicenow.com/docs/access?context=configure-custom-url&version=australia&pubname=australia-platform-security&ft:locale=en-US)
{#use-portable-va-web-client__ol_mtc_4kp_ktb}  
注:  
カスタム URL の使用法の詳細については、「[インスタンスへのカスタム URL の関連付け](https://www.servicenow.com/docs/access?context=custom-url&version=australia&pubname=australia-platform-security&ft:locale=en-US)」を参照してください。

## ポータブル 仮想エージェント チャットウィジェットでの SSO 認証の使用 {#use-portable-va-web-client__section_bbj_tsp_r5b}

仮想エージェントクライアントを埋め込んだ後、オプションでチャットウィジェットから SSO 認証をトリガーできますが、これはインスタンスが外部 SSO プロバイダーを使用するように設定されている場合に限られます。ホスティングサイトでも、インスタンスと同じ SSO プロバイダーを使用する必要があります。SSO プロバイダーの設定の詳細については、「 [外部シングルサインオン (SSO)」](https://www.servicenow.com/docs/access?context=c_MultipleProviderSingleSignOn&version=australia&pubname=australia-platform-security&ft:locale=en-US)を参照してください。

SSO 認証をトリガーするには、認証を実行するための条件を定義し、指定したチャットウィジェットページにユーザーをリダイレクトする JavaScript スクリプトを作成します。また、 com.glide.cs.web_client_login_redirect_urls システムプロパティで URL を識別することで、このスクリプトで渡すことができる許可される URL も指定します。完全なリダイレクト URL または URL のホスト部分 ( <kbd class="ph userinput">https://example.com</kbd> など) を指定します。  
この手順では、次の 2 つのシステムプロパティの値を設定する必要があります。

* com.glide.cs.embed.csp_frame_ancestors
* com.glide.cs.embed.xframe_options (IE 11 のみ)

{#use-portable-va-web-client__ul_awd_xsp_r5b}これらのプロパティは、埋め込みチャットウィジェットのセキュリティポリシー、つまり、Web チャットクライアントを埋め込む前に、ブラウザーが iframe 内で 仮想エージェント チャットと ライブエージェント チャットの HTML コンテンツをレンダリングして保護する方法を決定します。指定する HTTP ヘッダーディレクティブは、クリックジャッキングの試行を軽減するために特定のドメインにページを埋め込むことができるかどうかをブラウザーに指示します。両方のプロパティを設定すると、主要なブラウザーと Internet Explorer などの古いブラウザーのセキュリティディレクティブが確実に存在するようになります。  
注:  
コンテンツ管理システム (CMS) アプリケーションを使用して ServiceNow AI Platform および ServiceNow® アプリケーションのカスタムインターフェイスを作成している場合は、 仮想エージェントをサポートしていないことに注意してください。
* **[ポータブル 仮想エージェント チャットウィジェットの構成](https://servicenow-prod.fluidtopics.net/ArMGlAI6xuDglC1DvtzRcA)**   
  サードパーティの Web ページで仮想エージェントを実行するようにポータブル 仮想エージェント チャットウィジェットを構成します。
* **[ポータブル 仮想エージェント チャットウィジェットをサードパーティ Web サイトに追加する](https://servicenow-prod.fluidtopics.net/J2OedxF6fD0smbqcwNMbPA)**   
  サードパーティの Web ページで 仮想エージェント するためにポータブルチャットウィジェットを使用するには、必要なコードを Web ページに追加します。
* **[外部 Web ページへの 仮想エージェント チャットウィジェットの埋め込み (従来の方法)](https://servicenow-prod.fluidtopics.net/5ZnfEY8pTNPZ~XoUwg~A~g)**   
  インラインフレーム要素 (iframe) を使用して、外部 Web ページに 仮想エージェント チャットウィジェットインターフェイスをロードします。また、オプションで、チャットウィジェットを使用してログインしていないゲストユーザーに対してシングルサインオン (SSO) 認証プロセスを自動的に実行できるようにすることもできます。

**関連タスク**   

* [ポータブル 仮想エージェント チャットウィジェットの構成](https://servicenow-prod.fluidtopics.net/ArMGlAI6xuDglC1DvtzRcA "サードパーティの Web ページで仮想エージェントを実行するようにポータブル 仮想エージェント チャットウィジェットを構成します。")
* [ポータブル 仮想エージェント チャットウィジェットをサードパーティ Web サイトに追加する](https://servicenow-prod.fluidtopics.net/J2OedxF6fD0smbqcwNMbPA "サードパーティの Web ページで 仮想エージェント するためにポータブルチャットウィジェットを使用するには、必要なコードを Web ページに追加します。")