가상 에이전트 URL 매개변수

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 4분
  • 가상 에이전트 는 페이지 컨텐츠가 렌더링되는 방식을 제어하기 위해 관리자가 인스턴스 URL에 추가할 수 있는 다양한 시스템 매개변수를 제공합니다.

    가상 에이전트 URL 구조

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

    채팅 위젯의 가상 에이전트 시스템 매개변수

    가상 에이전트 채팅 위젯은 포털에서 사용하거나 외부 공급업체 페이지에 포함할 수 있도록 지원됩니다. 다음 시스템 매개변수는 채팅 위젯에서 가상 에이전트 렌더링되는 대화 컨텐츠를 제어합니다.
    매개변수 설명 예제
    sysparm_branding_key

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

    값: 구성에 대한 브랜딩 키

    • 대상 페이지에 브랜딩 구성 적용:https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_branding_key=<branding_key>
    • 포함된 채팅 위젯에 브랜딩 구성 적용: https://<instance_name>.service-now.com/$sn-va-web-client-app._embed.do?sysparm_branding_key=<branding_key>
    sysparm_default_topic 주제 sys_ID 통해 시작할 때 기본 주제를 설정합니다. https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_default_topic=<topic_sys_id>
    sysparm_domain_id 도메인에 대해 지정된 시스템 ID로 채팅을 제한합니다. https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_domain_id=<domain_sys_id>
    sysparm_live_agent_only 사용 가능한 경우 사용자를 라이브 에이전트로 직접 연결합니다. https://<instance_name>.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://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_load_active_only=true
    sysparm_search_text 대화에 대한 검색 텍스트를 설정합니다. https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_search_text=<search_text>

    예를 들어 <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://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_skip_load_history=true
    sysparm_ preview_mode 대화를 테스트 모드로 표시합니다. https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_preview_mode=true
    sysparm_requester_session_language 에 대한 가상 에이전트 동적 변환이 설치되고 구성된 경우 대화 세션에 대한 요청자의 언어를 지정합니다. https://<instance_name>.service-now.com/$sn-va-web-client-app.do?sysparm_requester_session_language=<두 글자 언어 코드>