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

# Amazon Connect のフローブロック: コンタクト属性の設定
<a name="set-contact-attributes"></a>

このトピックでは、キーと値のペアをコンタクト属性として保存し、後でフローで参照される値を設定するためのフローブロックを定義します。

## 説明
<a name="set-contact-attributes-description"></a>

キーと値のペアをコンタクト属性として保存します。後からフローで参照する値を設定します。

例えば、顧客アカウントのタイプに基づいてキューにルーティングされる顧客にパーソナライズした挨拶を作成します。会社名または基幹業務の属性を定義して、顧客に発話されるテキスト読み上げの文字列に含めることもできます。

**[問い合わせ属性の設定]** ブロックは、例えば、外部ソースから取得した属性をユーザー定義属性にコピーするのに役立ちます。

問い合わせ属性の詳細については、「[Amazon Connect で問い合わせ属性を使用する](connect-contact-attributes.md)」を参照してください。

## サポートされるチャネル
<a name="set-contact-attributes-channels"></a>

次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。


| [チャネル] | サポート対象? | 
| --- | --- | 
| 音声 | はい | 
| Chat | はい | 
| タスク | はい | 
| E メール | はい | 

## フロータイプ
<a name="set-contact-attributes-types"></a>

このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ すべてのフロー

## プロパティ
<a name="set-contact-attributes-properties"></a>

次の画像は、**[コンタクト属性の設定]** ブロックの **[プロパティ]** ページを示しています。**greetingPlayed** キーと値を **true** に設定して、**[現在の問い合わせ]** にユーザー定義属性を設定するように設定されています。

![\[[コンタクト属性の設定] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-contact-attributes-properties.png)


以下の項目について属性を設定できます。
+ **[現在の問い合わせ]**: 属性は、このフローが実行されている問い合わせに対して設定されます。属性には、他のフロー、モジュール、Lambda、問い合わせレコード、GetMetricDataV2 API など、Amazon Connect の他の領域からアクセスできます。
+ **[関連する問い合わせ]**: 属性は、元の問い合わせプロパティのコピーを含む新しい問い合わせに関連付けられます。

  問い合わせレコードでは、これは **RelatedContactId** です。
+ **[フロー]**: 属性は、設定されているフローに制限されます。

  フロー属性は、顧客のクレジットカード番号などの機密情報を使用して Lambda のデータディップを行う必要がある場合など、問い合わせ全体にわたってデータを保持したくない場合に役立ちます。
  + フロー属性は、ローカルに保存され、フローでのみ使用される一時変数です。問い合わせが別のフローに転送されても、フローの外側では見えません。
  + 最大サイズは 32 KB (コンタクトレコード属性セクションの最大サイズ) です。
  + **[ AWS  Lambda 関数の呼び出し]** ブロックで **[パラメータを追加]** を選択することによって、パラメータとして明示的に設定されない限り、Lambda には渡されません。
  + モジュールには渡されません。モジュール内でフロー属性を設定することはできますが、モジュールから渡されることはありません。
  + 問い合わせレコードには表示されません。
  + CCP のエージェントには表示されません。
  + `GetContactAttributes` API で公開することはできません。
  + フローでロギングを有効にしている場合、キーと値が Cloudwatch ログに表示されます。

## 属性を参照する方法
<a name="set-contact-attributes-how-to-reference"></a>
+ 各属性の JSON 構文については、「[Amazon Connect で使用可能なコンタクト属性とその JSONPath 参照のリスト](connect-attrib-list.md)」を参照してください。。
+ スペースなど、名前に特殊文字を含む属性を参照するには、属性名を角カッコと一重引用符で囲みます。例: ` $.Attributes.['user attribute name']`。
+ システム属性など、同じ名前空間の属性を参照するには、属性名、または [**宛先キー**] として指定した名前を使用します。
+ 外部属性の参照など、別の名前空間の値を参照するには、属性に JSONPath 構文を指定します。
+ 問い合わせ属性を使用して、その他のリソースにアクセスするには、フローでユーザー定義属性を設定し、属性の値としてアクセスするリソースの Amazon リソースネーム (ARN) を使用します。

### Lambda での例
<a name="set-contact-attributes-lambda-examples"></a>
+ Lambda 関数ルックアップから顧客名を参照する場合は、\$1.External.AttributeKey を使用します。この際、AttributeKey を Lambda 関数から返された属性のキー (または名前) に置き換えます。
+ Amazon Connect プロンプトを Lambda 関数で使用するには、ユーザー定義の属性をプロンプトの ARN に設定した上で、Lambda 関数からその属性にアクセスします。

### Amazon Lex での例
<a name="set-contact-attributes-lex-examples"></a>
+ Amazon Lex ボットから属性を参照するには、参照する Amazon Lex ボットの一部を形式 \$1.Lex. に含めて (\$1.Lex.IntentName などとして) 使用します。
+ 顧客からの Amazon Lex ボットスロットへの入力を参照するには、\$1.Lex.Slots.*slotName* を使用します。この際、*slotName* はボットのスロット名と置き換えます。

## 属性が 32 KB を上回る場合に起きること
<a name="set-contact-attributes-space"></a>

属性のサイズ上限は 32 KB (コンタクトレコード属性セクションの最大サイズ) です。コンタクトの属性が 32 KB を上回ると、そのコンタクトは **[エラー]** ブランチにルーティングされます。対策として、次の選択肢を検討してください。
+ 不要な属性は値を空にして削除する。
+ 属性が 1 つのフローでのみ使用されていて、そのフローの外部 (例えば、Lambda や別のフロー) から参照する必要がない場合は、フロー属性を使用する。この方法なら、複数のフロー間で 32 KB 分の情報を無駄に保持する事態を避けられます。

## 設定のヒント
<a name="set-contact-attributes-tips"></a>
+ ユーザー定義の宛先キーを使用する場合は、任意の名前を付けることができますが、**\$1** および **.** (ピリオド) 文字は使用できません。どちらも JSONPath の属性パスを定義するために使用されるため、使用できません。
+ Amazon Lex V2 ボットに必要な言語属性は、**[Set contact attribute]** (コンタクト属性の設定) ブロックを使用して設定することができます。(Amazon Connect の言語属性は、Amazon Lex V2 ボットの構築に使用した言語モデルと一致している必要があります。) 次の画像は、スペイン語に設定された言語属性を示しています。  
![\[[コンタクト属性の設定] ブロックの [プロパティ] ページ、[値] が [スペイン語] に設定されています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-contact-attributes-language.png)

  あるいは、[音声の設定](set-voice.md) ブロックを使用して、Amazon Lex V2 ボットに必要な言語を設定することもできます。

問い合わせ属性の使用方法の詳細については、「[Amazon Connect で問い合わせ属性を使用する](connect-contact-attributes.md)」を参照してください。

## 設定されているブロック
<a name="set-contact-attributes-configured"></a>

次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** の 2 つのブランチがあります。

![\[設定された [コンタクト属性の設定] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-contact-attributes-configured.png)


## サンプルフロー
<a name="set-contact-attributes-samples"></a>

Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
+ [Amazon Connect に含まれる最初のコンタクトエクスペリエンスの着信フローのサンプル](sample-inbound-flow.md)

## シナリオ
<a name="set-contact-attributes-scenarios"></a>

このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [Amazon Connect で問い合わせ属性を参照する方法](how-to-reference-attributes.md)