SNIPPET

스크립트에 사용자 정의 코드를 추가할 수 있도록 합니다.

종속성

• 이 작업에 사용하는 코드는 NICE CXone에서 개발한 자체 스크립트 언어인 Snippet(으)로 작성해야 합니다. Studio 기술 참조 가이드는 스니펫의 스크립팅에 관한 세부 정보를 제공합니다.
• 동적 데이터 개체의 속성 이름에는 __type (밑줄 2개 포함)을(를) 사용할 수 없습니다. 이 단어는 동적 개체에서 JSON을 구문 분석할 때 사용하도록 예약되어 있습니다.
• Snippet 작업을 사용하여 API를 호출할 수 있습니다. 최대 응답 크기는 32KB입니다. REST API 작업의 응답 크기 제한과 일치합니다.  이 제한은 클러스터 불안정 및 중단을 방지하기 위해 엄격하게 적용되고 있습니다. 가능하면 대신 REST API 작업을 사용하십시오. 제한은 동일하지만 더 무거운 작업을 처리할 수 있습니다. 이 SNIPPET 작업을 사용해야 하는 경우 다음 팁에 따라 반환되는 데이터의 크기를 줄이세요.

  • API 응답에서 데이터를 필터링합니다. 예를 들어 NICE 보고 API를 사용하여 컨택을 얻는 경우 컨택의 startDate 및 endDate을(를) 기준으로 결과를 필터링할 수 있습니다. 또한 이 API 호출을 사용하면 최대 항목 수를 반환하고 제한할 수 있습니다. 어떤 필터링을 사용할 수 있는지 확인하려면 스크립트 통합과 함께 제공된 API 설명서를 참조하세요.

  • 필요한 데이터만 반환하도록 API 요청을 업데이트합니다. 예를 들어 NICE 보고 API를 사용하여 컨택을 얻는 경우 contactId 또는 agentId 필드를 사용하여 관련 데이터만 반환할 수 있습니다. 사용할 수 있는 데이터 한도를 확인하려면 스크립트 통합과 함께 제공된 API 설명서를 참조하세요.

  • 이전 옵션 중 하나를 수행할 수 없는 경우 미들웨어를 빌드합니다.

지원되는 스크립트 유형

일반	이메일	채팅	전화	음성 사서함	작업 항목	SMS	디지털

입력 속성

이러한 속성은 실행할 때 작업이 사용하는 데이터를 정의합니다.

속성	설명
캡션 추가	스크립트에서 이 작업을 고유하게 식별하는 짧은 문구를 입력합니다. 캡션은 스크립트 캔버스의 작업 아이콘 아래에 표시됩니다.
Data	Snippet editor 창에 추가된 사용자 정의 코드를 포함합니다. 여기에는 다수의 ASSIGN 및 DYNAMIC 명령, 다양한 흐름 제어 문, 내장된 사용자 정의 함수가 포함될 수 있습니다.
Max String Size	Data 속성에서 모든 명령의 최대 문자열 크기를 설정합니다. 옵션은 Limit2K, Limit4K, Limit8K, Limit16K, Limit32K입니다. 이 한도는 Rest API 및 SOAP을 사용한 통합 응답에 적용됩니다.

결과 브랜치 조건

결과 브랜치 조건을 사용하면 작업이 실행될 때 여러 결과를 처리하기 위해 스크립트에 브랜치를 생성할 수 있습니다.

조건	설명
Default	다른 분기를 사용하기를 요구하는 조건을 스크립트가 충족하지 않는다면 사용되는 경로입니다. 작업의 다른 분기가 정의되지 않았을 때도 사용되는 경로입니다.
오류	작업이 올바로 실행되지 않을 때 사용되는 경로. 예를 들어, 연결 불량, 구문 오류 등 예기치 않은 문제가 있을 때 사용됩니다. _ERR 변수(밑줄 문자 하나 포함)는 문제의 요약 설명으로 채워져야 합니다.

팁 및 요령

• Snippet 작업에서 asjson() 함수를 사용하고 결과 JSON을 문자열 변수에 저장합니다. JSON 데이터를 전달해야 할 때는 다른 Studio 작업 속성에 문자열 변수를 사용합니다. 이 방법으로는 스크립트를 저장할 때 유효성 검증 오류가 발생할 가능성을 피할 수 있습니다.
• ASR 컨택은 말하기, 전화 키 누르기 또는 두 가지를 결합하여 녹음된 음성 프롬프트에 응답할 수 있습니다 지원 IVR 발신자가 음성 명령, 키 입력 또는 둘 다를 통해 인터랙션하여 정보를 얻거나 인바운드 음성 통화를 라우팅 또는 두 가지를 모두 할 수 있는 자동화된 전화 메뉴입니다. 시스템을 사용하는 경우에는 스니펫에서 사용할 수 있는 매개 변수 세트가 있습니다.
• Snippet 언어는 변수와 개체를 선언하고, 루프와 반복문을 생성하는 등 다양한 작업을 수행할 수 있는 키워드 명령을 제공합니다.
• Studio에는 스크립트에 사용할 수 있는 함수가 내장되어 있습니다.
• 스니펫에서 사용할 사용자 정의 함수를 생성할 수 있습니다.
• Snippet editor 창에서 스니펫 코드를 테스트 및 디버그할 수 있습니다.

Snippet Editor Window

Snippet 작업을 선택하고 작업 속성에서 편집기 열기를 클릭하면 Snippet editor 창이 열립니다.

스크립트 예시

이 간단한 예에서 Snippet의 코드를 사용해 타사 시스템의 정보로 잠재 고객 생성이 가능한지 여부를 테스트합니다.

이 스크립트 다운로드.