GETRICHMESSAGE

디지털 AskCaller 작업 또는 TExtMsg 작업으로 리치 메시지 JSON을 전달합니다.  이렇게 하면 스크립트에서 JSON을 작성하는 대신 디지털 컨택 포인트 페이지에서 생성한 리치 메시지 템플릿을 ACD 스크립트에서 사용할 수 있습니다.

종속성

• 이 작업에는 Digital Experience이(가) 필요합니다.
• 디지털 스크립트로 작업하기 전에 기존 ACD 스크립트와 디지털 스크립트의 차이점에 대해 알아보십시오.
• AskCaller  또는 TExtMsg 작업 중 하나와 함께 사용해야 합니다.
• GETRICHMESSAGE을(를) 스크립트의 AskCaller 또는 TExtMsg에 배치합니다.

• 다음 드롭다운에 표시된 것처럼 리치 메시징 콘텐츠 유형에 대한 지원은 채널에 따라 다릅니다.

  더 보기

• CXone의 디지털 컨택 포인트 페이지에서 이 작업과 함께 사용할 리치 메시지 템플릿을 생성합니다. 목록 선택기, 시간 선택기, 리치 링크, 빠른 회신 등의 템플릿을 생성할 수 있습니다. 다른 리치 미디어를 사용해야 하는 경우에는 GETRICHMESSAGE을(를) 사용할 수 없습니다. 대신 Snippet 작업에서 JSON을 구축하고 이를 AskCaller 또는 TExtMsg(으)로 전달해야 합니다. 자세한 내용은 해당 작업에 대한 온라인 도움말의 종속성 섹션에서 확인하십시오.

지원되는 스크립트 형식

디지털

유사한 작업 비교

다음 작업에는 유사한 기능이 있지만 주요 차이점이 있습니다.

• AskCaller: 디지털 채팅 기반 채널을 통해 컨택에 정보를 요청합니다. 리치 메시징 버튼, 이미지, 메뉴, 옵션 선택기와 같은 디지털 메시징의 요소입니다. 콘텐츠를 표시할 수 있습니다.
• GetRichMessage: CXone의 채널 구성에서 리치 메시징 템플릿을 검색합니다.
• Textmsg: 컨택에 텍스트 기반 메시지를 보냅니다. 리치 메시징 콘텐츠를 표시할 수 있습니다.

입력 속성

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

속성	설명
캡션 추가	스크립트에서 이 작업을 고유하게 식별하는 짧은 문구를 입력합니다. 캡션은 스크립트 캔버스의 작업 아이콘 아래에 표시됩니다. The default is the action name.
channelID	이 스크립트가 메시지를 보내는 데 사용하는 디지털 채널을 선택합니다.

출력 속성

이러한 속성에는 작업 실행에서 반환되는 데이터를 보유하는 변수가 포함됩니다. 작업이 완료될 때 참조 및 사용할 수 있습니다.

속성	설명
resultSet	CXone에서 반환되는 JSON을 보유합니다. 이 변수의 내용을 Askcaller 또는 TExtmsg(으)로 JSON 문자열의 형태로 전달합니다..

결과 브랜치 조건

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

조건	설명
Default	다른 분기를 사용하기를 요구하는 조건을 스크립트가 충족하지 않는다면 사용되는 경로입니다. 작업의 다른 분기가 정의되지 않았을 때도 사용되는 경로입니다.
OnError	작업이 올바로 실행되지 않을 때 사용되는 경로. 예를 들어, 연결 불량, 구문 오류 등 예기치 않은 문제가 있을 때 사용됩니다. _ERR 변수(밑줄 문자 하나 포함)는 문제의 요약 설명으로 채워져야 합니다.
OnSucess	작업이 오류 없이 완료되고 API 호출 또는 데이터 반환이 성공한 경우 사용되는 경로(2xx 응답 코드).

필수 스니펫 작업 코드

이 작업을 수행하려면 GETRICHMESSAGE 작업이 디지털 컨택 포인트에서 반환하는 리치 미디어 템플릿을 처리하는 코드가 있는 Snippet 작업이 필요할 수 있습니다. 컨택 포인트에 템플릿이 하나만 있는 경우에는 스니펫 코드가 필요하지 않습니다. resultId 속성에 지정된 변수를 사용할 수 있습니다. 두 개 이상의 템플릿이 있는 컨택 포인트의 경우 스니펫 코드가 필요합니다.

