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

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기9분

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

    시작하기 전에

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

    프로시저

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

      사용자가 로그인하기 전에 사용할 수 있도록 하려면 에이전트 채팅 선택합니다.
      역할

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

      사용자가 대화를 시작할 때 페이지 및 위젯 데이터를 대화에 에이전트 채팅 전달하는 스크립트를 작성합니다. 예를 들어, 채팅 대화에 필드를 전달하여 값에 액세스할 수 있도록 합니다 에이전트 채팅 . 이 스크립트에 전달된 데이터는 이 기록과 연결된 포털의 모든 페이지에서 사용할 수 있습니다. 이 스크립트는 GlideSPScriptable API에 액세스할 수 있습니다.

      주:
      포털 접미사, 페이지 ID, 언어는 자동으로 에이전트 채팅에서 사용할 수 있으며 사용자 지정 스크립트가 필요하지 않습니다. Sys 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 또는 none)

    프로시저

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

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

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

    결과

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

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

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

    시작하기 전에

    필요한 역할: admin

    위젯을 검사하여 데이터가 위젯 클라이언트 스크립트에 전달되는 방식을 이해합니다. 에서 데이터를 사용할 수 에이전트 채팅있도록 하려면 데이터를 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에 전달된 키는 페이지당 고유합니다. 예를 들어 '에이전트 채팅' 키가 addContext() 메서드를 통해 페이지의 다른 위젯에 의해 이미 초기화된 경우 updateContextForKey() 메서드를 사용하여 키의 데이터를 업데이트해야 합니다. . spContextManager 클래스에 대한 자세한 내용은 spContextManager를 참조하십시오.

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

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

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

    결과

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

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

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

    포털의 헤더 메뉴에 Live Chat 링크가 포함된 경우 위젯의 옵션 스키마를 업데이트하여 제거할 수 있습니다.

    시작하기 전에

    필요한 역할: admin

    이 태스크 정보

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

    프로시저

    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. 업데이트를 클릭합니다.

    결과

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