사용자 정의 페이로드 스니펫

이 도움말 페이지의 정보는 CXone Studio 및 Desktop Studio에 모두 적용됩니다.

Voicebot Exchange 또는 Textbot Conversation 등의 customPayload 속성이 있는 작업과 함께 스니펫을 사용합니다. CXone에서 가상 상담원 실제 상담원 대신 고객 인터랙션을 처리하는 소프트웨어 애플리케이션입니다. 제공자로 데이터를 전달하는 데 사용됩니다. 가상 상담원에게서 사용자 정의 데이터를 받아야 하면 customPayloadVarName (out) 변수를 사용합니다.

이 스니펫은 모든 가상 상담원에 필수입니다.

Amazon Lex V1 및 Amazon Lex V2: 사용자 정의 페이로드 스니펫은 데이터를 가상 상담원에게 전달할 필요가 없어도 Lex V1 및 Lex V2에 필수입니다. 가상 상담원은 customPayload 속성을 통해 전달되는 데이터를 사용하여 Amazon 측의 SessionAttributes 속성을 채웁니다.
Google Dialogflow ES: 사용자 정의 페이로드가 Dialogflow ES 가상 상담원이 의도 컨택이 말하거나 입력하는 내용의 의미나 목적이며 컨택이 전달하고자 하는 내용이나 원하는 내용입니다.를 파악하는 데 사용하는 컨텍스트 정보를 전달합니다. 사용자 정의 페이로드 데이터 및 Google Dialogflow ES 통합을 위해 권장 모범 사례를 따르십시오.

기타 모든 가상 상담원에 대해서는 봇에 전달할 사용자 정의 페이로드 데이터가 있으면 스니펫만 포함하면 됩니다. Dialogflow CX를 사용하는 경우, 사용자 정의 페이로드를 포함하기 위한 모범 사례를 따르십시오.

자리 표시자 전달

Amazon Lex V1 또는 Amazon Lex V2을(를) 사용하며 가상 상담원에게 정보를 전달할 필요가 없으면 다음 예시를 따르십시오.

DYNAMIC customPayload 
 customPayload.placeholder=""

가상 상담원에게 정보를 전달해야 하는 경우에는 다음 섹션의 예를 따르세요.

데이터 전달

모든 가상 상담원에 대해서는 이 예시를 따라 정보를 가상 상담원에게 전달하십시오. 예시의 매개 변수를 전달해야 하는 정보로 교체합니다.


customPayload.context.id="information"
customPayload.context.lifespan=1
customPayload.context.parameters.name="Fenrir"
customPayload.context.parameters.age="19"
customPayload.context.parameters.date="20201020"

Google Dialogflow CX 사용자 정의 페이로드의 모범 사례

Dialogflow CX는 Dialogflow ES처럼 Dialogflow 의도 컨택이 말하거나 입력하는 내용의 의미나 목적이며 컨택이 전달하고자 하는 내용이나 원하는 내용입니다.로 데이터를 전달하기 위해 컨텍스트를 사용하지 않습니다.
사용자 정의 데이터는 JSON 키-값 쌍을 사용하여 Dialogflow CX로 전달할 수 있습니다. 스크립트의 Snippet action 작업에서 동적 customPayload 개체를 생성하고 이 개체에 키-값 쌍을 추가합니다. 예:
```
DYNAMIC customPayload
customPayload.ani = ani
customPayload.contactID = contactId
customPayload.masterContactId = masterId
customPayloadJSON = "{customPayload.asJSON()}"	
```
스크립트의 Exchange 또는 Conversation 작업에서 값에 asJSON() 기능을 갖는 변수를 사용하여 customPayload 속성을 구성합니다. 이 변수는 customPayload 개체에서 찾을 수 있습니다.
QueryParameters의 Payload 속성을 사용하여 가상 상담원에게 customPayload JSON을 전달합니다. Google Dialogflow CX의 QueryParameters 에 대해 Google 설명서를 참조하십시오.
QueryParameters을(를) 통해 전달된 데이터는 Dialogflow CX에서 웹후크가 수신합니다. 전달된 데이터를 처리하기 위해 Dialogflow CX 콘솔에서 코드를 작성할 수 있습니다.
customPayload 개체 안에 개체를 중첩하지 마십시오. 중첩된 개체는 리터럴 문자열로 전송됩니다.
자신의 Dialogflow CX 가상 상담원에서 스크립트로 사용자 정의 데이터를 다시 전달하려면 Dialogflow CX 콘솔의 사용자 정의 페이로드 필드를 사용합니다. CXone와(과) 사용 중인 가상 상담원의 콘솔인지 확인합니다. 스크립트의 음성 또는 채팅 Studio 작업에서 customPayloadVarName (out) 변수를 사용하여 이를 스크립트에 매핑합니다. 예를 들어 이를 사용하여 다음 프롬프트의 행동을 설정할 수 있습니다.
customPayload을(를) 사용해 설정한 매개 변수는 외부 웹후크에서만 사용할 수 있습니다. 외부 웹후크 밖에서 사용할 매개 변수를 설정하려면 session_params 필드를 사용하여 Snippet 작업에서 설정해야 합니다. 예:
```
{
	"session_params":
	{ 
		"name": "Winnie Le Pooh"
		"job": "Food critic"
		"location": "Hundred Acre Wood"
	}
}
```
다음 구문을 사용해 Dialogflow CX 상담원 의도의 세션 매개변수에 액세스:

