채팅이 시작될 때 고객 응대 제어판(CCP)의 에이전트에게 고객 응대 속성 전달 - Amazon Connect
커뮤니케이션 위젯에 연락 속성을 전달하는 방법대체 방법: 스니펫 코드에서 직접 연락 속성 전달알아야 할 내용

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

채팅이 시작될 때 고객 응대 제어판(CCP)의 에이전트에게 고객 응대 속성 전달

연락 속성을 사용하여 커뮤니케이션 위젯을 사용하는 연락에 대한 정보를 캡처할 수 있습니다. 그런 다음 Contact Control Panel(CCP)을 통해 에이전트에 해당 정보를 표시하거나 흐름의 다른 곳에서 사용할 수 있습니다.

예를 들어 환영 메시지에서 고객의 이름을 말하도록 플로우를 사용자 지정할 수 있습니다. 또는 계정/멤버 , 이름 및 이메일과 같은 IDs고객 식별자 또는 연락처와 연결된 기타 메타데이터와 같은 비즈니스별 속성을 사용할 수 있습니다.

커뮤니케이션 위젯에 연락 속성을 전달하는 방법

  1. 아직 활성화하지 않았다면 Amazon Connect에서 호스팅하는 웹 사이트에 채팅 사용자 인터페이스 추가에 설명된 대로 커뮤니케이션 위젯에서 보안을 활성화합니다.

    1. 2단계의 채팅 위젯에 보안 추가에서 예를 선택합니다.

    2. 3단계에서는 보안 키를 사용하여 JSON 웹 토큰을 생성합니다.

  2. 의 페이로드에 고객 응대 속성을 attributes 클레임JWT으로 추가합니다.

    다음은 Python에서 연락처 속성을 JWT 사용하여 를 생성하는 방법의 예입니다.

    참고

    JWT 를 사전 조건으로 설치해야 합니다. 설치하려면 터미널pip install PyJWT에서 를 실행합니다.

    import jwt 
import datetime 
CONNECT_SECRET = "your-securely-stored-jwt-secret" 
WIDGET_ID = "widget-id" 
JWT_EXP_DELTA_SECONDS = 500

payload = { 
'sub': WIDGET_ID, 
'iat': datetime.datetime.utcnow(), 
'exp': datetime.datetime.utcnow() + datetime.timedelta(seconds=JWT_EXP_DELTA_SECONDS), 
'segmentAttributes': {"connect:Subtype": {"ValueString" : "connect:Guide"}}, 'attributes': {"name": "Jane", "memberID": "123456789", "email": "Jane@example.com", "isPremiumUser": "true", "age": "45"} } 
header = { 'typ': "JWT", 'alg': 'HS256' } 
encoded_token = jwt.encode((payload), CONNECT_SECRET, algorithm="HS256", headers=header) // CONNECT_SECRET is the security key provided by Amazon Connect

    페이로드에서 객체를 값으로 사용하여 문자열 키 attributes(있는 그대로, 모두 소문자)을 만들어야 합니다. 해당 객체에는 string-to-string 키-값 페어가 있어야 합니다. 속성 중 하나라도 문자열이 아닌 다른 것이 전달되면 채팅이 시작되지 않습니다.

    연락 속성은 StartChatConnect 에서 설정한 제한 사항을 따라야 합니다API.

    • 키의 최소 길이는 1이어야 합니다.

    • 값의 최소 길이는 0일 수 있습니다.

필요에 따라 페이로드에서 SegmentAttributeValue 객체 맵에 segmentAttributes 문자열을 추가할 수 있습니다. 속성은 표준 Amazon Connect 속성입니다. 흐름에서 액세스할 수 있습니다. 연락 속성은 StartChatConnect 에서 설정한 제한을 따라야 합니다API.

대체 방법: 스니펫 코드에서 직접 연락 속성 전달

참고

  • 스니펫 코드는 전달되는 HostedWidget- 모든 연락 속성 키에 우선합니다. 다음 예제에서는 에이전트 측에 키 값 페어 가 표시됩니다HostedWidget-foo: 'bar'.

  • 이러한 속성은 HostedWidget- 접두사로 범위가 지정되지만 여전히 변경 가능한 클라이언트 사이트입니다. 고객 응대 흐름에 PII 또는 변경할 수 없는 데이터가 필요한 경우 JWT 설정을 사용합니다.

다음 예제에서는 위젯 보안을 활성화하지 않고 스니펫 코드에서 직접 연락처 속성을 전달하는 방법을 보여줍니다.

<script type="text/javascript">
  (function(w, d, x, id){ /* ... */ })(window, document, 'amazon_connect', 'widgetId');
  amazon_connect('snippetId', 'snippetId');
  amazon_connect('styles', /* ... */);
  // ...

  amazon_connect('contactAttributes', {
   foo: 'bar'
  })
<script/>

흐름에서 속성 사용

연락처 속성 확인 흐름 블록은 다음 이미지와 같이 사용자 정의 네임스페이스를 사용하여 이러한 속성에 대한 액세스를 제공합니다. 흐름 블록을 사용하여 브랜칭 로직을 추가할 수 있습니다. 전체 경로는 입니다$.Attributes.HostedWidget-attributeName.

유효한 프롬프트와 잘못된 프롬프트로 흐름 블록 분기를 보여주는 이미지입니다.

알아야 할 내용

  • 커뮤니케이션 위젯은 인코딩된 전체 토큰에 대해 6,144바이트 한도가 있습니다. JavaScript 는 UTF-16 인코딩을 사용하기 때문에 문자당 2바이트가 사용되므로 의 최대 크기는 약 3,000자여야 encoded_token 합니다.

  • encoded_token을 callback(data)에 전달해야 합니다. authenticate 조각은 추가로 변경할 필요가 없습니다. 예:

    amazon_connect('authenticate', function(callback) {
  window.fetch('/token').then(res => {
    res.json().then(data => {
      callback(data.data);
    });
  });
});

  • JWT 를 사용하여 연락 속성을 전달하면 데이터의 무결성이 보장됩니다. 공유된 비밀을 보호하고 적절한 보안 관행을 준수하면 악의적인 공격자가 데이터를 조작할 수 없도록 할 수 있습니다.

  • 연락처 속성은 암호화JWT되지 않고 에서만 인코딩되므로 속성을 디코딩하고 읽을 수 있습니다.

  • 시뮬레이션된 채팅 환경으로 채팅 환경을 테스트하고 고객 응대 속성을 포함하려면 다음 이미지와 같이 키와 값을 모두 따옴표로 묶어야 합니다.

    테스트 설정 페이지, 따옴표로 묶인 고객 응대 속성 키, 따옴표로 묶인 값.