가상 에이전트 URL 매개변수

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기4분

    • 가상 에이전트 는 관리자가 인스턴스 URL에 추가하여 페이지 컨텐츠가 렌더링되는 방식을 제어할 수 있는 다양한 시스템 매개변수를 제공합니다.

    가상 에이전트 URL 구조

    인스턴스 URL에 URL 매개변수를 추가하여 인스턴스에 대해 렌더링되는 페이지를 제어할 수 있습니다( https://<instancename>.service-now.com.

    웹 클라이언트에 대한 가상 에이전트 시스템 매개변수

    가상 에이전트 웹 클라이언트는 포털에서 사용하거나 타사 페이지에 임베드할 수 있도록 지원됩니다. 다음 시스템 매개변수는 웹 클라이언트에서 렌더링되는 대화 컨텐츠를 가상 에이전트 제어합니다.
    매개변수 설명 예
    sysparm_branding_key

    웹 채팅 클라이언트에 채팅 브랜딩 구성을 적용합니다.

    값: 구성의 브랜딩 키
    • 대상 페이지에 브랜딩 구성 적용: https://<instancename.service-now.com/$sn-va-web-client-app.do?sysparm_branding_key=acme
    • 포함된 웹 클라이언트에 브랜딩 구성 적용: https://<instancename.service-now.com/$sn-va-web-client-app._embed.do?sysparm_branding_key=acme
    sysparm_default_topic 주제 sys_ID를 통해 시작 시 기본 주제를 설정합니다. https://<instancename>.service-now.com/$sn-va-web-client-app.do?sysparm_default_topic=1f5ac6dfc34020105a61d7de76400001
    sysparm_domain_id 채팅을 도메인의 지정된 시스템 ID로 제한합니다. https://<instancename>.service-now.com/$sn-va-web-client-app.do?sysparm_domain_id=c90d4b084a362312013398f051272c0d
    sysparm_live_agent_only 사용 가능한 경우 사용자를 라이브 에이전트로 직접 연결합니다. https://<instancename.service-now.com/$sn-va-web-client-app._embed.do?sysparm_live_agent_only=true
    sysparm_load_active_only 현재 활성 대화를 로드합니다.
    값:
    • true: 활성 대화만 불러옵니다.
    • false: 활성 대화를 로드하지 않습니다.
    주:
    sysparm_skip_load_history 및 sysparm_load_active_only 매개 변수가 모두 true로 설정된 경우 기존 sysparm_skip_load_history 매개 변수가 우선합니다.
    		 https://<instancename.service-now.com>$sn-va-web-client-app.do?sysparm_load_active_only=예
    sysparm_search_text 대화의 검색 텍스트를 설정합니다. https://<instancename>.service-now.com/$sn-va-web-client-app.do?sysparm_search_text=request&laptop
    sysparm_skip_load_history 이전 메시지 기록을 건너뛰고 새 대화를 시작합니다.
    값:
    • true: 메시지 기록을 로드하지 않습니다.
    • false: 메시지 이력을 로드합니다.
    주:
    sysparm_skip_load_history 매개변수가 false로 설정되고 sysparm_load_active_only가 true로 설정된 경우 sysparm_load_active_only는 현재 활성 대화를 로드합니다.
    		 https://<instancename.service-now.com>$sn-va-web-client-app.do?sysparm_skip_load_history=예
    sysparm_ preview_mode 대화를 테스트 모드로 표시합니다. https://<instancename.service-now.com>$sn-va-web-client-app.do?sysparm_preview_mode=예
    sysparm_requester_session_language 대화 세션에 대한 요청자의 언어를 지정합니다. https://<instancename.service-now.com>$sn-va-web-client-app.do?sysparm_requester_session_language=<두 글자 언어 코드>