사용자 지정 코드로 참여 메신저에서 기능 시작

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 4분

    • 사용자 지정 코드를 사용하여 딥링크를 활성화하고 웹 사이트와 통합된 기능을 참여 메신저 시작합니다.

    시작하기 전에

    참여 메신저 구성.

    웹 애플리케이션에 참여 메신저 포함.

    필요한 역할: ec_admin 및 웹 사이트 관리자

    이 태스크 정보

    주:

    기존 코드를 사용하는 경우 v=3.1을 표시하도록 스크립트를 업데이트해야 합니다. 예:

    <script src="https://example.service-now.com/scripts/sn_csm_ec.js?v=3.1"></script>
<script>
SN_CSM_EC.init({
      moduleID: "https://example.service-now.com/#aeff0547dd393010f87734cef087e2ba",
      loadFeature: SN_CSM_EC.loadEMFeature()
});
</script>

    프로시저

    1. 다음으로 이동 참여 메신저 > 모듈.
    2. 참여 메신저 모듈 구성에서 구현 탭을 엽니다.
    3. Embed 코드 섹션에서 코드를 복사합니다.
    4. 텍스트 편집기에서참여 메신저를 통합하는 웹 사이트의 웹 페이지 HTML 파일을 엽니다.
    5. 닫는 본문 태그 앞에 복사한 코드를 붙여넣습니다.
    6. 기능 컨텍스트를 정의하고 기능에 대한 변수를 지정합니다.
      다음 형식을 사용하여 기능 컨텍스트를 정의합니다.
      { 
	feature: "<feature_name>", 
	openOnLoad: <true/false>, 
	params: { 
		"<param_name>": "<param_value>",
		"<param_name>": "<param_value> 
	} 
}
      이 형식으로 기능 변수를 지정합니다.
      feature
      기능 이름입니다. 자세한 내용은 참여 메신저에서 지원되는 기능 컨텍스트 매개변수 문서를 참조하십시오.
      openOnLoad
      참여 메신저가 자동으로 열리도록 하려는 경우에만 이 옵션을 포함하고 true로 설정하십시오. 이 옵션의 기본 설정은 참여 메신저가 자동으로 열리지 않도록 하는 것입니다.
      <param_name>": "<param_value>
      기능에 연결된 매개변수의 이름 및 값입니다. 자세한 내용은 참여 메신저에서 지원되는 기능 컨텍스트 매개변수 문서를 참조하십시오.
    7. 기능 컨텍스트를 SN_CSM_EC.init 함수에 전달하는 사용자 지정 래퍼 함수를 생성합니다.
      예를 들어, 다음 코드는 채팅 기능 컨텍스트에 chatFeatureContext() 사용자 지정 래퍼 함수를 사용합니다.
      
function chatFeatureContext(){ 
	return { 
			feature: "CHAT",
			openOnLoad: false,
			params: { 
				"topic_id": "8708db281bd5b81080df6247b04bcb79",
				"language": "fr"		
				} 
		  } 
}
    8. SN_CSM_EC.loadEMFeature() 함수를 7단계에서 만든 사용자 지정 래퍼 함수로 바꿉니다.
      예를 들어, 다음 코드에서는 chatFeatureContext() 래퍼 함수가 loadFeature 속성의 값으로 전달됩니다.
      SN_CSM_EC.init({ 
		moduleID: "https://example.service-now.com/#<module_id>", 
		loadFeature: chatFeatureContext()
});
    9. 파일을 저장합니다.
    10. 옵션: 지정된 기능이 시작되는지 확인합니다.
      1. 참여 메신저가 포함된 웹 사이트를 엽니다.
      2. 시작 관리자 아이콘을 선택합니다.
      3. 참여 메신저가 Embed 코드에서 구성한 기능을 시작하는지 확인합니다.

    결과

    Embed 코드에서 지정한 기능은 포함된 웹 사이트에서 열릴 때 참여 메신저 기본적으로 실행됩니다.

    예

    다음 코드는 기본적으로 채팅 기능을 시작합니다. 또한 주제의 시스템 식별자(sys_id)를 전달하여 채팅이 로드될 때 기본적으로 가상 에이전트 주제를 트리거하는 방법을 보여줍니다. 언어를 지정하여 해당 언어로 채팅을 시작할 수도 있습니다.

    <script src="https://example.servicenow.com/scripts/sn_csm_ec.js?v=3.1"></script>
<script>
function chatFeatureContext(){ 
	return { 
			feature: "CHAT",
			openOnLoad: false,
			params: { 
				"topic_id": "8708db281bd5b81080df6247b04bcb79",
				"language": "fr"		
				} 
		  } 
}

SN_CSM_EC.init({
	moduleID: "https://example.service-now.com/#d27c94d6db403810a2a6a0ced39619da",
	loadFeature: chatFeatureContext()
});
</script>
    function
    chatFeatureContext(): 채팅 컨텍스트에 대한 래퍼 함수입니다.
    feature
    CHAT: 가상 에이전트 또는 라이브 에이전트 채팅을 시작하기 위한 채팅 기능입니다.
    openOnLoad
    false: 참여 메신저의 자동 시작을 비활성화합니다.
    topic_id
    8708db281bd5b81080df6247b04bcb79: 모듈 시스템 식별자(sys_id)입니다.
    language
    fr:기본 채팅 언어를 프랑스어로 설정합니다.