사용 가능한 연락처 특성 및 해당 JSONPath 참조 목록 - Amazon Connect

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

사용 가능한 연락처 특성 및 해당 JSONPath 참조 목록

다음 표에는 Amazon Connect Connect에서 사용할 수 있는 연락처 속성이 설명되어 있습니다.

각 속성에 대한 JSONPath 참조가 제공되므로 다음을 수행할 수 있습니다.동적 텍스트 문자열 생성.

시스템 속성

이러한 속성은 Amazon Connect 커넥트에서 미리 정의된 속성입니다. 시스템 속성을 참조할 수는 있지만 생성할 수는 없습니다.

흐름의 모든 블록이 시스템 속성 사용을 지원하는 것은 아닙니다. 예를 들어, 시스템 속성을 사용하여 고객 입력을 저장할 수는 없습니다. 대신 a를 사용합니다.사용자 정의 속성고객이 입력한 데이터를 저장하십시오.

속성 설명 유형 JSONPath 참조

고객 번호

고객 전화 번호입니다.

아웃바운드 귓속말 흐름에서 사용되는 경우 에이전트가 고객에게 연결하기 위해 전화를 건 번호입니다. 인바운드 흐름에서 사용될 경우 고객이 호출한 발신 번호입니다. 이 속성은 연락처 레코드에 포함됩니다. Lambda 함수에서 사용하는 경우 아래의 입력 객체에 포함됩니다. CustomerEndpoint.

시스템

$.CustomerEndpoint.주소

고객 ID

고객의 식별 번호.

시스템

$.CustomerId

전화를 건 번호

고객이 고객 센터를 호출하기 위해 전화를 건 번호입니다.

이 속성은 연락처 레코드에 포함됩니다. Lambda 함수에서 사용하는 경우 아래의 입력 객체에 포함됩니다. SystemEndpoint.

시스템

$.SystemEndpoint.주소

고객 콜백 번호

Amazon Connect 커넥트가 고객에게 콜백하기 위해 사용하는 번호입니다.

이 번호는 대기 중인 콜백에 사용하거나 상담원이 CCP에서 전화를 걸 때 사용할 수 있습니다. 콜백 대기열 기능으로 전송하거나 CCP에서 전화를 거는 에이전트를 위해 전송합니다.

기본값은 고객이 고객 센터에 전화하는 데 사용한 번호입니다. 하지만 를 사용하여 덮어쓸 수 있습니다.콜백 번호 설정블록.

이 속성은 연락처 레코드에 포함되지 않으며 Lambda 입력에서 액세스할 수 없습니다. 그러나 연락처 레코드에 포함된 연락처 속성 설정 블록을 사용하여 해당 속성을 사용자 정의 속성에 복사할 수 있습니다. 이 속성을 Invoke에서 Lambda 입력 파라미터로 전달할 수도 있습니다.AWSLambda 함수 블록은 연락처 레코드에 포함되지 않습니다.

시스템

해당 사항 없음

저장된 고객 입력

고객 입력 저장 블록의 가장 최근 호출에서 생성된 속성입니다.

가장 최근의 고객 입력 저장 블록 호출에서 생성된 속성 값입니다. 이 속성은 연락처 레코드에 포함되지 않으며 Lambda 입력에서 액세스할 수 없습니다. 연락처 기록에 포함된 연락처 속성 설정 블록을 사용하여 해당 속성을 사용자 정의 속성에 복사할 수 있습니다. 이 속성을 Invoke에서 Lambda 입력 파라미터로 전달할 수도 있습니다.AWSLambda 함수 블록,

시스템

해당 사항 없음

대기열 이름

대기열의 이름입니다.

시스템

$.Queue.Name

대기열 ARN

대기열의 ARN입니다.

시스템

$.Queue.ARN

대기열 아웃바운드 번호

선택한 대기열의 아웃바운드 발신자 ID 번호입니다. 이 속성은 아웃바운드 귓속말 흐름에서만 사용할 수 있습니다.

시스템

텍스트 투 스피치 음성

사용하려는 Amazon Polly 음성의 이름입니다. text-to-speech 고객 응대 흐름에서

시스템

$.TextToSpeechVoiceId

연락처 ID

연락처의 고유 식별자입니다.

시스템

$.ContactId

