포털에서 구성 에이전트 채팅

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 9분

    • 최종 사용자는 모든 포털 페이지에서 대화를 에이전트 채팅 시작하고 유지할 수 있습니다. 포털별 데이터를 전달하는 스크립트를 작성합니다.에이전트 채팅 예를 들어, 지식베이스의 이름을 대화에 가상 에이전트 전달합니다.

    시작하기 전에

    필요한 역할: 관리자
    • Glide 가상 에이전트 (com.glide.cs.chatbot) 또는 (com.glide.interaction.awa) 플러그인을 활성화합니다 에이전트 채팅 . Glide 가상 에이전트 플러그인을 사용하려면 구독이 필요합니다.
      주:
      포털에서의 사용 Now Assist가상 에이전트 에 대한 자세한 내용은 다음 문서를 참조하십시오 Configuring assistants overview.

    프로시저

    1. 다음으로 이동 모두 > 서비스 포털 > 에이전트 채팅.
      서비스 포털 에이전트 채팅 구성 [sp_agent_chat_config] 테이블이 열립니다.
    2. 새로 만들기를 선택합니다.
    3. 양식을 작성합니다.
      필드 설명
      활성 구성이 활성 상태인지 여부입니다.
      이름 구성 기록의 고유한 이름입니다.
      포털 지정된 채팅 구성에 사용할 포털입니다. 포털을 선택하지 않으면 구성이 시스템의 모든 포털에 적용됩니다.
      애플리케이션 기록에 대한 읽기 전용 애플리케이션 범위입니다.
      공개

      사용자가 로그인하기 전에 사용할 수 있는지 여부 에이전트 채팅 입니다.
      역할

      사용자가 사용해야 에이전트 채팅하는 역할입니다. 역할을 선택하지 않으면 모든 에이전트 채팅 사용자가 사용할 수 있습니다.
      순서 구성이 실행되어야 하는 순서를 나타내는 번호입니다. 포털당 하나의 구성만 적용됩니다. 포털에 여러 구성이 있는 경우 시스템은 가장 낮은 구성에서 가장 높은 구성으로 발견된 첫 번째 구성을 실행합니다.
      서버 스크립트

      페이지 및 위젯 데이터를 대화로 전달하는 스크립트입니다 에이전트 채팅 . 예를 들어, 값에 액세스할 수 있도록 에이전트 채팅 필드를 전달합니다. 이 스크립트에 전달된 데이터는 포털의 모든 페이지에서 사용할 수 있습니다. 이 스크립트는 GlideSPScriptable API에 접근할 수 있습니다.

      주:
      포털 접미사, 페이지 ID 및 언어는 자동으로 사용할 수 에이전트 채팅 있으며 사용자 지정 스크립트가 필요하지 않습니다. 시스템 ID 및 테이블은 URL에 있을 때 자동으로 사용할 수 에이전트 채팅 있습니다.

      이 예시에서는 포털과 연결된 카탈로그 목록이 포함된 객체를 반환합니다.

      (function ($sp) {    
   return {        
      catalogs: $sp.getValue(‘catalogs’) 
   };
})($sp);

      iframe HTML 요소에서 열리면 에이전트 채팅 카탈로그 목록이 iframe URL에 포함됩니다. 이 필드의 매개변수는 전달된 충돌 페이지 데이터를 재정의합니다.에이전트 채팅
    4. 제출을 선택합니다.

    결과

    사용자는 선택한 포털의 모든 페이지에서 대화를 에이전트 채팅 시작하고 유지할 수 있습니다.

    버튼 사용자 지정 에이전트 채팅

    포털의 버튼에 에이전트 채팅 사용되는 색상과 이미지를 변경할 수 있습니다.

    시작하기 전에

    버튼에 사용되는 에이전트 채팅 이미지 중 하나 또는 모두를 교체하려면 이미지를 인스턴스에 업로드합니다. 이미지 업로드에 대한 자세한 정보는 데이터베이스에 이미지 저장을 참조하십시오.

    필요한 역할: sp_admin 또는 admin

    이 태스크 정보

    버튼의 다음 요소를 구성할 수 있습니다.에이전트 채팅
    • 채팅 창이 열려 있음을 나타내는 이미지
    • 채팅 창이 닫혔음을 나타내는 이미지
    • 버튼 배경색

    이러한 요소는 포털 테마에서 결정됩니다. 버튼을 사용자 지정 에이전트 채팅 하려면 포털 테마 기록에서 관련 SCSS 변수를 업데이트합니다. 자세한 내용은 봇의 브랜딩 설정을 참조하세요.

    주:
    시스템 속성 [sys_property] 테이블 값이 com.glide.cs.advanced-chat-popover예로 설정된 상태에서 웹 클라이언트 가상 에이전트 버튼 아이콘을 변경하는 경우 웹 클라이언트 가상 에이전트 채팅 버튼을 원래 버튼 아이콘과 동일한 크기로 설정합니다. 그렇지 않으면 아이콘이 커서 표시됩니다.

    프로시저

    1. 다음으로 이동 모두 > 서비스 포털 > 테마.
    2. 테마 기록을 엽니다.
    3. CSS 변수 필드에 다음 변수를 추가합니다.
      변수 설명
      $sp-agent-chat-btn-close 채팅 창이 닫혔음을 나타내는 이미지입니다. 다음을 포함하는 이미지 URL을 사용하십시오.
      • 인스턴스 주소
      • 참조할 이미지 [db_image] 기록의 이름
      예를 들어 데이터베이스에서 tack-icon.png 이미지를 참조하려면 다음을 입력합니다.
      $sp-agent-chat-btn-close: url("https://<instance-name>.service-now.com/tack-icon.png");

      이미지 URL은 버튼의 tack-icon.png 참조합니다.에이전트 채팅

      기본 이미지를 사용하려면 변수를 제거하십시오.
      $sp-agent-chat-btn-open 채팅 창이 열려 있음을 나타내는 이미지입니다. 다음을 포함하는 이미지 URL을 사용하십시오.
      • 인스턴스 주소
      • 참조할 이미지 [db_image] 기록의 이름
      예를 들어 데이터베이스에서 book-icon.png 이미지를 참조하려면 다음을 입력합니다.
      $sp-agent-chat-btn-open: url("https://<instance-name>.service-now.com/book-icon.png");
      이미지 URL은 버튼의 book-icon.png 참조합니다.에이전트 채팅
      기본 이미지를 사용하려면 변수를 제거하십시오.
      $sp-agent-chat-bg 단추 배경색입니다. 16진수 코드를 사용하여 색상을 설정합니다. 예를 들어 빨간색을 사용하려면 다음을 입력합니다.
      $sp-agent-chat-bg: #ff0000;
      빨간색 배경색
      기본 배경색을 사용하려면 변수를 제거합니다.
    4. 업데이트를 클릭합니다.

    위젯에서 가상 에이전트 서비스 포털 마이그레이션

    이전 릴리스에서 업그레이드하는 경우 포털 구현에 위젯이 가상 에이전트 서비스 포털 포함될 수 있습니다. 위젯 옵션을 구성 내 서비스 포털 항목 에이전트 채팅 으로 마이그레이션하고 위젯의 모든 인스턴스를 제거하여 사용자가 모든 포털 페이지에서 대화를 에이전트 채팅 시작하고 유지할 수 있도록 합니다.

    시작하기 전에

    필요한 역할: (admin 또는 없음)

    프로시저

    1. 인스턴스 옵션을 기록하고 위젯의 인스턴스를 삭제합니다 가상 에이전트 서비스 포털 .
      1. 위젯의 각 인스턴스 가상 에이전트 서비스 포털 를 찾아 인스턴스 옵션을 엽니다.
      2. 값을 기록합니다.
      3. 위젯 인스턴스를 삭제합니다.
    2. 위젯 인스턴스에 색상 인스턴스 옵션이 포함된 경우 포털 테마 기록에 색상 변수를 추가합니다.
      1. 다음으로 이동 서비스 포털 > 테마.
      2. 포털에 대한 테마 기록을 엽니다.
      3. CSS 변수 필드에 $sp-agent-chat-bg 변수를 추가하고 값을 원하는 색상으로 설정합니다. 
        $sp-agent-chat-bg: #ff0000
    3. 위젯 인스턴스 옵션에 URL 매개변수가 포함되어 있는 경우, 이를 서비스 포털 에이전트 채팅 구성 양식 서버 스크립트 필드에 추가하십시오.
      주:
      포털 접미사, 페이지 ID 및 언어는 자동으로 사용할 수 에이전트 채팅 있으며 사용자 지정 스크립트가 필요하지 않습니다. 시스템 ID 및 테이블은 URL에 있을 때 자동으로 사용할 수 에이전트 채팅 있습니다.
      1. 원하는 포털의 서비스 포털 에이전트 채팅 구성 [sp_agent_chat_config] 테이블에서 기록으로 이동합니다.
      2. 서버 스크립트 필드에 매개변수에이전트 채팅를 전달할 사용자 지정 스크립트를 작성합니다.

        이 예에서는 chat_queue 필드의 값을 현재 대화로 반환합니다.

        (function ($sp) {    
	return {        
		chat_queue: $sp.getValue('chat_queue')    
	};
})($sp);

    결과

    위젯 인스턴스가 개별 포털 페이지에서 제거됩니다. 대신 포털은 모든 포털 페이지에 서비스 포털 에이전트 채팅 구성 기록을 적용합니다.

    페이지 데이터 전달 대상 에이전트 채팅

    위젯 클라이언트 스크립트에서 spContextManager 클래스를 사용하여 동적 페이지 데이터를 에 전달합니다.에이전트 채팅 예를 들어, 사용자가 홈페이지에서 대화를 시작할 때 승인 위젯 에이전트 채팅 의 승인 수를 전달합니다.서비스 포털

    시작하기 전에

    필요한 역할: 관리자

    위젯을 검사하여 데이터가 위젯 클라이언트 스크립트에 전달되는 방식을 이해합니다. 에서 데이터를 사용할 수 에이전트 채팅있도록 하려면 spContextManager 서비스에 전달해야 합니다. 그런 다음 vaContext 객체를 사용하여 주제의 가상 에이전트 데이터에 액세스할 수 있습니다. 스크립트에서 가상 에이전트 컨텍스트 변수를 사용하는 방법에 대한 자세한 내용은 가상 에이전트 스크립트를 참조하십시오.

    프로시저

    1. 위젯 편집기에서 위젯을 엽니다.
    2. 위젯 클라이언트 스크립트를 업데이트합니다.
      1. spContextManager 서비스를 위젯 클라이언트 스크립트 함수에 삽입합니다.
      2. spContextManager API를 사용하여 변수를 전달합니다에이전트 채팅.

      이 예제에서는 approval_count 전달합니다.에이전트 채팅 사용자가 홈페이지에서 대화 서비스 포털 를 시작하면 시스템은 에이전트 채팅 iframe URL에 &sysparm_approval_count=5를 추가합니다.

      function ($scope, spContextManager) {

   spContextManager.addContext('agent-chat', {
      'approval_count': 5       
   });
};

      이 API에 전달되는 키는 페이지당 고유합니다. 예를 들어 'agent-chat' 키가 addContext() 메서드를 통해 페이지의 다른 위젯에 의해 이미 초기화된 경우 updateContextForKey() 메서드를 사용하여 키의 데이터를 업데이트해야 합니다. . spContextManager 클래스에 대한 자세한 내용은 spContextManager를 참조하세요.

    3. 저장을 클릭합니다.
    4. 주제에서 가상 에이전트 데이터를 사용합니다서비스 포털.
      1. 다음으로 이동 가상 에이전트 > 디자이너 을 클릭하고 데이터를 사용할 서비스 포털 주제를 엽니다.
      2. 주제 플로우 편집을 클릭합니다.
      3. 필요에 따라 주제를 구성합니다.
        스크립트 필드에서 vaContext 객체를 사용하여 에서 전달된 서비스 포털컨텍스트 변수에 액세스합니다.

        주제 생성 가상 에이전트 에 대한 자세한 내용은 가상 에이전트 생성 주제를 참조하십시오.

        예를 들어, 이 스크립트는 승인 위젯의 approval_count 변수 값에 액세스합니다. 
        (function execute() {
    return "Your approval count is: " + vaContext.approval_count;
})()
      4. 주제를 저장하고 게시합니다.

    결과

    에이전트 채팅는 최종 사용자가 페이지에서 대화를 시작할 때 변수에 액세스할 수 있습니다.서비스 포털

    에이전트 채팅에 변수 값이 표시됩니다.

    헤더 메뉴에서 라이브 채팅 링크 제거

    포털의 헤더 메뉴에 라이브 채팅 링크가 포함되어 있는 경우 위젯의 옵션 스키마를 업데이트하여 제거할 수 있습니다.

    시작하기 전에

    필요한 역할: 관리자

    이 태스크 정보

    채팅 큐 필드를 포털 기록에 추가하면 포털의 헤더 메뉴에 라이브 채팅 링크가 추가됩니다. 포털을 과 통합 에이전트 채팅하면 라이브 채팅 링크가 더 이상 필요하지 않습니다.

    프로시저

    1. 서비스 포털 구성 페이지에서 포털 테이블 > 메뉴가 포함된 인스턴스.
    2. 포털의 헤더 메뉴에 대한 기록을 엽니다.
      예를 들어, 기본 시스템 포털을 사용하는 경우 SP 헤더 메뉴 를 엽니다.
    3. 추가 옵션, JSON 형식 필드에 다음 JSON 키-값 쌍을 추가합니다. 
      “enable_live_chat”: {
    “displayValue”: “false”,
    “value”: false
}
      최종 JSON은 다음과 같습니다. 
      {
    “enable_cart”: {
        “displayValue”: “true”,
        “value”: true
    },
     “enable_wishlist”: {
       “displayValue”: “true”,
         “value”: true
     },
    “enable_live_chat”: {
      “displayValue”: “false”,
        “value”: false
    }
}
    4. 업데이트를 클릭합니다.

    결과

    포털로 이동하면 헤더 메뉴에 라이브 채팅 이 표시되지 않습니다.