---
sourceDocument: 호주 대화형 인터페이스
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/conversational-interfaces

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 대화형 인터페이스

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# 웹 페이지에 추가 가상 에이전트

# 휴대용 채팅 위젯을 사용하여 웹 페이지에 추가 가상 에이전트 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 3분

휴대용 채팅 위젯은 외부 공급업체 웹 페이지, 서비스 포털 또는 UI 빌더 포털에서 실행할 수 있습니다.
휴대용 채팅 위젯은 페이지에 채팅을 쉽게 추가할 가상 에이전트 수 있는 새로운 Seismic 구성요소입니다. 구성을 단순화하고 다음과 같은 기능을 제공합니다.

* 쉽게 구성 가능
* 더 간단한 1회 사용자 인증(SSO) 인증 플로우
* 서비스 포털에 연결 에이전트 채팅
* 시스템 매개변수와 컨텍스트 변수가 이전과 동일하게 작동합니다.  
  주:  
  또는 /sn_va_web_client_app_embed.do 독립 실행형 페이지 구성으로 사용하지 /$sn-va-web-client-app.do? 마십시오. 대신 채팅 위젯을 성공적으로 포함하는 가상 에이전트 방법에 대한 정보를 [가상 에이전트 URL 매개변수](https://servicenow-prod.fluidtopics.net/LVF1wTmxN4u8RSkzLIfW~w "가상 에이전트 는 관리자가 인스턴스 URL에 추가하여 페이지 콘텐츠가 렌더링되는 방법을 제어할 수 있는 다양한 시스템 매개변수를 제공합니다.") 참조하십시오.
{#use-portable-va-web-client__ul_pl5_ndk_ktb}

## 휴대용 가상 에이전트 채팅 위젯을 사용하기 위한 필수 구성요소 {#use-portable-va-web-client__section_q4m_3qp_r5b}

휴대용 채팅 위젯은 인라인 프레임 요소(iframe)를 사용합니다. 외부 공급업체 웹 사이트는 인스턴스 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}  
주:  
Custom URL 사용에 대한 자세한 내용은 [Custom 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 제공자 설정에 대한 자세한 내용은 [외부 1회 사용자 인증(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의 호스트 부분( <kbd class="ph userinput">예: https://example.com</kbd>)을 지정합니다.  
이 절차를 수행하려면 다음 두 시스템 속성에 대한 값을 설정해야 합니다.

* com.glide.cs.embed.csp_frame_ancestors
* com.glide.cs.embed.xframe_options (IE 11만 해당)

{#use-portable-va-web-client__ul_awd_xsp_r5b}이러한 속성은 포함된 채팅 위젯의 보안 정책, 즉 웹 채팅 클라이언트를 포함하기 전에 브라우저가 iframe에서 가상 에이전트라이브 에이전트 HTML 콘텐츠를 렌더링하고 채팅을 보호하는 방법을 결정합니다. 사용자가 지정하는 HTTP 헤더 지시문은 클릭재킹 시도를 완화하기 위해 특정 도메인에 페이지를 포함할 수 있는지 여부를 브라우저에 알려줍니다. 두 속성을 모두 설정하면 주요 브라우저와 Internet Explorer와 같은 이전 브라우저에 대한 보안 지침이 있습니다.  
주:  
CMS(Content Management System) 애플리케이션을 사용하여 애플리케이션 ServiceNow® 에 대한 ServiceNow AI Platform 사용자 지정 인터페이스를 만드는 경우 이 애플리케이션은 을 지원가상 에이전트하지 않습니다.
* **[휴대용 가상 에이전트 채팅 위젯 구성](https://servicenow-prod.fluidtopics.net/RmUgkfWpoY4GB6qXiav1Qw)**   
  외부 공급업체 웹 페이지에서 실행되도록 가상 에이전트 휴대용 가상 에이전트 채팅 위젯을 구성합니다.
* **[외부 공급업체 웹 사이트에 휴대용 가상 에이전트 채팅 위젯 추가](https://servicenow-prod.fluidtopics.net/lEYaJKbUxxKil_BZX9xwWQ)**   
  외부 공급업체 웹 페이지에서 휴대용 채팅 위젯 가상 에이전트 을 사용하려면 웹 페이지에 필요한 코드를 추가하십시오.
* **[외부 웹 페이지에 채팅 위젯 포함 가상 에이전트 (레거시 방법)](https://servicenow-prod.fluidtopics.net/awdOrt1HrtpKskLwdhecbA)**   
  인라인 프레임 요소(iframe)를 사용하여 외부 웹 페이지에 채팅 위젯 인터페이스를 로드 가상 에이전트 합니다. 채팅 위젯을 사용하고 로그인하지 않은 게스트 사용자에 대해 1회 사용자 인증(SSO) 인증 프로세스가 자동으로 실행되도록 선택적으로 활성화할 수도 있습니다.

**관련 태스크**   

* [휴대용 가상 에이전트 채팅 위젯 구성](https://servicenow-prod.fluidtopics.net/RmUgkfWpoY4GB6qXiav1Qw "외부 공급업체 웹 페이지에서 실행되도록 가상 에이전트 휴대용 가상 에이전트 채팅 위젯을 구성합니다.")
* [외부 공급업체 웹 사이트에 휴대용 가상 에이전트 채팅 위젯 추가](https://servicenow-prod.fluidtopics.net/lEYaJKbUxxKil_BZX9xwWQ "외부 공급업체 웹 페이지에서 휴대용 채팅 위젯 가상 에이전트 을 사용하려면 웹 페이지에 필요한 코드를 추가하십시오.")