本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 Amazon Connect 聊天啟動時傳遞客戶顯示名稱
<a name="pass-display-name-chat"></a>

若要為您的客戶和客服人員提供更個人化的體驗，您可以自訂 Amazon Connect 通訊小工具，以便在聯絡人初始化期間傳遞客戶顯示名稱。在整個聊天互動過程中，客戶和客服人員都可以看到該名稱。此顯示名稱會記錄在聊天文字記錄中。

下圖顯示客戶在聊天體驗中的顯示名稱，以及客服人員 CCP 中的名字。

![客戶在聊天體驗中的名字，客戶在客服人員 CCP 中的名字。](http://docs.aws.amazon.com/zh_tw/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` 錯誤，然後使用預設的顯示名稱 **客戶** 來啟動聊天。
+ 由於程式碼片段位於網站的前端，因此請勿將敏感資料當做顯示名稱傳遞。請務必遵循適當的安全實務，以確保您的資料安全，並防止攻擊和不良行為者。