本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 Amazon Connect 聊天开始时传递客户显示名称
<a name="pass-display-name-chat"></a>

要为客户和座席提供更加个性化的体验，您可以自定义 Amazon Connect 通信小部件，以便在联系初始化期间传递客户显示名称。在整个聊天互动过程中，客户和座席都可以看到该名称。此显示名称将记录在聊天记录中。

下图显示了客户在聊天体验中显示的名称，以及他们在座席的 CCP 中的名称。

![客户在聊天体验中的名称，座席的 CCP 中的客户名称。](http://docs.aws.amazon.com/zh_cn/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 个字符之间。
+ 空字符串、空或未定义是显示名称的无效输入。为了防止意外传递这些输入，小部件会在浏览器控制台中记录错误 `Invalid customerDisplayName provided`，然后使用默认显示名称**客户**开始聊天。
+ 由于该片段位于网站的前端，因此请勿将敏感数据作为显示名称传递。请务必遵循适当的安全措施，以确保您的数据安全，防范攻击和恶意行为。