초기 연락처 ID

고객과 고객 센터 간의 첫 번째 상호 작용과 연관된 연락처의 고유 식별자입니다. 초기 연락처 ID를 사용하여 흐름 간에 연락처를 추적합니다.

시스템

$.InitialContactId

작업 연락처 ID

작업 연락처의 고유 별자입니다. 작업 연락처 ID를 사용하여 흐름 간 작업을 추적합니다.

시스템

$. 태스크.ContactId

이전 연락처 ID

전송하기 전 연락처의 고유 식별자입니다. 이전 연락처 ID를 사용하여 흐름 간에 연락처를 추적합니다.

시스템

$.PreviousContactId

Channel

고객 센터와 연락하는 데 사용되는 방법: 음성, 채팅, 작업.

시스템

$.Channel

인스턴스 ARN

Amazon Connect 인스턴스의 ARN입니다.

시스템

$.InstanceARN

시작 방법

고객 응대가 시작된 방법입니다. 유효한 값으로는 다음이 포함됩니다. 인바운드, 아웃바운드, 전송, 콜백, 대기열_전송, 연결 해제 및 API.

시작 메서드는 에이전트 위스퍼 흐름 또는 고객 위스퍼 흐름에서 작동하지 않습니다.

시스템

$.InitiationMethod

이름

작업의 이름입니다.

시스템

$. 이름

설명

작업에 대한 설명입니다.

시스템

$. 설명

참조

연락처와 관련된 다른 문서에 대한 링크.

시스템

$. 참고 문헌.ReferenceKey.값 및 $. 참조.ReferenceKey.어디에 입력하세요ReferenceKey는 사용자 정의 참조 이름입니다.

언어

콘텐츠의 언어입니다.

표준 java.util.로케일을 사용하십시오. 예: 미국 영어는 en-US, 일본어는 Jp-jp 등이 이에 해당합니다.

시스템

$.LanguageCode

시스템 종단점 유형

시스템 엔드포인트의 유형입니다. 유효한 값은 TELEPHONE_NUMBER입니다.

시스템

$.SystemEndpoint.유형

고객 엔드포인트 유형

고객 엔드포인트의 유형입니다. 유효한 값은 TELEPHONE_NUMBER입니다.

시스템

$.CustomerEndpoint.유형

대기열 아웃바운드 호출자 ID 번호

대기열에 대해 정의된 아웃바운드 호출자 ID 번호입니다. 이는 사용자 지정 호출자 ID를 설정한 후 호출자 ID를 되돌리는 데 유용할 수 있습니다.

시스템

$. 큐.OutboundCallerId.주소

대기열 아웃바운드 호출자 ID 번호 유형

아웃바운드 호출자 ID 번호 유형입니다. 유효한 값은 TELEPHONE_NUMBER입니다.

시스템

$. 큐.OutboundCallerId.유형

에이전트 속성

다음 표에는 Amazon Connect Connect에서 사용할 수 있는 에이전트 속성이 나열되어 있습니다.

속성 설명 유형 JSONPath 참조

에이전트 사용자 이름

에이전트가 Amazon Connect Connect에 로그인하는 데 사용하는 사용자 이름입니다.

시스템

$. 에이전트.UserName

에이전트 이름

에이전트의 이름은 Amazon Connect 사용자 계정에 입력된 에이전트의 이름입니다.

시스템

$. 에이전트.FirstName

에이전트 이름(성)

에이전트의 이름 (성) 은 Amazon Connect 사용자 계정에 입력된 에이전트의 이름입니다.

시스템

$. 에이전트.LastName

에이전트 ARN

에이전트의 ARN입니다.

시스템

$.Agent.ARN

참고

상담원 연락처 속성을 사용하는 경우에이전트로 전송flow, 에이전트 속성은 전송을 시작한 에이전트가 아니라 대상 에이전트를 반영합니다.

에이전트 속성은 다음 유형의 흐름에서만 사용할 수 있습니다.

  • 에이전트 귓속말

  • 고객 귓속말

  • 에이전트 대기

  • 고객 귓속말

  • 아웃바운드 귓속말

  • 에이전트로 전송 이 경우 에이전트 속성은 전송을 시작한 에이전트가 아니라 대상 에이전트를 반영합니다.

