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

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

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

기타 모든 가상 상담원에 대해서는 봇에 전달할 사용자 정의 페이로드 데이터가 있으면 스니펫만 포함하면 됩니다. 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

이 스크립트는 사용자 정의 페이로드와 Google Dialogflow ES 가상 상담원을 통합하는 방법을 보여 주는 예시입니다. 이 스크립트는 Voicebot Exchange 작업을 사용하지만 TEXTBOT EXCHaNGE을(를) 대신 사용하는 경우에도 작동합니다.

Google Dialogflow CX을(를) 사용하여 사용자 정의 페이로드를 처리하는 방법을 보여주는 예제 스크립트.

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