---
sourceDocument: 호주 고객 서비스 관리
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/customer-service-management

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 고객 서비스 관리

ft:clusterId :

    - csm

bundleId :

    - csm

workflow :

    - Customer and Industry


---

# 사용자 지정 코드를 사용하여 기능 시작

# 사용자 지정 코드로 참여 메신저에서 기능 시작 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 4분

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

## 시작하기 전에

[참여 메신저 구성](https://servicenow-prod.fluidtopics.net/lprNEFFwZP3ARdRCmfkGgw "모듈을 참여 메신저 만들고 해당 동작, 모양 및 스타일을 구성합니다. 메신저 모듈을 생성하여 조직 브랜딩과 고객 요구에 따라 디자인과 동작을 사용자 지정할 수 있습니다.").

[웹 애플리케이션에 포함 참여 메신저](https://servicenow-prod.fluidtopics.net/MV3duBG6BedR2Hv8zYCZAw "고객이 웹 사이트에서 메신저 모듈을 사용할 참여 메신저 수 있도록 웹 사이트에 구성한 메신저 모듈의 소스 코드를 포함합니다.").

필요한 역할: 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: "<var class="keyword varname">&lt;feature_name&gt;</var>", 
       	openOnLoad: <var class="keyword varname">&lt;true/false&gt;</var>, 
       	params: { 
       		"<var class="keyword varname">&lt;param_name&gt;</var>": "<var class="keyword varname">&lt;param_value&gt;</var>",
       		"<var class="keyword varname">&lt;param_name&gt;</var>": "<var class="keyword varname">&lt;param_value&gt;</var> 
       	} 
       }

   이 형식으로 기능 변수를 지정합니다.

   기능
   :   기능 이름입니다. 자세한 내용은 다음 문서를 참조하십시오 [참여 메신저에서 지원되는 기능 컨텍스트 매개변수](https://servicenow-prod.fluidtopics.net/ggWXMKVscSp4nW1tWoxnQg "상황별 시작 기능을 사용하면 에서 기본 시작 화면을 설정할 수 있습니다 참여 메신저.") .

   openOnLoad
   :   이 옵션을 포함하고 자동으로 열려 참여 메신저 는 경우에만 true로 설정합니다. 이 옵션의 기본 설정은 자동으로 열리지 않는 것입니다 참여 메신저 .

   \<param_name\>": "\<param_value\>
   :   기능에 연결된 매개변수의 이름 및 값입니다. 자세한 내용은 [참여 메신저에서 지원되는 기능 컨텍스트 매개변수](https://servicenow-prod.fluidtopics.net/ggWXMKVscSp4nW1tWoxnQg "상황별 시작 기능을 사용하면 에서 기본 시작 화면을 설정할 수 있습니다 참여 메신저.") 문서를 참조하십시오.
7. 기능 컨텍스트를 embed 코드의 `SN_CSM_EC.init` 함수에 전달하는 사용자 지정 래퍼 함수를 생성합니다.  
   예를 들어, 다음 코드는 채팅 기능 컨텍스트에 `chatFeatureContext()` 사용자 지정 래퍼 함수를 사용합니다.


       function chatFeatureContext(){ 
       	return { 
       			feature: "CHAT",
       			openOnLoad: false,
       			params: { 
       				"topic_id": "8708db281bd5b81080df6247b04bcb79",
       				"language": "fr"		
       				} 
       		  } 
       }

   {#contextual-launch-using-script-engagement-messenger__wrapper-creation}
{#contextual-launch-using-script-engagement-messenger__wrapper-creation}
8. `SN_CSM_EC.loadEMFeature()` 함수를 [7단계에서](https://servicenow-prod.fluidtopics.net/HtW8monCYwKDllVfVJ~KiA "사용자 지정 코드를 사용하여 딥링크를 활성화하고 웹 사이트와 통합된 기능을 참여 메신저 시작합니다.") 만든 사용자 지정 래퍼 함수로 바꿉니다.  
   예를 들어 다음 코드에서 `chatFeatureContext()` 래퍼 함수는 `loadFeature` 속성의 값으로 전달됩니다.

       SN_CSM_EC.init({ 
       		moduleID: "https://example.service-now.com/#<module_id>", 
       		loadFeature: <var class="keyword varname">chatFeatureContext</var>()
       }); 

9. 파일을 저장합니다.
10. **옵션:** 지정된 기능이 시작되는지 확인합니다.
    1. 포함 참여 메신저한 웹 사이트를 엽니다.
    2. 시작 관리자 아이콘을 선택합니다.
    3. embed 코드에서 구성한 기능이 시작되는지 참여 메신저 확인합니다.
    {#contextual-launch-using-script-engagement-messenger__substeps_gjt_cts_4qb}

## 결과

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>

함수
:   <var class="keyword varname">chatFeatureContext()</var>: 채팅 컨텍스트에 대한 래퍼 함수입니다.

기능
:   <var class="keyword varname">CHAT</var>: 시작 또는 라이브 에이전트 채팅을 위한 채팅 기능입니다.가상 에이전트

openOnLoad
:   <var class="keyword varname">아니오</var>: 의 자동 시작 참여 메신저을 비활성화합니다.

topic_id
:   <var class="keyword varname">8708db281bd5b81080df6247b04bcb79</var>: 모듈 시스템 식별자(sys_id).

언어
:   <var class="keyword varname">fr</var>: 기본 채팅 언어를 프랑스어로 설정합니다.