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

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:3分
  • ポータブルチャットウィジェットは、サードパーティの Web ページ、サービスポータル、または UI ビルダー ポータルで実行できます。

    ポータブルチャットウィジェットは、 仮想エージェント チャットをページに簡単に追加できるようにする新しい Seismic コンポーネントです。構成を簡素化し、次の機能を提供します。
    • 簡単に構成可能
    • 簡素化されたシングルサインオン (SSO) 認証フロー
    • サービスポータルに接続 エージェントチャット
    • システムパラメーターとコンテキスト変数は以前と同様に機能
      注:
      スタンドアロンのページ構成として /$sn-va-web-client-app.do? または /sn_va_web_client_app_embed.do 使用しないでください。代わりに、仮想エージェントチャットウィジェットを正常に埋め込む方法については、仮想エージェント URL パラメーターの情報を参照してください。

    ポータブル 仮想エージェント チャットウィジェットを使用するための前提条件

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

    注:
    カスタム URL の使用法の詳細については、「インスタンスへのカスタム URL の関連付け」を参照してください。

    ポータブル 仮想エージェント チャットウィジェットでの SSO 認証の使用

    仮想エージェントクライアントを埋め込んだ後、オプションでチャットウィジェットから SSO 認証をトリガーできますが、これはインスタンスが外部 SSO プロバイダーを使用するように設定されている場合に限られます。ホスティングサイトでも、インスタンスと同じ SSO プロバイダーを使用する必要があります。SSO プロバイダーの設定の詳細については、「 外部シングルサインオン (SSO)」を参照してください。

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

    この手順では、次の 2 つのシステムプロパティの値を設定する必要があります。
    • com.glide.cs.embed.csp_frame_ancestors
    • com.glide.cs.embed.xframe_options (IE 11 のみ)
    これらのプロパティは、埋め込みチャットウィジェットのセキュリティポリシー、つまり、Web チャットクライアントを埋め込む前に、ブラウザーが iframe 内で 仮想エージェント チャットと ライブエージェント チャットの HTML コンテンツをレンダリングして保護する方法を決定します。指定する HTTP ヘッダーディレクティブは、クリックジャッキングの試行を軽減するために特定のドメインにページを埋め込むことができるかどうかをブラウザーに指示します。両方のプロパティを設定すると、主要なブラウザーと Internet Explorer などの古いブラウザーのセキュリティディレクティブが確実に存在するようになります。
    注:
    コンテンツ管理システム (CMS) アプリケーションを使用して ServiceNow AI Platform および ServiceNow® アプリケーションのカスタムインターフェイスを作成している場合は、 仮想エージェントをサポートしていないことに注意してください。