$session.params.name = Winnie Le Pooh

$session.params.job = Food critic

$session.params.location = 100 Acre Wood

세션 매개변수는 Dialogflow CX 가상 상담원에만 사용됩니다. Dialogflow ES에서 유사한 결과를 얻으려면 컨텍스트를 사용하십시오.
음성 컨텍스트 힌트는 speechContexts 매개변수에서 사용자 정의 페이로드와 함께 전달될 수 있습니다. speechContexts.phrases의 값은 제공하려는 힌트에 대한 Google 클래스 토큰 이어야 합니다. 토큰은 컨택의 언어 및 지역과 일치해야 합니다. 예:
```
DYNAMIC customPayload
customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
customPayload.speechContexts.boost=10		
```
VOICEBOT EXCHANGE사용 시: 말하는 중 컨택이 일시 중지 상태가 될 때 가상 상담원이 대기하는 시간을 구성하려면 Next Prompt Behaviors 또는 Default Next Prompt Behaviors Snippet 작업에 maxPostEnergySilenceMS 매개 변수를 추가합니다.

Google Dialogflow ES 사용자 정의 페이로드의 모범 사례

CustomPayload은(는) 의도 컨택이 말하거나 입력하는 내용의 의미나 목적이며 컨택이 전달하고자 하는 내용이나 원하는 내용입니다.를 위해 컨텍스트를 전달하기 위해 사용됩니다. 컨텍스트는 가상 상담원이 사용자의 의도를 이해하는 데 도움이 됩니다. 컨텍스트가 필수는 아니지만 가상 상담원이 발화 컨택이 말하거나 입력하는 내용입니다.와 의도를 일치시키는 데 도움이 됩니다.
스크립트의 Snippet 작업에서 REST 리소스: projects.agent.sessions.context에 대한 Google Dialogflow ES 설명서 에 설명된 형식을 따르는 customPayload 개체를 생성합니다. Studio 온라인 도움말은 동적 데이터 개체에 대한 추가 정보를 제공합니다.
또한 컨텍스트 없이 customPayload(으)로 사용자 정의 데이터를 전달할 수 있습니다. 이를 위해 동적 데이터 개체에 표준 JSON 키-값 쌍을 포함시킵니다.
음성 컨텍스트는 speech_contact 매개 변수를 통해 사용자 정의 페이로드에 전달됩니다. Studio 추적 및 애플리케이션 로그에서 이 매개 변수의 내용을 볼 수 있습니다.
스크립트 예시에서와 같이 customPayload 동적 개체는 JSON 형식의 가상 상담원 매개변수로 전달됩니다.
음성 컨텍스트 힌트는 speechContexts 매개변수에서 사용자 정의 페이로드와 함께 전달될 수 있습니다. speechContexts.phrases의 값은 제공하려는 힌트에 대한 Google 클래스 토큰 이어야 합니다. 토큰은 컨택의 언어 및 지역과 일치해야 합니다. 예:
```
DYNAMIC customPayload
customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
customPayload.speechContexts.boost=10		
```