翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Connect チャットの開始時に顧客の表示名を渡す
<a name="pass-display-name-chat"></a>

よりパーソナライズされたエクスペリエンスを顧客とエージェント双方に提供するために、コンタクトの初期化中に顧客の表示名を渡すように Amazon Connect コミュニケーションウィジェットをカスタマイズできます。この名前は、チャットのやり取りの間ずっと、顧客とエージェントの両方に表示されます。この表示名は、チャットのトランスクリプトに記録されます。

次の画像は、チャットエクスペリエンスでの顧客の表示名と、エージェントの CCP での名前を示しています。

![\[チャットエクスペリエンスでの顧客の名前、エージェントの CCP での顧客の名前。\]](http://docs.aws.amazon.com/ja_jp/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` 関数は 1 つだけです。
+ 顧客の表示名は、[StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html#connect-Type-ParticipantDetails-DisplayName) API によって設定された制限に従う必要があります。つまり、名前は 1～256 文字の文字列でなければなりません。
+ 空の文字列、null、または未定義は、表示名に対する無効な入力です。これらの入力が誤って渡されないようにするため、ウィジェットは「`Invalid customerDisplayName provided`」というエラーをブラウザコンソールでログに記録し、**[Customer]** (顧客) というデフォルトの表示名でチャットを開始します。
+ スニペットはウェブサイトのフロントエンドにあるため、機密データを表示名として渡さないでください。データを安全に保ち、攻撃や不正行為者から保護するために、適切なセキュリティのプラクティスに従うようにしてください。