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

# Amazon Connect 채팅이 시작될 때 고객 표시 이름 전달
<a name="pass-display-name-chat"></a>

고객과 에이전트 모두에게 더욱 개인화된 경험을 제공하려면 연락을 초기화하는 동안 고객 표시 이름을 전달하도록 Amazon Connect 커뮤니케이션 위젯을 사용자 지정할 수 있습니다. 이름은 채팅 상호 작용 내내 고객과 에이전트 모두에게 표시됩니다. 이 표시 이름은 채팅 대화내용에 기록됩니다.

다음은 채팅 환경의 고객 표시 이름과 에이전트의 CCP에 있는 고객의 이름을 보여 주는 이미지입니다.

![\[채팅 환경의 고객 이름, 에이전트의 CCP에 있는 고객 이름.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/chatwidget-displayname.png)


1. 채팅 사용자 인터페이스를 사용하는 고객에게 고객 표시명이 표시되는 방식.

1. CCP를 사용하는 에이전트에게 고객 표시 이름이 표시되는 방식.

## 커뮤니케이션 위젯에서 고객 표시 이름을 전달하는 방법
<a name="setup-display-name"></a>

고객 표시 이름을 전달하려면 조각에 콜백 함수를 구현하세요. Amazon Connect는 표시 이름을 자동으로 검색합니다.

1. 아직 실행하지 않았다면, [Amazon Connect에서 호스팅하는 웹 사이트에 채팅 사용자 인터페이스 추가](add-chat-to-website.md)의 단계를 완료합니다.

1. 기존 위젯 조각을 보강하여 `customerDisplayName` 콜백을 추가합니다. 다음은 이를 보여 주는 예제입니다.

   ```
   amazon_connect('customerDisplayName', function(callback) {
     const displayName = 'Jane Doe';
     callback(displayName);
   });
   ```

   중요한 것은 `callback(name)`에 이름이 전달된다는 것입니다.

## 고객 표시 이름에 대해 알아야 할 사항
<a name="setup-display-name-important-notes"></a>
+ `customerDisplayName` 함수는 한 번에 하나만 존재할 수 있습니다.
+ 고객 표시 이름은 [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html#connect-Type-ParticipantDetails-DisplayName) API에서 설정한 제한 사항을 따라야 합니다. 즉, 이름은 1자에서 256자 사이의 문자열이어야 합니다.
+ 빈 문자열, null 또는 정의되지 않은 값은 표시 이름에 대한 잘못된 입력입니다. 이러한 입력이 실수로 전달되는 것을 방지하기 위해 위젯은 브라우저 콘솔에 제공된 잘못된 `Invalid customerDisplayName provided`이라는 오류를 기록한 다음 기본 표시 이름인 **고객**으로 채팅을 시작합니다.
+ 조각은 웹 사이트의 프런트엔드에 있으므로 민감한 데이터를 표시 이름으로 전달하지 마세요. 데이터를 안전하게 보호하고 공격 및 악의적인 행위자로부터 보호하기 위해 적절한 보안 관행을 따라야 합니다.