에이전트 속성은 다음 유형의 흐름에서는 사용할 수 없습니다.

  • 고객 대기열

  • 대기열로 전송

  • 인바운드 흐름

대기열 속성

이러한 시스템 속성은 를 사용할 때 반환됩니다.Get queue metrics(대기열 지표 가져오기)흐름을 차단하세요.

고객 센터에 현재 활동이 없는 경우 이러한 속성에 대해 null 값이 반환됩니다.

속성 설명 유형 JSONPath 참조

대기열 이름

지표를 검색한 대기열의 이름입니다.

시스템

$.Metrics.Queue.Name

대기열 ARN

지표를 검색한 대기열의 ARN입니다.

시스템

$.Metrics.Queue.ARN

대기열의 연락처

현재 대기열의 연락처 수입니다.

시스템

$.Metrics.Queue.Size

대기열에서 가장 오래된 연락처

대기열에서 가장 오래된 연락처가 대기열에 있었던 시간(초)입니다.

시스템

$. 지표. 큐.OldestContactAge

에이전트 온라인

현재 온라인 상태, 즉 로그인하여 오프라인이 아닌 다른 상태인 에이전트 수입니다.

시스템

$.Metrics.Agents.Online.Count

사용 가능한 에이전트

상태가 사용 가능으로 설정된 에이전트 수입니다.

시스템

$.Metrics.Agents.Available.Count

인력이 제공된 에이전트

현재 인력으로 제공된, 즉 로그인하여 사용 가능, ACW 또는 통화 중 상태인 에이전트 수입니다.

시스템

$.Metrics.Agents.Staffed.Count

Agents in After contact work(연락처 작업 후 상태의 에이전트)

현재 ACW 상태인 에이전트 수입니다.

시스템

$. 지표. 에이전트.AfterContactWork. 개수

에이전트 사용 중

연락처에 대해 현재 활성화된 에이전트 수입니다.

시스템

$.Metrics.Agents.Busy.Count

Agents missed count(누락된 에이전트 수)

누락됨 상태(에이전트가 누락된 고객 응대 후 되는 상태)의 에이전트 수입니다.

시스템

$.Metrics.Agents.Missed.Count

Agents in non-productive state(비 프로덕션 상태의 에이전트)

현재 NPT(비 프로덕션) 상태인 에이전트 수입니다.

시스템

$. 지표. 에이전트.NonProductive. 개수

텔레포니 호출 메타데이터 속성 (호출 속성)

전화 통신 메타데이터는 전화 통신 사업자의 통화 발생과 관련된 추가 정보를 제공합니다.

속성

설명

유형

JSONPath 참조

P-Asserted-Identity

최종 사용자의 소스.

시스템

$.Media.Sip.Headers.P-Asserted-Identity

P-Charge-Info

통화 관련 요금에 책임이 있는 당사자입니다.

시스템

$.Media.Sip.Headers.P-Charge-Info

From

요청 관련 최종 사용자의 자격 증명입니다.

시스템

$.Media.Sip.Headers.From

To

전화를 받은 당사자 또는 요청 수신자에 대한 정보입니다.

시스템

$.Media.Sip.Headers.To

수프-올리

발신선 표시기 (OLI). 회선 연결 통화 유형 (예: PSTN, 800 서비스 통화, 무선/셀룰러 PC, 공중전화) 을 표시합니다.

시스템

$.media.sip.헤더. iSUP-OLI

지프

관할권 표시 매개변수 (JIP). 발신자/스위치의 지리적 위치를 나타냅니다.

예제 값: 212555

시스템

$.미디어.sip.헤더.jip

홉 카운터

홉 카운터.

예제 값: 0

시스템

$.Media.Sip.헤더. 홉 카운터

오리진-스위치

시작 스위치입니다.

예제 값: 710

시스템

$.Media.Sip. 헤더. 오리진 스위치

오리진 트렁크

오리진의 트렁크.

예제 값: 0235

시스템

$.Media.Sip.헤더. 오리진 트렁크

착신 전환 표시기

착신 전환 표시기 (예: 전환 헤더). 국내 또는 국제 전화 발신자를 표시합니다.

예제 값: 건너뛰기: + 15555555555@public-vip.us2.telphony-provider.com; 이유=무조건