1. ACD 애플리케이션의 컨택 포인트 디지털 페이지에서 템플릿을 생성한 다음 이 템플릿을 사용하려는 컨택 포인트에 배정합니다. 이 단계를 완료하려면 CXone 관리자의 도움이 필요할 수 있습니다.

2. 디지털 미디어 유형으로 스크립트를 만듭니다.

3. GETRICHMESSAGE 작업을 추가하고, ASKCALLER 작업 또는 TeXTMSG 작업 중 하나를 추가합니다. 컨택 포인트에 템플릿이 두 개 이상인 경우 SNIPPET 작업도 필요합니다.
4. GETRICHMESSAGE에서 템플릿을 할당한 컨택 포인트로 ChannelId 속성을 구성합니다.
5. 적절한 코드를 SNIPPET 작업에 추가합니다.

   • 템플릿이 하나밖에 없거나 이 스크립트로 템플릿을 하나만 전송하려는 경우에는 다음과 같은 코드를 사용하십시오.

     DYNAMIC json1 
     ASSIGN json1.data[1] = resultset.data[1]

   • 템플릿이 여러 개 있고 이 스크립트로 두 개 이상의 템플릿을 보낼 수 있게 하려면 다음과 같은 코드를 사용하십시오.

     DYNAMIC json1
     DYNAMIC json2
     DYNAMIC json3
     				 
     ASSIGN json1.data[1] = resultset.data[1]
     ASSIGN json2.data[1] = resultset.data[2]
     ASSIGN json3.data[1] = resultset.data[3]

6. 전송하려는 템플릿을 식별하는 인덱스 번호를 변경합니다. 이전 단계의 예시 코드에서는 resultset.data[x] 변수에서 인덱스 번호를 변경합니다. 템플릿을 할당하는 변수의 인덱스는 변경하지 마십시오. 예시 코드에서 변수는 jsonY.data[Z]이며, Y는 변경할 수 있지만 Z는 변경하면 안 됩니다. 각 jsonY 변수는 템플릿을 하나 보유합니다.
7. 원하는 경우 변수 이름을 수정합니다. 수정하려는 경우에는, 스크립트의 다른 작업에서 필요에 따라 변수 이름을 변경하십시오. 예를 들어 resultSet은(는) GETRICHMESSAGe의 resultSet 속성에 있는 기본 변수 이름입니다. jsonY 변수는 AskCaller 및 Textmsg의 Message 속성에서 사용됩니다.
8. AskCaller 또는 Textmsg을(를) 구성합니다. 
   1. MessageFormat 속성을 JSON으로 변경합니다.
   2. 전송하는 템플릿의 JSON을 보유한 변수의 이름으로 Message 속성을 구성합니다. JSON 문자열로 전송해야 합니다. 이 필드에서 변수 대체를 사용할 수 있습니다. 그렇게 하는 경우에는 Snippet에 코드를 추가하여 전송할 템플릿을 선택하고 적절한 변수를 전달합니다.
   3. 브랜치 연결을 포함하여 필요에 따라 작업의 다른 속성을 구성합니다. ASKCALLER 작업 또는 TeXTMSG 작업의 온라인 도움말을 참조하십시오.

스크립트 예시

이 예시에서는 SNIPPET 작업에 연결된 GETRICHMESSAGE 작업을 표시하는데, 이는 TeXTMSG에 연결되어 있습니다. 또한 ASKCALLER에도 연결될 수 있습니다. 스크립트가 실행될 때 GETRICHMESSAGE은(는) channelId에서 지정한 사용 가능한 디지털 채널에 대한 리치 메시지 템플릿을 가져옵니다. resultId 속성에 지정된 변수에 저장됩니다. 이 예시에서 변수는 resultId입니다. 스니펫 코드에는 특정한 리치 메시지 템플릿 JSON을 보유하고 TeXTMSG(으)로 전달하는 동적 데이터 개체가 포함됩니다.

이 스크립트 다운로드하기.