---
sourceDocument: Yokohama 対話型インターフェース
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama 対話型インターフェース

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# ポータブル 仮想エージェント チャットウィジェットの構成

# ポータブル 仮想エージェント チャットウィジェットの構成 {#ariaid-title1}

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

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

* 簡単に構成可能
* 簡素化されたシングルサインオン (SSO) 認証フロー
* サービスポータル エージェントチャット への接続
* システムパラメーターとコンテキスト変数は以前と同様に機能
{#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=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)
2. [カスタム URL (以前に購入して登録したもの) をインスタンスに追加します。](https://www.servicenow.com/docs/access?context=configure-custom-url&version=yokohama&pubname=yokohama-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=yokohama&pubname=yokohama-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=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)」を参照してください。

SSO 認証をトリガーするには、認証を実行するための条件を定義し、指定したチャットウィジェットページにユーザーをリダイレクトする JavaScript スクリプトを作成します。com.glide.cs.web_client_login_redirect_urls システムプロパティでそれらを識別することによって、このスクリプトで渡すことができる許可された 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 などの古いブラウザのセキュリティディレクティブが確実に存在するようになります。  
注:  
Content Management System (CMS) アプリケーションを使用して Now Platform および ServiceNow® アプリケーションのカスタムインターフェイスを作成している場合は、仮想エージェントをサポートしていないことに注意してください。
* **[ポータブル 仮想エージェント チャットウィジェットの構成](https://servicenow-prod.fluidtopics.net/M5aqWiEU_lV1dvGHy6udsQ)**   
  サードパーティの Web ページで仮想エージェントを実行するようにポータブル仮想エージェントチャットウィジェットを設定します。
* **[サードパーティ Web サイトへのポータブル 仮想エージェント チャットウィジェットの追加](https://servicenow-prod.fluidtopics.net/ffCTY7byzw~GtzaLU4jMAw)**   
  サードパーティの Web ページで 仮想エージェント するためにポータブルチャットウィジェットを使用するには、必要なコードを Web ページに追加します。
* **[外部 Web ページへの 仮想エージェント チャットウィジェットの埋め込み (従来の方法)](https://servicenow-prod.fluidtopics.net/cQffldIoyBrZ7U0~pPfiqQ)**   
  インラインフレーム要素 (iframe) を使用して、外部 Web ページに 仮想エージェント チャットウィジェットインターフェイスをロードします。また、オプションで、チャットウィジェットを使用してログインしていないゲストユーザーに対してシングルサインオン (SSO) 認証プロセスを自動的に実行できるようにすることもできます。

**関連タスク**   

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