시스템

$.Media.Sip.헤더. 콜 포워딩 표시기

발신자 주소

발신자 주소 (번호). NPAC 딥은 트루 라인 타입과 네이티브 지리적 전환을 보여줍니다.

예제 값: 15555555555, 아니오=4

시스템

$.Media.Sip.헤더. 콜링 파티 주소

발신자 주소

발신자 주소 (번호).

예제 값: 15555555555, 아니오=4

시스템

$.Media.Sip.헤더. 발신자 주소

참고

전화 통신 메타데이터의 가용성은 모든 전화 통신 공급자에서 일관되지 않으며 모든 경우에 사용할 수 있는 것은 아닙니다. 이로 인해 빈 값이 발생할 수 있습니다.

미디어 스트림 속성

라이브 미디어 스트림에서 고객의 오디오가 시작되고 멈추는 지점을 파악하기 위해 사용할 수 있는 속성이 아래 표에 나열되어 있습니다.

속성

설명

유형

JSONPath 참조

고객 오디오 스트림 ARN

참조할 고객 데이터가 포함된 라이브 미디어 스트리밍에 사용되는 Kinesis Video 스트림의 ARN입니다.

미디어 스트림

$.MediaStreams. 고객. 오디오. 스트림 ARN

라이브 미디어 스트리밍에 사용되는 Kinesis 비디오 스트림의 고객 오디오 시작 타임스탬프

고객 오디오 스트림이 시작된 시간입니다.

미디어 스트림

$.MediaStreams.고객. 오디오.StartTimestamp

고객 오디오 중지 타임스탬프

고객 오디오 스트림이 라이브 미디어 스트리밍에 사용되는 Kinesis 비디오 스트림을 중지한 시간입니다.

미디어 스트림

$.MediaStreams.고객. 오디오.StopTimestamp

고객 오디오 시작 조각 번호

라이브 미디어 스트리밍에 사용되는 스트림에서 고객 오디오 스트림이 시작된 Kinesis Video Streams 조각을 식별하는 번호입니다.

미디어 스트림

$.MediaStreams.고객. 오디오.StartFragmentNumber

Amazon Lex 연락처 속성

다음 표에는 Amazon Lex 봇에서 반환되는 속성이 나열되어 있습니다.

속성 설명 유형 JSONPath 참조

대체 의도

Amazon Lex에서 사용할 수 있는 대체 인텐트 목록입니다. 각 인텐트에는 해당하는 신뢰도 점수와 채울 슬롯이 있습니다.

Lex

$.Lex.AlternateIntents.x.IntentName

$.Lex.AlternateIntents.x.IntentConfidence

$.Lex.AlternateIntents.x. 슬롯

$.Lex.AlternateIntents.. y.IntentName

$.Lex.AlternateIntents.. y.IntentConfidence

$.Lex.AlternateIntentsY. 슬롯

$.Lex.AlternateIntents.z.IntentName

$.Lex.AlternateIntents.z.IntentConfidence

$.Lex.AlternateIntents.Z. 슬롯

의도 신뢰도 점수

Amazon Lex에서 반환한 의도 신뢰도 점수입니다.

Lex

$.Lex.IntentConfidence.점수

이벤트 이름

Amazon Lex 에서 반환된 사용자 의도입니다.

Lex

$.Lex.IntentName

감정 레이블

Amazon Comprehend 가장 신뢰도가 높은 것으로 추정된 감정입니다.

Lex

$.Lex.SentimentResponse. 레이블

감정 점수

감정이 올바르게 추론되었을 가능성.

Lex

$.Lex.SentimentResponse. 점수. 긍정적

$.Lex.SentimentResponse. 점수. 부정적

$.Lex.SentimentResponse. 점수. 혼성

$.Lex.SentimentResponse. 점수. 중립

세션 속성

세션 고유의 컨텍스트 정보를 나타내는 키-값 페어의 맵입니다.

Lex

$.Lex.SessionAttributes. 속성 키

슬롯

Amazon Lex가 상호 작용 중 사용자 입력에서 감지한 의도 슬롯 맵 (키/값 페어) 입니다.

Lex

$.Lex.Slots.slotName

대화 상자 상태

