SNIPPET

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

종속성

• 이 작업에서 사용되는 코드는 Snippet를 위해 개발된 사내 스크립팅 언어인 CXone Mpower로 작성되어야 합니다. 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 설명서를 참조하세요.

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

• Studio의 배열의 최대 크기는 6,300만 개입니다. 이 배열 크기를 초과하면 스크립트 추적의 변수에서 다음 이__err 오류가 발생합니다.: 배열 인덱스가 범위를 벗어났습니다. 현재 배열 인덱스([index])가 허용되는 최대 인덱스(63000000)를 초과합니다. 배열 크기를 초과하면 스크립트는 SNIPPET 작업의 Error 분기를 수행합니다. Error 브랜치가 연결되지 않은 경우 스크립트는 계속 실행되지만 배열 정보는 없습니다. EMAIL 작업의 SNIPPET 분기에 Error 작업을 추가하여 최대 배열 크기를 초과했을 때 알림을 받도록 스크립트를 구성할 수 있습니다. 마지막으로, 스크립트를 계속 진행하려면 Error 브랜치에 논리를 추가할 수 있습니다. 배열 정보 없이 계속 진행됩니다.

지원되는 스크립트 유형

일반	이메일	채팅	전화	음성 메일	워크 아이템	SMS	디지털

입력 속성

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

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

결과 브랜치 조건

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

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

팁 및 요령

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

Snippet Editor Window

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

스크립트 예시

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

이 스크립트를 다운로드합니다.