채팅이 초기화될 때 고객 응대 속성 전달 - Amazon Connect
커뮤니케이션 위젯에 연락 속성을 전달하는 방법알아야 할 내용

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

채팅이 초기화될 때 고객 응대 속성 전달

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

예를 들어 환영 메시지에서 고객의 이름을 말하도록 플로우를 사용자 지정할 수 있습니다. 또는 계정/멤버 ID, 이름, 이메일 등의 고객 식별자, 고객 응대와 관련된 기타 메타데이터 등 비즈니스에 특정한 속성을 사용할 수 있습니다.

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

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

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

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

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

    다음은 Python에서 고객 응대 속성이 있는 JWT를 생성하는 방법이 나와 있는 예입니다.

    import jwt

CONNECT_SECRET = "your-securely-stored-jwt-secret"

payload = {
  'sub': 'widget-id',
  'iat': datetime.datetime.utcnow(),
  'exp': datetime.datetime.utcnow() + datetime.timedelta(seconds=500),
  '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)

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

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

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

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

알아야 할 내용

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

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

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

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

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

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

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