Amazon Lex 봇에서 반환된 마지막 대화 상자 상태입니다. 의도가 흐름으로 반환된 경우 값은 'Fulfilled'입니다.

N/A (UI에 어떤 유형도 나타나지 않음)

$.Lex.DialogState

케이스 연락처 속성 (미리 보기)

다음 표에는 Amazon Connect 케이스와 함께 사용되는 속성이 나열되어 있습니다.

속성 설명 유형 JSONPath 참조 데이터의 출처

사례 ID

UUID 형식의 사례의 고유 식별자 (예: 689b0bea-aa29-4340-896d-4ca3ce9b6226) text

$.케이스.케이스_ID

Amazon Connect

사례 사유

케이스를 여는 이유

단일 선택

$.케이스. 케이스_이유 Agent

고객

API는 고객 프로필 ID입니다. 온 더사례: 필드페이지에서 고객 이름이 표시됩니다.

text

$.케이스. 고객_ID Amazon Connect

날짜/시간

케이스가 마지막으로 종결된 날짜 및 시간입니다. 케이스가 종결되었다고 보장하지는 않습니다. 케이스가 재개되면 이 필드에는 상태가 종결로 변경된 마지막 시간의 날짜/시간 스탬프가 포함됩니다.

날짜-시간

$.case. 마지막_마감_날짜/시간 Amazon Connect

열린 날짜/시간

케이스를 연 날짜와 시간

날짜-시간

$.case. 생성됨_날짜/시간 Amazon Connect

날짜/시간 업데이트

케이스가 마지막으로 업데이트된 날짜 및 시간입니다.

날짜-시간

$.case. 마지막_업데이트됨_날짜/시간 Amazon Connect

참조 번호

8자리 숫자 형식의 케이스에 적합한 번호입니다.

참조 번호 (케이스 ID와 달리) 는 고유한 것으로 보장되지 않습니다. 고객을 식별한 다음 참조 번호를 수집하여 올바른 사례를 정확하게 찾는 것이 좋습니다.

text

$. 케이스. 참조_번호 Agent

상태

사례의 현재 상태

text

$. 케이스. 상태 Agent

요약

사례 요약

text

$. 사례. 요약 Agent

제목

사례 제목

text

$. 케이스. 제목 Agent

Lambda 연락처 속성

Lambda 속성은 의 가장 최근 호출에서 키-값 페어로 반환됩니다.InvokeAWS Lambda기능블록. 외부 속성은 Lambda 함수를 호출할 때마다 덮어쓰기됩니다.

JSONPath에서 외부 특성을 참조하려면 다음을 사용하십시오.

  • $.External.attributeName

여기서AttributeName는 속성 이름이거나 함수에서 반환된 키-값 페어의 키입니다.

예를 들어 함수가 연락처 ID를 반환하면 다음과 같이 속성을 참조합니다. $.External.ContactId. Amazon Connect 커넥트에서 반환된 연락처 ID를 참조할 때 JSONPath는 다음과 같습니다.$.ContactId.

참고

다음 항목이 포함되어 있는지 확인하십시오..External의 속성이 Amazon Connect 외부에 있는 경우 JSONPath 참조에서 사용할 수 있습니다. 외부 소스에서 반환된 속성 이름의 대/소문자가 일치하는지 확인합니다.

Lambda 함수에서 속성을 사용하는 방법에 대한 자세한 내용은 단원을 참조하십시오.AWS Lambda 함수 호출.

이러한 속성은 연락처 레코드에 포함되지 않으며, 다음 Lambda 호출에 전달되거나, 스크린팝 정보를 위해 CCP에 전달되지 않습니다. 하지만 다음과 같은 Lambda 함수 입력으로 전달할 수 있습니다.InvokeAWS Lambda기능블록 또는 를 통해 사용자 정의 속성에 복사연락처 속성 설정블록. 사용 시연락처 속성 설정블록, 복사한 속성은 연락처 레코드에 포함되며 CCP에서 사용할 수 있습니다.

사용자 정의 속성

다른 모든 속성에 대해서는 Amazon Connect Connect가 키와 값을 정의합니다. 하지만 사용자 정의 속성의 경우 키와 값의 이름을 제공합니다.

통화 흐름에 값을 저장하려는 상황에서는 사용자 정의 속성을 사용하고 나중에 해당 값을 참조하십시오. 예를 들어 Amazon Connect Connect와 CRM 또는 기타 시스템을 통합하는 경우 고객으로부터 회원 번호와 같은 입력을 받고 싶을 수 있습니다. 그런 다음 해당 회원 번호를 사용하여 CRM에서 회원에 대한 정보를 검색하거나 흐름 전반에 걸쳐 회원 번호를 사용할 수 있습니다.

속성

설명

유형

JSONPath 참조

원하는 이름

사용자 정의 속성의 두 가지 부분은 다음과 같습니다.

  • 대상 키: 이 키는 사용자가 선택한 모든 이름입니다. 그러나,$.(마침표) 문자는 모두 JSONPath에서 속성 경로를 정의하는 데 사용되므로 사용할 수 없습니다.

  • 값: 이 값은 선택하는 임의의 값일 수 있습니다. 원하는 경우 여러 문단 분량의 텍스트를 입력할 수 있습니다! (의 경우연락처 레코드 속성 섹션의 최대 크기, 참조기능 사양.)

사용자 정의

$. 속성.이름_당신_목적지_키

사용자 정의 속성을 만들려면 을 사용합니다.연락처 속성 설정블록.

비즈니스용 Apple 메시지 특성

다음 연락처 특성을 사용하여 Apple Business Chat 고객을 라우팅할 수 있습니다. 예를 들어 Apple Business Chat을 사용하는 비즈니스 라인이 서로 다르면 다음을 기반으로 서로 다른 흐름으로 분기할 수 있습니다. AppleBusinessChatGroup 연락처 속성 또는 Apple Business Chat 메시지를 다른 채팅 메시지와 다르게 라우팅하려는 경우 다음을 기준으로 브랜치할 수 있습니다. MessagingPlatform.

속성 설명 유형 JSON

MessagingPlatform

고객 요청이 시작된 메시징 플랫폼.

정확한 값:AppleBusinessChat

사용자 정의 $. 속성.MessagingPlatform

AppleBusinessChatCustomerId

Apple에서 제공한 고객의 불투명 ID입니다. 이는 AppleID 및 기업에서 동일하게 유지됩니다. 이를 사용하여 메시지가 신규 고객인지 재방문 고객인지 식별할 수 있습니다.

사용자 정의 $. 속성.AppleBusinessChatCustomerId

AppleBusinessChatIntent

채팅의 의도 또는 목적을 정의할 수 있습니다. 이 매개 변수는 고객이 다음을 선택할 때 메시지에서 채팅 세션을 시작하는 URL에 포함됩니다.비즈니스 채팅단추.

사용자 정의 $. 속성.AppleBusinessChatIntent

AppleBusinessChatGroup

고객의 특정 질문이나 문제를 처리하기에 가장 적합한 부서 또는 개인을 지정하는 그룹을 정의합니다. 이 매개 변수는 고객이 다음을 선택할 때 메시지에서 채팅 세션을 시작하는 URL에 포함됩니다.비즈니스 채팅단추.

사용자 정의 $. 속성.AppleBusinessChatGroup

AppleBusinessChatLocale

언어를 정의하고AWS사용자가 사용자 인터페이스에서 보길 원하는 지역 환경설정입니다. 언어 식별자 (ISO 639-1) 와 지역 식별자 (ISO 3166) 로 구성됩니다. 예,ko_KR.

사용자 정의 $. 속성.AppleBusinessChatLocale

고객 프로필 속성

다음 연락처 속성을 사용하면 선택한 값을 사용하여 상담원 앱의 고객 프로필을 자동으로 채울 수 있습니다.

속성

설명

유형

JSONPath 참조

profileSearchKey

두 부분으로 구성된 사용자 정의 속성:

  • 대상 키: 이 키는 사용자가 선택한 모든 이름입니다. 그러나,$.(마침표) 문자는 모두 JSONPath에서 속성 경로를 정의하는 데 사용되므로 사용할 수 없습니다.

  • 값: 이 값은 선택하는 임의의 값일 수 있습니다. 원하는 경우 여러 문단 분량의 텍스트를 입력할 수 있습니다! (의 경우연락처 레코드 속성 섹션의 최대 크기, 참조기능 사양.)

사용자 정의

$. 속성.이름_당신_목적지_키