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

# Amazon Connect で問い合わせ属性を使用する
<a name="connect-contact-attributes"></a>

顧客に配慮を受けていることを実感させるための 1 つの方法は、コンタクトセンターを利用して、パーソナライズされたエクスペリエンスを作成し提供することです。例えば、電話を使用している顧客に対して 1 つのウェルカムメッセージを配信しながら、チャットを使用している顧客には、別のウェルカムメッセージを配信できます。これを行うには、問い合わせに関する情報を格納し、その値に基づいた決定を行うための手段が必要です。

**Topics**
+ [Amazon Connect での問い合わせ属性の仕組み](what-is-a-contact-attribute.md)
+ [Amazon Connect で使用可能なコンタクト属性とその JSONPath 参照のリスト](connect-attrib-list.md)
+ [Amazon Connect で問い合わせ属性を参照する方法](how-to-reference-attributes.md)
+ [コンタクトコントロールパネル (CCP) でエージェントに連絡先情報を表示する](use-attribs-ccp.md)
+ [Amazon Connect の属性を使用して、キュー内の問い合わせの数に基づいてルーティングする](attrib-system-metrics.md)
+ [コンタクトセンターへの問い合わせ方法に基づいて、問い合わせの経験をパーソナライズする](use-channel-contact-attribute.md)
+ [Amazon Lex と属性値を使用する](attribs-cust-input-lex-bot.md)
+ [Lambda 関数の値を Amazon Connect の問い合わせ属性として保存する](attribs-with-lambda.md)

# Amazon Connect での問い合わせ属性の仕組み
<a name="what-is-a-contact-attribute"></a>

Amazon Connect では、顧客とのやり取りはそれぞれ**コンタクト**として処理されます。やり取りには、音声通話、チャット、または Amazon Lex ボットを使用した自動的な対話があります。

各問い合わせは、特定のやり取りに固有の、いくつかのデータを保持することができます。このデータは、問い合わせ属性としてアクセスされます。例:
+ 顧客の名前。
+ エージェントの名前
+ 電話やチャットなど、問い合わせに使用されるチャネル

コンタクト属性では、キーと値のペアとしてこのデータが表されます。このフィールドは、そこに入力されたデータに付けられたフィールド名と捉えることもできます。

顧客名に対するキーと値のペアの例をいくつか示します。


| キー | 値 | 
| --- | --- | 
| firstname  | Jane  | 
| lastname  | Doe  | 

問い合わせ属性の利点は、問い合わせに関する一時的な情報を保存して、フロー内で使用できるようにすることにあります。

例えば、ウェルカムメッセージでは、相手の名前を挙げ、メンバーへの登録に謝意を表することができます。これを行うには、その特定の顧客に関するデータを取得し、フローで使用するための方法が必要です。

## 一般的なユースケース
<a name="contact-attribute-scenarios"></a>

ここでは、問い合わせ属性を使用するいくつかの一般的なユースケースを示します。
+ 顧客の電話番号を使用して、キューに登録された折り返し通話をスケジュールします。
+ 通話後の調査を問い合わせに関連付けることができるように、どのエージェントが顧客と対話しているかを特定します。
+ キュー内の問い合わせの数を確認し、問い合わせを別のキューにルーティングする必要があるかどうかを決定します。
+ 対応するメディアストリーミングの ARN を取得し、そのストリーミングをデータベースに格納します。
+ 顧客の電話番号を使用して、その顧客のステータス (メンバー登録済みかなど)、または注文のステータス (出荷済み、遅延、その他) を識別し、適切なキューにルーティングします。
+ 顧客とボットとの対話内容に基づいて、フローで使用するスロット (注文する花のタイプなど) を特定します。

## 問い合わせ属性のタイプ
<a name="types-of-contact-attributes"></a>

使用したい属性をすばやく見つけて選択できるように、属性は**タイプ**ごとにグループ化されています。各フローブロックでは、連動するタイプの属性のみが表示されます。

問い合わせ属性のタイプは、その値の提供元別に分類することでも確認できます。問い合わせ属性の値には、以下のソースがあります。
+ Amazon Connectは、問い合わせに関する対話中、エージェントの名前などの値を提供します。これは、実行時の値の提供と同じです。
+ Amazon Lex や などの外部プロセスが値 AWS Lambdaを提供します。
+ [ユーザー定義](connect-attrib-list.md#user-defined-attributes)。
  + コンタクト属性: フローにおいて、ユーザー定義済みの名前空間で属性の値を指定できます。
  + コンタクトセグメント属性: フローにおいて、セグメント属性の名前空間で属性の値を指定できます。また、コンタクトセグメント属性として割り当てる前に、属性を事前に定義する必要があります。手順については、「[コンタクトセグメント属性を使用する](use-contact-segment-attributes.md)」を参照してください。

  [フロー属性](connect-attrib-list.md#flow-attributes)は、ユーザー定義の属性に似ています。ただし、ユーザー定義の属性とは異なり、フロー属性は、設定されたフローに制限されます。

次の図は、使用可能なコンタクト属性のタイプを示し、それらを Amazon Connect、Amazon Lex などの外部プロセス、およびユーザー定義の 3 つの値のソースにマッピングしています。

![\[使用可能なコンタクト属性のタイプ、その値のソース。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/contact-attributes-types.png)


## 問い合わせレコードの問い合わせ属性
<a name="attributes-in-ctr"></a>

問い合わせレコード内の問い合わせ属性は、同じ InitialContactId を持つすべての問い合わせで共有されます。

例えば、転送の実行中にその転送フローで更新された問い合わせ属性により、2 つの問い合わせレコード (つまり、インバウンドと転送中の問い合わせ属性) の問い合わせ属性の値も更新されます。

## コンタクトレコードのコンタクトセグメント属性
<a name="segmentattributes-in-ctr"></a>

コンタクトレコードにおいて、コンタクトセグメント属性の値は個々の contactID に固有となります。同じ InitialContactId を持つコンタクトであっても、値が共有されることはありません。

例えば、転送を実行する際、転送フローで更新されるコンタクトセグメント属性により、新しいコンタクトレコード上のその属性の値が更新されます (つまり、転送のコンタクトセグメント属性が更新されます)。

## 「\$1」は特殊文字である
<a name="dollar-sign-special"></a>

Amazon Connect は「\$1」文字を特殊文字として扱います。属性を設定するときに、キーで使用することはできません。

 例えば、テキスト読み上げ機能を持つ対話ブロックを作成するとします。次のように属性を設定します。

 ` {"$one":"please read this text"} ` 

このテキストを、問い合わせのために Amazon Connect で読み上げると、「please read this text」ではなく「dollar sign one」となります。また、キーに \$1 を含めた後に Amazon Connect を使用して値を参照しようとしても、その値は取得されません。

Amazon Connect はログを記録し、Lambda などの統合に対しキーと値のペア全体 `({"_$one":"please read this text"})` を渡します。

## 属性が存在しない場合の処理
<a name="attribute-error"></a>

属性が存在せず問い合わせがエラーブランチにルーティングされる場合に処理すべきロジックを、必ず実装してください。

[顧客の入力の保存] ブロックに属性を追加するとしましょう。次の例に示すように、**[名前空間]** は **[エージェント]** で、**[キー]** は **[ユーザー名]** です。

![\[[顧客の入力の保存] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/contact-attributes-errorbranch.png)


フローが実行され、エージェントのユーザー名が使用できない場合、問い合わせはエラーブランチにルーティングされます。

# Amazon Connect で使用可能なコンタクト属性とその JSONPath 参照のリスト
<a name="connect-attrib-list"></a>

以下の表により、Amazon Connect で利用できる問い合わせ属性について説明します。

各属性の JSONPath 参照が提供されているため、それらを[動的なテキスト文字列の作成](create-dynamic-text-strings.md)に使用できます。

**Topics**
+ [システム属性](#attribs-system-table)
+ [セグメント属性](#attribs-segment-attributes)
+ [ビューの属性](#attribs-views)
+ [機能の属性](#attribs-capabilities)
+ [エージェントの属性](#attribs-agent)
+ [キュー属性](#attribs-system-metrics-table)
+ [問い合わせメトリクス属性](#attribs-contact-metrics-table)
+ [テレフォニー通話メタデータ属性 (通話属性)](#telephony-call-metadata-attributes)
+ [チャット初期メッセージ属性](#chat-initial-message-attributes)
+ [E メール属性](#email-attribs)
+ [メディアストリームの属性](#media-stream-attribs)
+ [Amazon Lex 問い合わせ属性](#attribs-lex-table)
+ [ケース問い合わせ属性](#attribs-case-table)
+ [Lambda での問い合わせ属性](#attribs-lambda-table)
+ [ユーザー定義の属性](#user-defined-attributes)
+ [フロー属性](#flow-attributes)
+ [ループ属性](#w2aac18c52b9c41)
+ [フローモジュールの属性](#flow-modules-attributes)
+ [データテーブルの属性](#data-table-attributes)
+ [Apple Messages for Business の属性](#apple-messages-for-business-attributes)
+ [Customer Profiles の属性](#customer-profiles-attributes)
+ [アウトバウンドキャンペーンの属性](#campaign-attributes)
+ [Connect AI エージェント属性](#qic-attributes)

## システム属性
<a name="attribs-system-table"></a>

これらは、Amazon Connect に定義済みの属性です。システム属性は参照できますが、作成することはできません。

フロー内のすべてのブロックがシステム属性を使用してサポートするわけではありません。例えば、顧客の入力を保存するためにシステム属性を使用することはできません。顧客が入力したデータを保存するには、[ユーザー定義の属性](#user-defined-attributes)を使用します。


| 属性 | 説明 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | 
| AWS リージョン | これを使用すると、問い合わせ AWS リージョン が処理されている が返されます。例えば、us-west-2、us-east-1 などです。 | システム | \$1.AwsRegion or \$1['AwsRegion'] | 
| 顧客のメールアドレスまたは電話番号 | 顧客の電話番号、または E メールチャネルを使用している場合は E メールアドレス。 音声通話、SMS、WhatsApp ビジネスメッセージング、E メールでサポートされています。 アウトバウンドウィスパーフローで使用する場合、これは顧客に連絡するためにエージェントがダイヤルした番号です。インバウンドフローで使用した場合、これは顧客が電話をかけた番号です。この属性は、問い合わせレコードに含まれています。これを Lambda 関数で使用する場合には、CustomerEndpoint にある入力オブジェクト内のものを使用します。 | システム | \$1.CustomerEndpoint.Address | 
| カスタマー ID | 顧客 ID 番号。例えば、CustomerId は、CRM からの顧客番号の場合もあります。CRM システムから発信者の一意の顧客 ID を取得するための Lambda 関数を作成できます。Voice ID は、この属性を発信者の `CustomerSpeakerId` として使用します。  | システム | \$1.CustomerId | 
| システムのアドレスまたは番号 | 音声通話、SMS、E メール、WhatsApp ビジネスメッセージングでサポートされています。 顧客がコンタクトセンターに電話をかけるためにダイヤルした番号、または E メールチャネルを使用している場合は顧客が E メールを送信した E メールアドレス。 この属性は、問い合わせレコードに含まれています。Lambda 関数で使用する場合には、SystemEndpoint にある入力オブジェクトに含まれています。 | システム | \$1.SystemEndpoint.Address | 
| 顧客の表示名 | コンタクトセンターに送信された E メールに表示される顧客の名前。 | システム | \$1.CustomerEndpoint.DisplayName | 
| システムの表示名 | 顧客が送信した E メールアドレスの表示名。 | システム | \$1.SystemEndpoint.DisplayName | 
| CC の E メールアドレスリスト | コンタクトセンターに送信されたインバウンド E メールの CC に含まれる E メールアドレスの完全なリスト。 | システム | \$1.AdditionalEmailRecipients.CcList | 
| To の E メールアドレスリスト | コンタクトセンターに送信されたインバウンド E メールの To に含まれる E メールアドレスの完全なリスト。 | システム | \$1.AdditionalEmailRecipients.ToList | 
| 顧客のコールバック番号 | Amazon Connect が、顧客に折り返し通話するために使用する電話番号。 この電話番号は、キューに登録された折り返し通話に使用される番号や、エージェントが CCP からダイヤルする際に使用される番号です。折り返し通話のキュー機能、または CCP からダイヤルするエージェントに対し転送します。 デフォルト値は、顧客がコンタクトセンターに連絡するために使用した番号です。ただしこの値は、[[コールバック番号を設定する](set-callback-number.md)] ブロックにより上書きが可能です。 この属性は問い合わせレコードに含まれず、Lambda 入力でアクセスすることもできません。ただしこの属性は、コンタクトレコードに含まれている [[コンタクト属性の設定](set-contact-attributes.md)] ブロックを使用してユーザー定義の属性にコピーできます。またこの属性は、コンタクトレコードに含まれていない [[AWS Lambda 関数](invoke-lambda-function-block.md)] ブロックで Lambda 入力パラメータとして渡すこともできます。  | システム | 該当なし | 
| 保存済みの顧客の入力 | [[顧客の入力を保存する](store-customer-input.md)] ブロックの直近の呼び出しで作成される属性。 この属性値は、[[顧客の入力を保存する](store-customer-input.md)] ブロックの直近の呼び出しで作成されたものです。この属性は問い合わせレコードに含まれず、Lambda 入力でもアクセスできません。この属性は、コンタクトレコードに含まれている [[コンタクト属性の設定](set-contact-attributes.md)] ブロックを使用してユーザー定義の属性にコピーできます。またこの属性は、[[AWS Lambda 関数](invoke-lambda-function-block.md)] ブロックに Lambda 入力パラメータとして渡すこともできます。  | システム | \$1.StoredCustomerInput | 
| キュー名 | キューの名前。 | システム | \$1.Queue.Name | 
| キュー ARN | キューの ARN。 | システム | \$1.Queue.ARN | 
| アウトバウンドの番号をキューに登録する | 選択されたキューへのアウトバウンド通話者 ID 番号の登録。この属性は、アウトバウンドのウィスパーフローでのみ使用可能です。 | システム |  | 
| テキスト読み上げの音声 | 問い合わせフローでテキスト読み上げ機能に使用する Amazon Polly 音声の名前。 | システム | \$1.TextToSpeechVoiceId | 
| 問い合わせ ID | 問い合わせの一意の識別子。 | システム | \$1.ContactId | 
| イニシャル問い合わせ ID | コンタクトのための (顧客とコンタクトセンターとの間で最初に行われた対話に関連付けられた) 一意の識別子。最初の問い合わせ ID を使用して、フロー間の問い合わせを追跡します。  | システム | \$1.InitialContactId | 
| タスク問い合わせ ID | タスク問い合わせの一意の識別子。タスク問い合わせ ID を使用して、フロー間の問い合わせを追跡します。  | システム | \$1.Task.ContactId | 
| 前の問い合わせ ID | 転送される前のコンタクトの一意の識別子。前の問い合わせ ID を使用して、フロー間の問い合わせを追跡します。 | システム | \$1.PreviousContactId | 
| チャネル | コンタクトセンターへのコンタクトに使用される手段 (VOICE、CHAT、TASK、または EMAIL)。 | システム | \$1.Channel | 
| インスタンス ARN | Amazon Connect インスタンスの ARN。 | システム | \$1.InstanceARN | 
| 開始メソッド | コンタクトが開始された方法。有効な値は、INBOUND、OUTBOUND、TRANSFER、CALLBACK、QUEUE\$1TRANSFER、EXTERNAL\$1OUTBOUND、MONITOR、DISCONNECT、WEBRTC\$1API、API です。  | システム | \$1.InitiationMethod | 
| 名前 | タスクの名前。 | システム | \$1.Name | 
| 説明 | タスクの説明。 | システム | \$1.Description | 
| リファレンス | 問い合わせに関連する他のドキュメントへのリンク。 | システム | \$1.References.*ReferenceKey*. 値と、\$1.References.*ReferenceKey*. タイプ。*ReferenceKey* はユーザー定義の参照名に置き換えます。 | 
| 言語 | コンテンツの言語。 標準の java.util.Locale を使用します。例えば、米国英語の場合は en-US、日本語の場合は ja-JP です。 | システム | \$1.LanguageCode | 
| システムエンドポイントタイプ | システムエンドポイントのタイプ。有効な値は TELEPHONE\$1NUMBER です。 | システム | \$1.SystemEndpoint.Type | 
| カスタマーエンドポイントタイプ | カスタマーエンドポイントのタイプ。有効な値は TELEPHONE\$1NUMBER です。 | システム | \$1.CustomerEndpoint.Type | 
| キューのアウトバウンド発信者 ID 番号 | アウトバウンド発信者 ID 番号はキューに対して定義されます。カスタム発信者 ID を設定した後に発信者 ID を復元するのに便利です。 | システム | \$1.Queue.OutboundCallerId.Address | 
| キューのアウトバウンド発信者 ID 番号タイプ | キューのアウトバウンド発信者 ID 番号のタイプ。有効な値は TELEPHONE\$1NUMBER です。 | システム | \$1.Queue.OutboundCallerId.Type | 
| タグ | このリソースの整理、追跡、またはアクセスの制御に使用されるタグ。タグの詳細については、「[Amazon Connect でリソースにタグを追加する](tagging.md)」と「[Amazon Connect の使用状況を詳細に表示する詳細な請求を設定する](granular-billing.md)」を参照してください。 | システム | \$1.Tags | 

## セグメント属性
<a name="attribs-segment-attributes"></a>

セグメント属性とは、属性マップを使用して個別のコンタクトのセグメントに保存されるシステム定義のキーと値のペアのセットです。ただし、次の表に示すように、ユーザー定義のセグメント属性を作成することもできます。


| 属性 | 説明 | 許可される値 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | --- | 
| connect:Subtype | コンタクトに使用されるチャネルのサブタイプを表します。 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/connect-attrib-list.html)  | ValueString | \$1.SegmentAttributes['connect:Subtype'] | 
| connect:Direction | コンタクトの方向を表します。例えば、インバウンドまたはアウトバウンドです。 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/connect-attrib-list.html)  | ValueString | \$1.SegmentAttributes['connect:Direction'] | 
| connect:CreatedByUser | タスクを作成したユーザーの ARN を表します。 |  | ValueString | \$1.SegmentAttributes['connect:CreatedByUser'] | 
| connect:AssignmentType | タスクの割り当て方法を表します。 | "SELF" | ValueString | \$1.SegmentAttributes['connect:AssignmentType'] | 
| connect:EmailSubject | E メールによるコンタクトの件名を表します。 |  | ValueString | \$1.SegmentAttributes['connect:EmailSubject'] | 
| connect:ScreenSharingDetails |  `ScreenSharingDetails` セクションには、コンタクトで実行された画面共有アクティビティに関する情報が含まれます。 `ScreenSharingActivated` キーは、コンタクトにおいて画面共有セッションがアクティブ化されているかどうかを示します。  | `"connect:ScreenSharingDetails": { "ScreensharingActivated" : "TRUE" // Allowed Values "TRUE" and "FALSE" }` | ValueString | \$1.SegmentAttributes['connect:ScreenSharingDetails'] | 
| connect:ContactExpiry | タスクおよび E メールのコンタクトにおける `ExpiryDuration` や `ExpiryTimeStamp` など、コンタクトの有効期限に関する詳細が含まれます。 |  | valueMap | \$1.SegmentAttributes['connect:ContactExpiry'] | 
| connect:CustomerAuthentication | チャットによるコンタクトの認証に関する詳細。 | `"connect:CustomerAuthentication": { "valueMap": { "IdentityProvider": { "ValueString": ""}, "ClientId": { "ValueString": ""}, "Status": { "ValueString": *AUTHENTICATED \| FAILED \| TIMEOUT*}, "AssociatedCustomerId": { "ValueString": ""} "AuthenticationMethod": { "ValueString": "*CONNECT" \| "CUSTOM*" } } }` | ValueMap | \$1.SegmentAttributes['connect:CustomerAuthentication'] | 
| connect:ValidationTestType |  テストとシミュレーションのタイプを表します。このフィールドは、シミュレートされていない問い合わせでは空のままです。分析ダッシュボードでこの属性を使用して、実際の顧客の問い合わせを除外したり、問い合わせが問い合わせレコードオブジェクト内でシミュレートされているかどうかを特定したりできます。  | 「EXPERIENCE\$1VALIDATION」 | ValueString | \$1.Segment.Attributes['connect:ValidationTestType'] | 
| クライアント ID | Amazon Cognito アプリのクライアント識別子。 |  | ValueString | \$1.SegmentAttributes['connect:CustomerAuthentication']['ClientId'] | 
| ID プロバイダー | 顧客の認証に使用される ID プロバイダー。 |  | ValueString | \$1.SegmentAttributes['connect:CustomerAuthentication']['IdentityProvider'] | 
| ステータス | 認証プロセスのステータス。 | `AUTHENTICATED` \$1 `FAILED` \$1 `TIMEOUT` | ValueString | \$1.SegmentAttributes['connect:CustomerAuthentication']['Status'] | 
| 関連するカスタマー ID | 顧客の識別子番号。これはカスタム識別子または顧客プロファイル識別子です。 |  | ValueString | \$1.SegmentAttributes['connect:CustomerAuthentication']['AssociatedCustomerId'] | 
| 認証方法 | Amazon Connect が管理する認証ワークフローまたは顧客が管理する認証ワークフロー。 | `CONNECT` \$1 `CUSTOM` | ValueString | \$1.SegmentAttributes['connect:CustomerAuthentication']['AuthenticationMethod'] | 
| E メールの件名 | 顧客がコンタクトセンターに送信した E メールの件名。これは、E メールの件名で特定のキーワードを確認する場合に便利です。 |  | セグメント属性 | \$1.SegmentAttributes['connect:EmailSubject'] | 
| Amazon SES Spam Verdict | E メールがコンタクトセンターに着信すると、Amazon SES がスパムをスキャンします。FAILED 条件の有無をチェックして、E メールを削除するか、スーパーバイザーが確認できるように特別なキューに入れることができます。 |  | セグメント属性 | \$1.SegmentAttributes['connect:X-SES-SPAM-VERDICT'] | 
| Amazon SES Virus Verdict | E メールがコンタクトセンターに着信すると、Amazon SES がウイルスをスキャンします。FAILED 条件の有無をチェックして、E メールを削除するか、スーパーバイザーが確認できるように特別なキューに入れることができます。 |  | セグメント属性 | \$1.SegmentAttributes['connect:X-SES-VIRUS-VERDICT'] | 
| ユーザー定義の属性 | 任意のユーザー定義の属性を選択し、セグメント属性としてコンタクトに保存できます。属性を使用してコンタクトに値を保存するには、事前に属性を定義しておく必要があります。「[コンタクトセグメント属性を使用する](use-contact-segment-attributes.md)」を参照してください。 | 値が事前定義されていない場合、Amazon Connect はすべての文字列値を許可します。これは、**[事前定義された属性を追加]** ページで [[有効な値の強制]](use-contact-segment-attributes.md) オプションが選択されていない場合にも当てはまります。**[有効な値の強制]** オプションが選択され、値が事前定義されている場合、事前定義された属性キーの有効な値と事前定義された値のみが保存されます (API を使用している場合は、[EnableValueValidationOnAssociation](https://docs.aws.amazon.com/connect/latest/APIReference/API_InputPredefinedAttributeConfiguration.html) パラメータを参照してください)。 | String | \$1.SegmentAttributes['Attribute\$1key\$1name'] | 

## ビューの属性
<a name="attribs-views"></a>

次の表に、Amazon Connect で利用できるビューの属性を一覧表示します。


| 属性 | 説明 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | 
| アクション | ビューを操作するユーザーによって実行されたアクション。アクションは [[ビューを表示](show-view-block.md)] ブロックでフローブランチとして表示されます | ビュー |  \$1.Views.Action | 
| 結果データを表示 | ユーザーがアクションを実行したコンポーネントに基づく、ビュー操作からの出力データ。 | ビュー |  \$1.Views.ViewResultData | 

## 機能の属性
<a name="attribs-capabilities"></a>

次の表に、Amazon Connect で利用できる機能の属性を一覧表示します。これらの属性は、画面およびビデオ共有機能をサポートします。詳細については、「[アプリ内通話、ウェブ通話、ビデオ通話機能、および画面共有のセットアップ](inapp-calling.md)」を参照してください。


| 属性 | 説明 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | 
| エージェント画面共有機能 | 参加者に対して有効になっている画面共有機能。 | 機能 | \$1.Capabilities.Agent.ScreenShare | 
| エージェントビデオ機能 | 通話中に参加者に対して有効になっているビデオ共有機能。 | 機能 | \$1.Capabilities.Agent.Video | 
| 顧客画面共有機能 | 参加者に対して有効になっている画面共有機能。 | 機能 | \$1.Capabilities.Customer.ScreenShare | 
| 顧客ビデオ機能 | 通話中に参加者に対して有効になっているビデオ共有機能。 | 機能 | \$1.Capabilities.Customer.Video | 

## エージェントの属性
<a name="attribs-agent"></a>

次の表に、Amazon Connect で利用できるエージェントの属性を一覧表示します。


| 属性 | 説明 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | 
| エージェントユーザー名 | エージェントが Amazon Connect にログインするために使用するユーザー名。 | システム | \$1.Agent.UserName | 
| エージェントの名 | Amazon Connect のユーザーアカウントに入力されているエージェントの名 (ファーストネーム)。 | システム | \$1.Agent.FirstName | 
| エージェントの姓 | Amazon Connect のユーザーアカウントに入力されているエージェントの姓 (ラストネーム) | システム | \$1.Agent.LastName | 
| エージェント ARN | エージェントの ARN。 | システム | \$1.Agent.ARN | 

**注記**  
**エージェントへの転送**フローで使用するエージェントの問い合わせ属性には、転送を開始したエージェントではなくターゲットのエージェントが反映されます。

エージェント属性は、次のタイプのフローでのみ使用できます。
+ エージェントウィスパー
+ 顧客ウィスパー
+ エージェント保留
+ お客様保留
+ 発信ウィスパー
+ エージェントへの転送。この場合のエージェント属性には、転送を開始したエージェントではなく、ターゲットのエージェントが反映されます。

エージェント属性は、次のフロータイプでは使用できません。
+ 顧客キュー
+ キューへの転送
+ インバウンドフロー

## キュー属性
<a name="attribs-system-metrics-table"></a>

これらは、フローの [[メトリクスの取得](get-queue-metrics.md)] ブロックを使用したときに返されるシステムメトリクス属性です。

コンタクトセンターで現在のアクティビティがない場合、これらの属性に対して NULL 値が返されます。


| 属性 | 説明 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | 
| キュー名 | メトリクスが取得されたキューの名前。 | システム | \$1.Metrics.Queue.Name | 
| キュー ARN | メトリクスが取得されたキューの ARN。 | システム | \$1.Metrics.Queue.ARN | 
| キュー内のコンタクト | 現在キュー内にある問い合わせの数。 | システム | \$1.Metrics.Queue.Size | 
| キューの最も古い問い合わせ | 最も長くキューに入っている問い合わせの場合は、問い合わせがキューに入っている時間の長さ (秒単位)。 | システム | \$1.Metrics.Queue.OldestContactAge | 
| キューの推定待機時間 | エージェントに接続されるまでに問い合わせがキューで待機する時間を秒単位で推定します。 | システム | \$1.Metrics.Queue.EstimatedWaitTime | 
| オンラインエージェント | 現在オンライン、つまり、ログインしていて、オフライン以外の何らかの状態にあるエージェントの数。 | システム | \$1.Metrics.Agents.Online.Count | 
| 使用可能なエージェント | 状態が [Available] に設定されているエージェントの数。 | システム | \$1.Metrics.Agents.Available.Count | 
| 配置済みエージェント | 現在対応可能なエージェントの数。対応可能とは、ログインしていて、[Available]、[ACW] または [Busy] 状態にあるエージェントです。 | システム | \$1.Metrics.Agents.Staffed.Count | 
| 連絡作業後のエージェント | 現在 ACW 状態にあるエージェントの数。 | システム | \$1.Metrics.Agents.AfterContactWork.Count | 
| ビジー状態のエージェント | 現在、問い合わせに対応中のエージェントの数。 | システム | \$1.Metrics.Agents.Busy.Count | 
| 不在のエージェント数 | [Missed] 状態のエージェント数。エージェントは、不在問い合わせの後、この状態に入ります。 | システム | \$1.Metrics.Agents.Missed.Count | 
| 非生産的な状態にあるエージェント | 非生産的 (NPT) 状態にあるエージェントの数。 | システム | \$1.Metrics.Agents.NonProductive.Count | 

## 問い合わせメトリクス属性
<a name="attribs-contact-metrics-table"></a>

これらは、フローの [[メトリクスの取得](get-queue-metrics.md)] ブロックを使用したときに返されるシステムメトリクス属性です。

コンタクトセンターで現在のアクティビティがない場合、これらの属性に対して NULL 値が返されます。


| 属性 | 説明 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | 
| 推定待機時間 | エージェントに接続されるまでに現在の問い合わせがキューで待機する時間を秒単位で推定します。 | システム | \$1.Metrics.Contact.EstimatedWaitTime | 
| キュー内の位置 | チャネル (音声、チャット、タスク、または E メール) を考慮しながらキュー内の問い合わせの位置と、ルーティングステップが使用されているかどうか。 | システム | \$1.Metrics.Contact.PositionInQueue | 

## テレフォニー通話メタデータ属性 (通話属性)
<a name="telephony-call-metadata-attributes"></a>

テレフォニーメタデータは、テレフォニーキャリアからの通話発信に関連する追加的な情報を提供します。


| 属性 | 説明 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | 
| P-Charge-Info | 通話に関連する料金の責任者。 | システム | \$1.Media.Sip.Headers.P-Charge-Info | 
| から | リクエストに関連付けられたエンドユーザーの ID。 | システム | \$1.Media.Sip.Headers.From | 
| 目的 | リクエストの着信側または受信側に関する情報。 | システム | \$1.Media.Sip.Headers.To | 
| ISUP-OLI | 発信ラインインジケータ (OLI) 通話を発信する回線のタイプ (PSTN、800 サービスコール、ワイヤレス/セルラー PCS、公衆電話など) を示します。 | システム | \$1.Media.Sip.Headers.ISUP-OLI | 
| JIP | 管轄区域表示パラメータ (JIP) 発信者/スイッチの地理的位置を表します。 値の例: 212555 | システム | \$1.Media.Sip.Headers.JIP | 
| ホップカウンター | ホップカウンター。 値の例:0  | システム | \$1.Media.Sip.Headers.Hop-Counter | 
| 発信スイッチ | 発信スイッチ。 値の例: 710   | システム | \$1.Media.Sip.Headers.Originating-Switch | 
| 発信トランク | 発信トランク。 値の例: 0235 | システム | \$1.Media.Sip.Headers.Originating-Trunk | 
| Call-Forwarding-Indicator | 通話転送インジケータ (ディバージョンヘッダーなど) 国内または海外の通話の発信元を示します。 値の例:sip:\$115555555555@public-vip.us2.telphony-provider.com;reason=unconditional  | システム | \$1.Media.Sip.Headers.Call-Forwarding-Indicator | 
| Calling-Party-Address | 発信側アドレス (電話番号)。NPAC dip は、真のラインタイプと国内の地理的スイッチを示します。 値の例: 15555555555;noa=4  | システム | \$1.Media.Sip.Headers.Calling-Party-Address | 
| Called-Party-Address | 着信側アドレス (電話番号)。  値の例: 15555555555;noa=4   | システム | \$1.Media.Sip.Headers.Called-Party-Address | 
| SIPREC メタデータ |  Amazon Contact Lens コネクタが受信した SIPREC メタデータ XML  | システム |  \$1.Media.Sip.SiprecMetadata | 

**注記**  
テレフォニーメタデータは、すべてのテレフォニープロバイダーで利用できるわけではなく、すべてのケースに対応するとは限りません。この値は空になることがあります。

## チャット初期メッセージ属性
<a name="chat-initial-message-attributes"></a>


| 属性 | 説明 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | 
| InitialMessage | ウェブチャットまたは SMS で顧客が送信した最初のメッセージ。  | システム | \$1.Media.InitialMessage | 

## E メール属性
<a name="email-attribs"></a>

次の表に、Amazon Connect で使用できる E メール属性を示します。


| 属性 | 説明 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | 
| E メールメッセージ (プレーンテキスト) |  保存[済みコンテンツの取得](get-stored-content.md)フローブロックを使用すると、E メール連絡先からの E メールメッセージのプレーンテキストバージョンが保存されます。  | システム | \$1.Email.EmailMessage.Plaintext | 

## メディアストリームの属性
<a name="media-stream-attribs"></a>

次の表は、ライブメディアストリーム内で顧客の音声が開始/停止する位置を特定するための属性の一覧です。


| 属性 | 説明 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | 
| 顧客のオーディオストリーム ARN | 参照のための顧客データを含む、ライブメディアストリーミングに使用される Kinesis Video ストリームの ARN。 | メディアストリーム | \$1.MediaStreams.Customer.Audio.StreamARN | 
| ライブメディアストリーミングに使用される、顧客側 Kinesis ビデオストリームのオーディオ開始タイムスタンプ。 | 顧客のオーディオストリームが開始された時刻。 | メディアストリーム | \$1.MediaStreams.Customer.Audio.StartTimestamp | 
| 顧客のオーディオ停止タイムスタンプ | ライブメディアストリーミングが使用している Kinesis ビデオストリームが、顧客側のオーディオストリームによって停止された時刻。 | メディアストリーム | \$1.MediaStreams.Customer.Audio.StopTimestamp | 
| 顧客のオーディオ開始フラグメント番号 | ライブメディアストリーミングで使用されているストリーム内にあり、顧客側のオーディオストリームの開始に使用された、Kinesis Video Streams のフラグメントを識別する番号。 | メディアストリーム | \$1.MediaStreams.Customer.Audio.StartFragmentNumber | 

## Amazon Lex 問い合わせ属性
<a name="attribs-lex-table"></a>

次の表は、Amazon Lex ボットから返される属性の一覧です。これらは*セッション属性*とも呼ばれます。


| 属性 | 説明 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | 
| 代替インテント | Amazon Lex から利用可能な代替インテントのリスト。各インテントには、対応する信頼スコアと入力するスロットがあります。 | Lex | \$1.Lex.AlternativeIntents.*x*.IntentName \$1.Lex.AlternativeIntents.*x*.IntentConfidence.Score  \$1.Lex.AlternativeIntents.*x*.Slots  \$1.Lex.AlternativeIntents.*y.*IntentName  \$1.Lex.AlternativeIntents.*y*.IntentConfidence.Score  \$1.Lex.AlternativeIntents.*y*.Slots   \$1.Lex.AlternativeIntents.*z*.IntentName  \$1.Lex.AlternativeIntents.*z*.IntentConfidence.Score \$1.Lex.AlternativeIntents.*z*.Slots  *x*、*y*、*z* は Lex レスポンスのインテント名です。  | 
| インテントの信頼スコア | Amazon Lex によって返されるインテント信頼スコア。 | Lex | \$1.Lex.IntentConfidence.Score | 
| インテント名 | Amazon Lex によって返されるユーザーのインテント。 | Lex | \$1.Lex.IntentName | 
| 感情ラベル |  Amazon Comprehend が最も信頼度が高いと推測されるセンチメント。  | Lex | \$1.Lex.SentimentResponse.Label  | 
| 感情スコア |  センチメントが正しく推測された可能性。  | Lex | \$1.Lex.SentimentResponse.Scores.Positive \$1.Lex.SentimentResponse.Scores.Negative \$1.Lex.SentimentResponse.Scores.Mixed \$1.Lex.SentimentResponse.Scores.Neutral | 
| セッション属性 |  セッション固有のコンテキスト情報を表すキーと値のペアのマップ。  | Lex | \$1.Lex.SessionAttributes.attributeKey | 
| Slots | 対話中にユーザーによる入力から Amazon Lex が検出した、インテントのスロットのマップ (キー/値のペア)。  | Lex | \$1.Lex.Slots.slotName | 
| ダイアログ状態 | Amazon Lex ボットから返される最後のダイアログの状態。インテントがフローに返された場合、値は「受理済み」です。 | 該当なし (UI に表示されるタイプはなし) | \$1.Lex.dialogState | 

## ケース問い合わせ属性
<a name="attribs-case-table"></a>

次の表では、Amazon Connect Cases で使用される属性を一覧表示しています。


| 属性 | 説明 | タイプ | JSONPath 参照 | データソース | 
| --- | --- | --- | --- | --- | 
|  ケース ID  | UUID 形式のケースの一意の識別子 (例: 689b0bea-aa29-4340-896d-4ca3ce9b6226) | テキスト |  \$1.Case.case\$1id  | Amazon Connect | 
|  ケースの理由  | ケースをオープンした理由 |  single-select  | \$1.Case.case\$1reason | [エージェント] | 
|  作成者  | ケースを作成したユーザーの ID。 |  ユーザー  | \$1.Case.created\$1by | Amazon Connect | 
|  お客様  | API は顧客プロファイル ID です。[Cases: Fields] (Cases: フィールド) ページに、顧客の名前が表示されます。 |  テキスト  | \$1.Case.customer\$1id | Amazon Connect | 
|  クローズ日時  | ケースが最後にクローズされた日時。ケースがクローズされたことを保証するものではありません。ケースが再度オープンにされた場合、このフィールドには、ステータスが最後にクローズに変更されたときの日時のスタンプが含まれます。 |  date-time  | \$1.Case.last\$1closed\$1datetime  | Amazon Connect | 
|  オープン日時  | ケースがオープンされた日時。 |  date-time  | \$1.Case.created\$1datetime | Amazon Connect | 
|  更新日時  | ケースが最後に更新された日時。 |  date-time   | \$1.Case.last\$1updated\$1datetime | Amazon Connect | 
|  参照番号  | 数字形式 (8 桁) のケースのわかりやすい番号。 参照番号は、(Case ID とは異なって) 一意であることが保証されません。顧客を特定してから、参照番号を収集して適切なケースを正しく見つけるようにすることをお勧めします。  |  テキスト  | \$1.Case.reference\$1number | [エージェント] | 
|  ステータス  | ケースの現在のステータス  |  テキスト  | \$1.Case.status | [エージェント] | 
|  概要  | ケースの概要  |  テキスト  | \$1.Case.summary | [エージェント] | 
|  タイトル  | ケースのタイトル  |  テキスト  | \$1.Case.title | [エージェント] | 

## Lambda での問い合わせ属性
<a name="attribs-lambda-table"></a>

Lambda の属性は、[[AWS Lambda 関数](invoke-lambda-function-block.md)] ブロックの直近の呼び出しからキーと値のペアとして返されます。Lambda の呼び出し属性は、Lambda 関数の呼び出しごとに上書きされます。

JSONPath で属性を参照するには、以下を使用します。
+ `$.LambdaInvocation.ResultData.attributeName`

この際、`AttributeName` は属性名、または関数から返されたキーと値のペアの中のキーの部分を意味します。

例えば、関数が問い合わせ ID を返した場合は、`$.LambdaInvocation.ResultData.ContactId` を使用して属性を参照します。Amazon Connect から返される問い合わせ ID を参照する場合の JSONPath は `$.ContactId` です。

Lambda 関数で属性を使用する方法の詳細については、「[AWS Lambda 関数へのアクセスを Amazon Connect に許可する](connect-lambda-functions.md)」を参照してください。

これらの属性は問い合わせレコードに含まれておらず、次回の Lambda 呼び出しにも渡されません。また、スクリーンのポップ情報のために CCP に渡されることもありません。ただし、[[AWS Lambda 関数](invoke-lambda-function-block.md)] ブロックで Lambda 関数入力として渡すか、[[コンタクト属性の設定](set-contact-attributes.md)] ブロックを使用してユーザー定義の属性にコピーすることはできます。[[コンタクト属性の設定](set-contact-attributes.md)] ブロックで使用されると、コピーされた属性がコンタクトレコードに含まれ、CCP で使用できるようになります。

## ユーザー定義の属性
<a name="user-defined-attributes"></a>

その他のすべての属性については、Amazon Connect によってキーと値が定義されます。ただし、ユーザー定義の属性については、ユーザーがキーと値の名前を指定します。

問い合わせフローに値を格納し、それらの値を後で参照する場合は、ユーザー定義の属性を使用します。例えば、Amazon Connect と CRM などのシステムを統合する場合には、顧客にメンバー番号などの情報を入力してもらう必要があります。このメンバー番号は、メンバーに関する情報を CRM から取得するためや、フロー全体的のために使用することができます。


| 属性 | 説明 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | 
| 選択した任意の名前 | ユーザー定義の属性は、以下の 2 つの部分で構成されます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/connect-attrib-list.html)  | ユーザー定義 | \$1.Attributes.*name\$1of\$1your\$1destination\$1key* | 

ユーザー定義の属性を作成するには、[コンタクト属性の設定](set-contact-attributes.md)ブロックを使用します。

## フロー属性
<a name="flow-attributes"></a>

フロー属性はユーザー定義の属性に似ていますが、設定されたフローに制限されます。

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


| 属性 | 説明 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | 
| 選択した任意の名前 | フロー属性には次の 2 つの部分があります。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/connect-attrib-list.html)  | フロー | \$1.FlowAttributes.*name\$1of\$1your\$1destination\$1key* | 

## ループ属性
<a name="w2aac18c52b9c41"></a>

次の表に、Loop ブロックで LoopName が指定されている場合に Loop ブロックで使用できる属性を示します。


| 属性 | 説明 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | 
|  [Index] (インデックス)  | ループの現在のインデックス。値は 0 から始まります。これは、カウントベースループと配列ベースのループの両方で使用できます。 |  ループ  |  \$1.Loop.*name\$1of\$1your\$1loop*.Index   | 
|  Element  | ループの現在の要素。これは、配列ベースのループでのみ使用できます。 |  ループ  |  \$1.Loop.*name\$1of\$1your\$1loop*.Element  | 
|  [Elements] (要素)  | ループへの入力として提供された要素。これは、配列ベースのループでのみ使用できます。 |  ループ  |  \$1.Loop.*name\$1of\$1your\$1loop*.Elements  | 

## フローモジュールの属性
<a name="flow-modules-attributes"></a>

フローモジュール Input 属性は、フローから入力スキーマを定義したモジュール、または [Invoke Module ブロック](contact-flow-modules.md#add-modules)を使用する別のモジュールに渡される属性です。フローモジュール 出力属性と結果属性は、[モジュール呼び出しブロック](contact-flow-modules.md#add-modules)の最新の呼び出しから返されます。モジュール出力属性と結果属性は、モジュール関数の呼び出しごとに上書きされます。

これらの属性は問い合わせレコードに含まれず、次のモジュール呼び出しに渡されず、スクリーンポップ情報として CCP に渡されません。ただし、[問い合わせ属性の設定](set-contact-attributes.md)ブロックを使用して、ユーザー定義属性にコピーできます。[問い合わせ属性の設定](set-contact-attributes.md)ブロックで使用すると、コピーされた属性は問い合わせレコードに含まれ、CCP で使用できます。

次の表に、Amazon Connect で使用できるフローモジュールの属性を示します。


| 属性 | 説明 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | 
| Input | 入力データは、モジュールに渡された入力へのアクセスを提供します。これは JSON オブジェクトとして返され、特定の形式はモジュール入力スキーマによって定義されます。 | モジュール | \$1.Modules.Input | 
| 結果 | 結果データは、エラーブランチを除くモジュールから返されたブランチ名をキャプチャします。これは文字列として返されます。 | モジュール | \$1.Modules.Result | 
| 出力 (UI からの属性参照) | 出力データは、モジュールの実行から生成された結果データをキャプチャします。これは JSON オブジェクトとして返され、特定の形式はモジュール出力スキーマによって定義されます。 | モジュール | \$1.Modules.ResultData | 

## データテーブルの属性
<a name="data-table-attributes"></a>

データテーブルブロックオペレーションによって返される属性。これらを使用して、問い合わせフロー内のデータテーブルから取得したデータにアクセスします。

### データテーブル値の属性を評価する
<a name="data-table-evaluate-attributes"></a>

データテーブルブロックで評価アクションを使用して特定の属性値をクエリするときに返される属性。
+ クエリが結果を返さないか、 属性が見つからない場合、参照は空または null になります。


| 属性 | 説明 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | 
| データテーブルで評価されたクエリ結果 | 名前付きクエリによって取得された特定の属性の値。をクエリに割り当てられた一意の名前`<QueryName>`に置き換え、 を取得するために選択した属性の名前`<AttributeName>`に置き換えます。 | データテーブル | \$1.DataTables.<QueryName>.<AttributeName> | 

### データテーブル値の属性を一覧表示する
<a name="data-table-list-attributes"></a>

データテーブルブロックでリストアクションを使用して完全なレコードを取得したときに返される属性。
+ リストは、選択したレコードだけでなく、完全なレコード (すべての属性) を返します。
+ 一致するレコードが見つからない場合、primaryKeyGroups 配列は空になります。
+ プライマリキーグループが設定されていない場合、テーブル全体がロードされ、結果は「デフォルト」グループ名 でアクセスできます`$.DataTableList.ResultData.primaryKeyGroups.default[index]`。
+ List 名前空間の最大データ制限は 32 KB です。
+ フローブロック内の配列要素にアクセスするときは、バックティックを使用して JSONPath リファレンスをラップします。 ``$.DataTableList.ResultData.primaryKeyGroups.<GroupName>[index]``


| 属性 | 説明 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | 
| データテーブル ID | レコードが取得されたデータテーブルの一意の識別子。 | データテーブルリスト | \$1.DataTableList.ResultData.dataTableId | 
| ロックバージョン | データテーブルのロックバージョン情報。 | データテーブルリスト | \$1.DataTableList.ResultData.lockVersion.dataTable | 
| デフォルトのグループ名 | プライマリキーグループが設定されていない場合、テーブル全体がロードされ、結果は「デフォルト」グループ名でアクセスできます。 | データテーブルリスト | \$1.DataTableList.ResultData.primaryKeyGroups.default[index] | 
| プライマリキーグループ | プライマリ値グループ名別に整理された、取得されたレコードのコレクション。をプライマリ値グループに割り当てられた名前`<GroupName>`に置き換えます。 | データテーブルリスト | \$1.DataTableList.ResultData.primaryKeyGroups.<GroupName> | 
| 特定の行 | プライマリキーグループ内の特定の行にアクセスします。をグループ名`<GroupName>`に、 を行のゼロベースのインデックス`[index]`に置き換えます。 | データテーブルリスト | \$1.DataTableList.ResultData.primaryKeyGroups.<GroupName>[インデックス] | 
| プライマリキー値 | 特定の行のプライマリキー属性の値にアクセスします。 | データテーブルリスト | \$1.DataTableList.ResultData.primaryKeyGroups.<GroupName>[index].primaryKeys[index].attributeValue | 
| 属性値 | 特定の行の非プライマリ属性の値にアクセスします。 | データテーブルリスト | \$1.DataTableList.ResultData.primaryKeyGroups.<GroupName>[index].attributes[index].attributeValue | 

## Apple Messages for Business の属性
<a name="apple-messages-for-business-attributes"></a>

Apple Messages for Business の顧客をルーティングするには、以下の問い合わせ属性を使用します。例えば、さまざまな基幹業務で Apple Messages for Business を使用している場合は、問い合わせ属性 AppleBusinessChatGroup に基づいて各フローへと分岐できます。また、Apple Messages for Business メッセージを他のチャットメッセージとは別個にルーティングしたい場合は、MessagingPlatform に基づいて分岐できます。


| 属性 | 説明 | タイプ | JSON | 
| --- | --- | --- | --- | 
|  MessagingPlatform  |  顧客からの要求の発信元であるメッセージングプラットフォーム。 正確な値: **AppleBusinessChat**  | ユーザー定義 | \$1.Attributes.MessagingPlatform | 
|  AppleBusinessChatCustomerId  |  Apple から提供された、顧客の不明瞭な ID。この値は、AppleID とビジネスに対しては一定のままです。これを使用して、メッセージが新しい顧客からのものか、再訪した顧客からのものかを識別できます。  | ユーザー定義 | \$1.Attributes.AppleBusinessChatCustomerId | 
|  AppleBusinessChatIntent  |  チャットのインテント、あるいは目的を定義することができます。このパラメータは、顧客側で [**ビジネスチャット**] ボタンがクリックされている場合に、メッセージ内でチャットセッションを開始した URL の中に含まれます。  | ユーザー定義 | \$1.Attributes.AppleBusinessChatIntent | 
|  AppleBusinessChatGroup  |  顧客における特定の質問や問題を処理するのに最適な、部門または個人を指定するためのグループを定義します。このパラメータは、顧客側で [**ビジネスチャット**] ボタンがクリックされている場合に、メッセージ内でチャットセッションを開始した URL の中に含まれます。  | ユーザー定義 | \$1.Attributes.AppleBusinessChatGroup | 
|  AppleBusinessChatLocale  |  ユーザーがユーザーインターフェイスに表示する言語と AWS リージョンの設定を定義します。これは、言語識別子 (ISO 639-1) とリージョン識別子 (ISO 3166) で構成されます。例えば、**en\$1US**。  | ユーザー定義 | \$1.Attributes.AppleBusinessChatLocale | 
|  AppleFormCapability  |  顧客のデバイスがフォームに対応しているか。 true の場合、顧客のデバイスは対応しています。 false の場合、デバイスは対応していません。  | ユーザー定義 | \$1.Attributes.AppleFormCapability | 
|  AppleAuthenticationCapability  |  顧客のデバイスが認証 (OAuth2) に対応しているかどうか。true の場合、顧客のデバイスは対応しています。false の場合、デバイスは対応していません。  | ユーザー定義 | \$1.Attributes.AppleAuthenticationCapability | 
|  AppleTimePickerCapability  |  カスタマーのデバイスがタイムピッカーをサポートしているか。 true の場合、顧客のデバイスは対応しています。 false の場合、デバイスは対応していません。  | ユーザー定義 | \$1.Attributes.AppleTimePickerCapability | 
|  AppleListPickerCapability  |  カスタマーのデバイスがリストピッカーをサポートしているか。 true の場合、顧客のデバイスは対応しています。 false の場合、デバイスは対応していません。  | ユーザー定義 | \$1.Attributes.AppleListPickerCapability | 
|  AppleQuickReplyCapability  |  カスタマーのデバイスがクイック返信をサポートしているか。 true の場合、顧客のデバイスは対応しています。 false の場合、デバイスは対応していません。  | ユーザー定義 | \$1.Attributes.AppleQuickReplyCapability | 

## Customer Profiles の属性
<a name="customer-profiles-attributes"></a>

 Amazon Connect Customer Profiles で使用される属性の一覧は、次の表のとおりです。

Customer Profiles のコンタクト属性の合計サイズは、フロー全体で 14,000 文字 (各最大サイズを 255 と想定すると属性 56 個) に制限されます。これには、フロー中に Customer Profiles の **[レスポンスフィールド]** として保持されるすべての値が含まれます。


| 属性 | 説明 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | 
|  profileSearchKey  |  プロファイルの検索に使用する属性の名前。  |  ユーザー定義  |  該当しない  | 
|  profileSearchValue  |  顧客名やアカウント番号など、検索に使用するキーの値。  |  ユーザー定義  |  該当しない  | 
|  プロファイル ID  |  お客様プロファイルの一意の識別子。  |  テキスト  |  \$1.Customer.ProfileId  | 
|  プロファイル ARN  |  顧客プロファイルの ARN。  |  テキスト  |  \$1.Customer.ProfileARN  | 
|  [First Name] (名)  |  お客様のファーストネーム。  |  テキスト  |  \$1.Customer.FirstName  | 
|  ミドルネーム  |  お客様のミドルネーム。  |  テキスト  |  \$1.Customer.MiddleName  | 
|  [Last Name] (姓)  |  お客様のラストネーム。  |  テキスト  |  \$1.Customer.LastName  | 
|  アカウント番号  |  お客様に付けた一意のアカウント番号。  |  テキスト  |  \$1.Customer.AccountNumber  | 
|  E メールアドレス  |  顧客のメールアドレス。個人用アドレスや業務アドレスとして指定されていないアドレス。  |  テキスト  |  \$1.Customer.EmailAddress  | 
|  電話番号  |  携帯番号、自宅番号、またはビジネス番号として指定されていないお客様の電話番号。  |  テキスト  |  \$1.Customer.PhoneNumber  | 
|  追加情報  |  お客様のプロファイルに関連する追加情報。  |  テキスト  |  \$1.Customer.AdditionalInformation  | 
|  関係者タイプ  |  顧客の関係者タイプ。  |  テキスト  |  \$1.Customer.PartyType  | 
|  ビジネス名  |  お客様のビジネスの名前。  |  テキスト  |  \$1.Customer.BusinessName  | 
|  生年月日  |  お客様の生年月日。  |  テキスト  |  \$1.Customer.BirthDate  | 
|  性別  |  顧客の性別。  |  テキスト  |  \$1.Customer.Gender  | 
|  携帯電話番号  |  お客様の携帯電話番号。  |  テキスト  |  \$1.Customer.MobilePhoneNumber  | 
|  自宅の電話番号  |  お客様の自宅電話番号。  |  テキスト  |  \$1.Customer.HomePhoneNumber  | 
|  勤務先の電話番号  |  お客様のビジネス電話番号。  |  テキスト  |  \$1.Customer.BusinessPhoneNumber  | 
|  勤務先の E メールアドレス  |  顧客の勤務先メールアドレス。  |  テキスト  |  \$1.Customer.BusinessEmailAddress  | 
|  Address  |  郵送用、配送用、請求用ではないお客様に関連付けられた一般的な住所。  |  テキスト  |  \$1.Customer.Address1 \$1.Customer.Address2 \$1.Customer.Address3 \$1.Customer.Address4 \$1.Customer.City \$1.Customer.County \$1.Customer.Country \$1.Customer.PostalCode \$1.Customer.Province \$1.Customer.State  | 
|  配送先住所  |  お客様の配送先住所。  |  テキスト  |  \$1.Customer.ShippingAddress1 \$1.Customer.ShippingAddress2 \$1.Customer.ShippingAddress3 \$1.Customer.ShippingAddress4 \$1.Customer.ShippingCity \$1.Customer.ShippingCounty \$1.Customer.ShippingCountry \$1.Customer.ShippingPostalCode \$1.Customer.ShippingProvince \$1.Customer.ShippingState  | 
|  郵送先住所  |  お客様の郵送先住所。  |  テキスト  |  \$1.Customer.MailingAddress1 \$1.Customer.MailingAddress2 \$1.Customer.MailingAddress3 \$1.Customer.MailingAddress4 \$1.Customer.MailingCity \$1.Customer.MailingCounty \$1.Customer.MailingCountry \$1.Customer.MailingPostalCode \$1.Customer.MailingProvince \$1.Customer.MailingState  | 
|  請求アドレス  |  顧客の請求連絡先  |  テキスト  |  \$1.Customer.BillingAddress1 \$1.Customer.BillingAddress2 \$1.Customer.BillingAddress3 \$1.Customer.BillingAddress4 \$1.Customer.BillingCity \$1.Customer.BillingCounty \$1.Customer.BillingCountry \$1.Customer.BillingPostalCode \$1.Customer.BillingProvince \$1.Customer.BillingState  | 
|  属性  |  顧客プロファイルの属性のキーバリューペア。  |  テキスト  |  \$1.Customer.Attributes.x  | 
|  オブジェクト属性  |  顧客プロファイルのカスタムオブジェクト属性のキーバリューペア。  |  テキスト  |  \$1.Customer.ObjectAttributes.y  | 
|  計算属性  |  顧客プロファイルの計算属性のキーバリューペア。  |  テキスト  |  \$1.Customer.CalculatedAttributes.z  | 
|  アセット  |  顧客の標準アセット。  |  テキスト  |  \$1.Customer.Asset.AssetId \$1.Customer.Asset.ProfileId \$1.Customer.Asset.AssetName \$1.Customer.Asset.SerialNumber \$1.Customer.Asset.ModelNumber \$1.Customer.Asset.ModelName \$1.Customer.Asset.ProductSKU \$1.Customer.Asset.PurchaseDate \$1.Customer.Asset.UsageEndDate \$1.Customer.Asset.Status \$1.Customer.Asset.Price \$1.Customer.Asset.Quantity \$1.Customer.Asset.Description \$1.Customer.Asset.AdditionalInformation \$1.Customer.Asset.DataSource \$1.Customer.Asset.Attributes.x  | 
|  Order  |  顧客の標準注文。  |  テキスト  |  \$1.Customer.Order.OrderId \$1.Customer.Order.ProfileId \$1.Customer.Order.CustomerEmail \$1.Customer.Order.CustomerPhone \$1.Customer.Order.CreatedDate \$1.Customer.Order.UpdatedDate \$1.Customer.Order.ProcessedDate \$1.Customer.Order.ClosedDate \$1.Customer.Order.CancelledDate \$1.Customer.Order.CancelReason \$1.Customer.Order.Name \$1.Customer.Order.AdditionalInformation \$1.Customer.Order.Gateway \$1.Customer.Order.Status \$1.Customer.Order.StatusCode \$1.Customer.Order.StatusUrl \$1.Customer.Order.CreditCardNumber \$1.Customer.Order.CreditCardCompany \$1.Customer.Order.FulfillmentStatus \$1.Customer.Order.TotalPrice \$1.Customer.Order.TotalTax \$1.Customer.Order.TotalDiscounts \$1.Customer.Order.TotalItemsPrice \$1.Customer.Order.TotalShippingPrice \$1.Customer.Order.TotalTipReceived \$1.Customer.Order.Currency \$1.Customer.Order.TotalWeight \$1.Customer.Order.BillingName \$1.Customer.Order.BillingAddress1 \$1.Customer.Order.BillingAddress2 \$1.Customer.Order.BillingAddress3 \$1.Customer.Order.BillingAddress4 \$1.Customer.Order.BillingCity \$1.Customer.Order.BillingCounty \$1.Customer.Order.BillingCountry \$1.Customer.Order.BillingPostalCode \$1.Customer.Order.BillingProvince \$1.Customer.Order.BillingState \$1.Customer.Order.ShippingName \$1.Customer.Order.ShippingAddress1 \$1.Customer.Order.ShippingAddress2 \$1.Customer.Order.ShippingAddress3 \$1.Customer.Order.ShippingAddress4 \$1.Customer.Order.ShippingCity \$1.Customer.Order.ShippingCounty \$1.Customer.Order.ShippingCountry \$1.Customer.Order.ShippingPostalCode \$1.Customer.Order.ShippingProvince \$1.Customer.Order.ShippingState \$1.Customer.Order.Attributes.y  | 
|  ケース  |  顧客の標準ケース。  |  テキスト  |  \$1.Customer.Case.CaseId \$1.Customer.Case.ProfileId \$1.Customer.Case.Title \$1.Customer.Case.Summary \$1.Customer.Case.Status \$1.Customer.Case.Reason \$1.Customer.Case.CreatedBy \$1.Customer.Case.CreatedDate \$1.Customer.Case.UpdatedDate \$1.Customer.Case.ClosedDate \$1.Customer.Case.AdditionalInformation \$1.Customer.Case.DataSource \$1.Customer.Case.Attributes.z  | 

## アウトバウンドキャンペーンの属性
<a name="campaign-attributes"></a>

[セグメント](https://docs.aws.amazon.com/pinpoint/latest/userguide/segments-building.html)リストのデータ Amazon Pinpoint を使用して、 Amazon Connect フローのエクスペリエンスをカスタマイズできます。セグメントリスト内のデータを参照するには、**\$1.Attributes.*セグメントに含まれる属性***を使用します。例えば、「Attributes.FirstName」と「Attributes.ItemDescription」の 2 つの列を持つセグメントがある場合は、次のように参照します。
+ \$1.Attributes.FirstName
+ \$1.Attributes.ItemDescription

詳細については、「*Amazon Pinpoint ユーザーガイド*」の「[パーソナライズされたコンテンツをメッセージテンプレートに追加する](https://docs.aws.amazon.com/pinpoint/latest/userguide/message-templates-personalizing.html)」を参照してください。

## Connect AI エージェント属性
<a name="qic-attributes"></a>

次の属性は、Connect AI エージェントセッション ARN を保存します。この属性のユースケースは、[UpdateSession](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_UpdateSession.html) や [UpdateSessionData](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_UpdateSessionData.html) などの API アクションを実行する場合です。属性を [[AWS Lambda 関数](invoke-lambda-function-block.md)] ブロックへの入力として渡すことができます。また、Lambda は入力セッション ARN に対してこれらの API を呼び出すことができます。


| 属性 | 説明 | タイプ | JSONPath 参照 | 
| --- | --- | --- | --- | 
|  SessionArn  |  Connect AI エージェントセッションの Amazon リソースネーム (ARN)。  |  フロー  |  \$1.Wisdom.SessionArn  | 

# Amazon Connect で問い合わせ属性を参照する方法
<a name="how-to-reference-attributes"></a>

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

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

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

## 問い合わせ属性の設定例
<a name="set-contact-attribute-example"></a>

[コンタクト属性の設定](set-contact-attributes.md) ブロックを使用して、後からフローで参照する値を設定します。例えば、顧客アカウントのタイプに基づいてキューにルーティングされる顧客にパーソナライズした挨拶を作成します。会社名または基幹業務の属性を定義して、顧客に発話されるテキスト読み上げの文字列に含めることもできます。[[コンタクト属性の設定](set-contact-attributes.md)] ブロックは、外部ソースから取得した属性をユーザー定義の属性にコピーするのに役立ちます。

**[コンタクト属性の設定](set-contact-attributes.md) ブロックを使用して問い合わせ属性を設定する**

1. Amazon Connectで、**[ルーティング]**、**[コンタクトフロー]** の順にクリックします。

1. 既存のフローを選択するか、新しく作成します。

1. [コンタクト属性の設定](set-contact-attributes.md) ブロックを追加します。

1. [[コンタクト属性の設定](set-contact-attributes.md)] ブロックを編集し、**[テキストを使用]** を選択します。

1. [**宛先キー**] には、[*会社*] などの属性の名前を指定します。これが、他のブロックで属性を使用するか参照するときに使用する [**属性**] フィールドの値です。[**値**] には、会社名を使用します。

   新しい属性を作成するベースとして、既存の属性の使用を選択することもできます。

# コンタクトコントロールパネル (CCP) でエージェントに連絡先情報を表示する
<a name="use-attribs-ccp"></a>

問い合わせ属性を使用して、問い合わせに関する情報をキャプチャし、その情報を問い合わせコントロールパネル (CCP) によりエージェントに表示できます。これは、顧客関係管理 (CRM) アプリケーションと統合されている CCP を使用する際に、エージェント側のエクスペリエンスをカスタマイズしたい場合などに利用できます。

また、Amazon Connect Streams API または Amazon Connect API を使用して、Amazon Connect をカスタムアプリケーションと統合する場合にも使用します。Amazon Connect Streams JavaScript ライブラリを使用している CCP では、顧客番号やダイヤルした番号に加えて、ユーザー定義の属性がすべて使用できます。詳細については、「[Amazon Connect Streams API](https://github.com/aws/amazon-connect-streams)」または「Amazon Connect API」を参照してください。

Amazon Connect Streams API を使用している場合は、contact.getAttributes() を呼び出すことでユーザー定義属性にアクセスすることができます。contact.getConnections() を使用してエンドポイントにアクセスでき、この場合、接続に getEndpoint() 呼び出しがあります。

Lambda 関数から属性に直接アクセスするには、\$1.External.AttributeName を使用します。属性が [[コンタクト属性の設定](set-contact-attributes.md)] ブロックのユーザー定義の属性に保存されている場合は、\$1.Attributes.AttributeName を使用します。

例えば、Amazon Connect インスタンスには、「Sample note for screenpop」という名前のフローが含まれています。このフローでは、テキスト文字列から属性を作成するために [[コンタクト属性の設定](set-contact-attributes.md)] ブロックが使用されます。テキストは、エージェントにメモを表示するために、属性として CCP に渡すことができます。

# Amazon Connect の属性を使用して、キュー内の問い合わせの数に基づいてルーティングする
<a name="attrib-system-metrics"></a>

Amazon Connect には、コンタクトセンター内のキューとエージェントに関するリアルタイムのメトリクスに基づいて、フローでルーティング条件を定義するのに役立つキュー属性が含まれています。いくつかの一般的な使用シナリオの例を以下に示します。
+ キュー内にある問い合わせの数や対応が可能なエージェントの数、および最も古い問い合わせがキューに格納されている期間を確認し、それぞれに応じてルーティングを行います。
+ 問い合わせが最も少ないキューにルーティングするには、以下を行います。

  1. 複数のキューのメトリクスを取得します。

  1. [[コンタクト属性の設定](set-contact-attributes.md)] ブロックを使用して、各キューのメトリクス属性を格納します。

  1. [[コンタクト属性を確認する](check-contact-attributes.md)] ブロックを使用してキューのメトリクス属性を比較し、通話数が最も少ないキューにコンタクトをルーティングするか、すべてのキューがビジー状態の場合はコールバックにルーティングします。

# [問い合わせ属性を確認する] ブロックを使用してキューに問い合わせをルーティングする


1. Amazon Connectで、[**ルーティング**]、[**問い合わせフロー**] の順にクリックします。

1. 既存のフローを開くか、新しく作成します。

1. オプションとして、[**操作**] の下で、デザイナーに [**プロンプトの再生**] ブロックを追加して、顧客に挨拶を再生します。[**エントリポイント**] ブロックと [**プロンプトの再生**] ブロックの間にコネクタを追加します。

1. **[設定]** で、**[キューメトリクスの取得]** ブロックをデザイナーにドラッグし、それに **[プロンプトの再生]** ブロックの **[OK]** ブランチを接続します。

1. ブロックのプロパティを開く、[**キューメトリクスの取得**] ブロックのタイトルを選択します。デフォルトでは、ブロックは、現在の作業キューのメトリクスを取得します。別のキューのメトリクスを取得するには、[**キューの設定**] を選択します。

1. [**キューの選択**]キューを選択し、ドロップダウンメニューからメトリクスを取得するキューを選択してから、[**保存**] を選択します。

   また、問い合わせ属性を使用して、メトリックスを取得するキューを決定することもできます。

1. **[Check]** (チェック) で、**[Check contact attributes]** (コンタクト属性の確認) ブロックをデザイナーにドラッグします。

1. ブロックの設定を表示するブロックのタイトルを選択します。次に、[**確認する属性**] で、[**タイプ**] ドロップダウンメニューから [**キューメトリクス**] を選択します。

1. [**属性**] で [**キューに保存された問い合わせ**] を選択します。

1. 条件を使用して問い合わせをルーティングするには、[**別の条件の追加**] を選択します。

   デフォルトでは、[**問い合わせ属性を確認する**] ブロックには、単一の条件、[**一致なし**] が含まれています。ブランチで定義した条件と一致するものがない場合、[**一致なし**] ブランチをたどります。

1. [**チェックする条件**] の下で、ドロップダウンメニューで条件の演算子として [**未満**] を選択し、次に、値フィールドに 5 を入力します。

1. [**別の条件の追加**] を選択し、次に、ドロップダウンメニューから [**以上**]からを選択し、値フィールドに 5 を入力します。

1. **[Save]** (保存) を選択します。

   [**問い合わせ属性を確認する**] ブロックに 2 つの新しい出力ブランチが表示されます。

これで、フローにブロックを追加して、必要に応じて問い合わせをルーティングできます。例えば、5 つ未満のブランチを [**キューへ転送**] ブロックに接続し、現在キューに入っているコールが 5 件より少ないときに、コールをキューに転送します。5 つを超えるブランチは、[顧客のコールバック番号を設定] ブロックに接続し、顧客が保留されたままにならないように、[**キューへ転送**] ブロックを使用してコールをコールバックキューに転送します。

## キューメトリクスに基づいて問い合わせをルーティングする
<a name="route-based-on-queue-metrics"></a>

多くのコンタクトセンターでは、キューで待機している問い合わせの数に基づいて顧客をルーティングします。このトピックでは、次の図のようなフローを設定する方法について説明します。Success ブランチによって接続された 3 つのフローブロック、つまり、**[コンタクト属性の設定]**、**[キューメトリクスの取得]**、**[コンタクト属性の確認]** を示しています。

![\[3 つのフローブロックを備えたフローデザイナー。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-metrics-specify-set-contact-attributes.png)


1. [コンタクト属性の設定](set-contact-attributes.md) ブロックをフローに追加します。

1. [コンタクト属性の設定](set-contact-attributes.md) で、チャンネルを指定します。テキストを使用してチャネルを動的に設定する場合は、次の図に示すように、属性値として [**Voice**] または [**Chat**] と入力します (この値は大文字と小文字が区別されません)。  
![\[[コンタクト属性の設定] ブロックの [プロパティ] ページ。名前空間は [ユーザー定義] に設定され、[値] は [チャット] に設定されています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-metrics-properties2.png)

1. [メトリクスの取得](get-queue-metrics.md) ブロックをフローに追加します。

 [キューメトリクスを取得する] ブロック内の動的属性では、返すことができるメトリクスは 1 つのチャネルのみです。

## [キューメトリクスを取得する] ブロックの後に [問い合わせ属性を確認する] ブロックを追加する
<a name="get-metrics-tips2"></a>

[**キューメトリクスの取得**] ブロックの後に [[コンタクト属性を確認する](check-contact-attributes.md)] ブロックを追加し、返されたメトリクスに基づいて分岐を行います。以下のステップを使用します。

1. [**キューメトリクスの取得**] の後、[**問い合わせ属性を確認する**] ブロックを追加します。

1. [**問い合わせ属性を確認する**] ブロックで、[**確認する属性**] を [**キューメトリクス**] に設定します。

1. **[確認する属性]** ドロップダウンボックスで、次のキューメトリクスが **[キューメトリクスの取得]** ブロックによって返されていることがわかります。ルーティングの決定に使用するメトリクスを選択します。  
![\[[コンタクト属性の確認] ブロックの [プロパティ] ページ、[名前空間] は [キューメトリクス] に設定されています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-metrics-block-returned-metrics.png)

1. [**条件を追加**] をクリックして、ルーティング決定のための比較を入力します。次の画像は、キュー内のコンタクトが 5 を超えているかどうかを確認するように設定されたブロックを示しています。  
![\[[確認する属性] セクション、[確認する条件] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-metrics-check-attributes-block.png)

# コンタクトセンターへの問い合わせ方法に基づいて、問い合わせの経験をパーソナライズする
<a name="use-channel-contact-attribute"></a>

顧客のエクスペリエンスは、顧客が問い合わせに使用するチャネルに基づいてパーソナライズできます。次に操作方法を示します。

1. フローの先頭に **[コンタクト属性の確認]** ブロックを追加します。

1. 次の画像に示すように、ブロックを設定します。**[確認する属性]** セクションで、**[タイプ]** を **[システム]** に設定し、**[属性]** を **[チャネル]** に設定します。**[確認する条件]** セクションで、**[CHAT に等しい]** に設定します。  
![\[[チャネル] に設定された [確認する属性] セクション、[チャット] に設定された [確認する条件] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/channel-attribute.png)

1. 次の設定された [コンタクト属性の確認] ブロックの画像は、**[チャット]** と **[一致なし]** の 2 つのブランチを示しています。顧客がチャットを通じて連絡をとっている場合は、次の処理を指定します。顧客がコールを通じて連絡をとっている場合 (一致なし)、フローの次のステップを指定します。  
![\[設定済みの [コンタクト属性の確認] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/channel-attribute-flow.png)

# Amazon Lex と属性値を使用する
<a name="attribs-cust-input-lex-bot"></a>

[**顧客の入力を取得する**] ブロックの属性を参照しており、入力の収集方法として Amazon Lex を選択している場合には、Amazon Lex ボットと顧客間の対話の出力から属性値が取得および保存されます。Amazon Lex ボットで使用されるインテントあるいはスロットごとの属性、およびボットに関連付けられているセッション属性を使用できます。含めるインテントごとに出力ブランチがブロックに追加されます。ボットとやり取りしているときにユーザーがインテントを選択したとき、そのインテントに関連付けられたブランチは、フローでフォローされます。

使用でき、Lex ボットからの返送が可能な Amazon Lex 属性のリストについては、「[Amazon Lex 問い合わせ属性](connect-attrib-list.md#attribs-lex-table)」を参照してください。

# Amazon Lex ボットを使用して顧客の入力を取得する


1. 既存のフローを開くか、新しく作成します。

1. [**操作**] の下で、[**顧客の入力を取得する**] ブロックをデザイナーにドラッグします。

1. ブロックの設定を表示するブロックのタイトルを選択し、[**テキスト読み上げ機能 (アドホック)**] を選択します。

1. [**テキストの入力**] を選択してから、顧客のメッセージまたは挨拶として使用される [**話すテキストを入力する**] フィールドにテキストを入力します。例えば、「お電話ありがとうございます」の後にリクエストを続け、Amazon Lex ボット内で定義してあるインテントを埋めるための情報を入力するように求めます。

1. [**Amazon Lex**] タブを開き、ドロップダウンメニューから、顧客入力の取得に使用する Amazon Lex ボットを選択します。

1. デフォルトでは、[**エイリアス**] フィールドには \$1LATEST が入力されます。ボットの別のエイリアスを使用するには、使用するエイリアスの値を入力します。
**重要**  
実稼働環境では、Amazon Lex の **TestBotAlias**、ならびに Amazon Lex Classic の **\$1LATEST** には、常に異なるエイリアスを使用します **TestBotAlias** と **\$1LATEST** では、Amazon Lex ボットへの同時呼び出し数のサポートに制限があります。詳細については、「[ランタイムクォータ](https://docs.aws.amazon.com/lexv2/latest/dg/quotas.html#quotas-service)」または「[Runtime Service Quotas (Amazon Lex Classic)](https://docs.aws.amazon.com/lex/latest/dg/gl-limits.html#gl-limits-runtime)」を参照してください。

1. オプションで、セッション属性として使用するために Amazon Lex に属性を渡す場合には、[**属性の追加**] をクリックします。テキストまたは属性を使用して、渡す値を指定します。

1. カスタマーインテントに基づいてブロックからブランチを作成するには、[**インテントの追加**] を選択し、ボットのインテント名とまったく同じようにインテントの名前を入力します。

1. **[保存]** を選択します。

# Amazon Lex で他のインテント属性を使用する
<a name="alternate-intent-attributes"></a>

通常は、優勢な Lex インテントで分岐するようにフローを設定します。ただし、状況によっては、代替インテントで分岐できます。これは、顧客が意味していたかもしれない事項です。

次の画像は、**[コンタクト属性の確認]** ブロックの **[プロパティ]** ページを示しています。Lex 属性を確認するように設定されています。

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


1. **[Intent name]** (インテント名) は、Lex の代替インテントの名前です。この場合は、大文字と小文字が区別され、Lex の内容と正確に一致する必要があります。

1. **[Intent Attribute]** (インテント属性) は、Amazon Connect がチェックするものです。この例では、**[Intent Confidence Score]** (インテント信頼スコア) を確認します。

1. **[Conditions to check]** (チェックする条件): Lex が 70% の信頼度で、顧客が優勢なインテントではなく代替インテントを企図していると判断する場合、分岐します。

# フローブロックが Amazon Lex セッション属性を使用する方法
<a name="how-to-use-session-attributes"></a>

顧客がボットとの会話を開始すると、Amazon Lex により*セッション*が作成されます。*セッション属性* (*Lex 属性*とも呼ばれます) を使用すると、セッション中にボットと Amazon Connect の間で情報を渡すことができます。使用可能な Amazon Lex 属性のリストについては、「[Amazon Lex 問い合わせ属性](connect-attrib-list.md#attribs-lex-table)」を参照してください。

## セッション属性のライフサイクル
<a name="session-attribute-lifecycle"></a>

各会話は 1 セットのセッション属性を含みます。 AWS Lambda 関数が呼び出されて何らかの処理が行われる場合、Amazon Lex は次の順序で属性を実行します。
+ サービスデフォルト: これらの属性は、属性が定義されていない場合にのみ使用されます。
+ Amazon Connect によって提供されるセッション属性: これらの属性は [顧客の入力を取得する](get-customer-input.md) ブロック内で定義されます。
+ Lambda によって提供されて事前の定義をすべて上書きするセッション属性: AWS Lambda 関数が呼び出され、何らかの処理が行われると、 [顧客の入力を取得する](get-customer-input.md) ブロックで設定されたすべてのセッション属性が上書きされます。

例えば、顧客が、**自動車**が欲しいと言及したとします。これは、最初のセッション属性として、プロセス全体に適用されます。車種について質問されると、顧客は**高級車**と答えます。この 2 番目の発言は、最初の発言で行われた Lambda 処理を上書きします。

セッション属性を処理する Lambda 関数の作成方法については、*Amazon Lex 開発者ガイド*の「[Step 1: Create a Lambda Function](https://docs.aws.amazon.com/lex/latest/dg/gs2-prepare.html)」を参照してください。Amazon Lex V2 の詳細については、「[セッション属性を設定する](https://docs.aws.amazon.com/lexv2/latest/dg/context-mgmt-session-attribs.html)」を参照してください。

Amazon Lex が Lambda 関数に提供するイベントデータの構造については、*Amazon Lex 開発者ガイド*の「[Lambda Function Input Event and Response Format](https://docs.aws.amazon.com/lex/latest/dg/lambda-input-response-format.html)」を参照してください。Amazon Lex V2 の詳細については、「[入力イベント形式の解釈](https://docs.aws.amazon.com/lexv2/latest/dg/lambda-input-format.html)」を参照してください。

## Lex セッション属性をサポートするフローブロック
<a name="blocks-support-lex-session-attributes"></a>

Lex ボットが呼び出されたときに、次のフローブロックで Lex セッション属性を使用できます。
+  [ルーティングの優先度/時間を変更する](change-routing-priority.md) 
+  [コンタクト属性を確認する](check-contact-attributes.md) 
+  [顧客の入力を取得する](get-customer-input.md) 
+  [AWS Lambda 関数](invoke-lambda-function-block.md) 
+  [ループ](loop.md) 
+  [コールバック番号を設定する](set-callback-number.md) 
+  [コンタクト属性の設定](set-contact-attributes.md) 
+  [お客様キューフローの設定](set-customer-queue-flow.md) 
+  [切断フローの設定](set-disconnect-flow.md) 
+  [保留フローの設定](set-hold-flow.md) 
+  [ログ記録動作の設定](set-logging-behavior.md) 
+  [ウィスパーフローの設定](set-whisper-flow.md) 
+  [作業キューの設定](set-working-queue.md) 
+  [フローへの転送](transfer-to-flow.md) 
+  [電話番号への転送](transfer-to-phone-number.md) 
+  [待機](wait.md) 

### 詳細情報
<a name="more-info-attributes"></a>

Amazon Lex セッション属性の使用についての詳細は、*Amazon Lex V1 デベロッパーガイド*の「[会話コンテキストの管理](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html)」を参照してください。

# 音声とチャットに同じ Amazon Lex ボットを使用する方法
<a name="one-bot-voice-chat"></a>

音声とチャットに同じボットを使用できます。ただし、チャンネルに応じてボットの反応を異なるものにすることができます。例えば、音声の SSML を返して、番号を電話番号として読み取るが、通常のテキストをチャットに戻したいとします。これを行うには、**チャネル**属性を渡します。

1. **[顧客の入力を取得する]** ブロックで **[Amazon Lex]** タブを選択します。

1. **[Session attributes]** (セッション属性) で、**[Add an attribute]** (属性の追加) を選択します。**[Destination key]** (宛先キー) ボックスに「**phoneNumber**」と入力します。**[Set dynamically]** (動的に設定) を選択します。次の図に示すように、**[名前空間]** ボックスで **[システム]** を選択し、**[値]** ボックスで **[顧客の電話番号]** を選択します。  
![\[[顧客入力を取得] ブロックの [プロパティ] ページ、[セッション属性] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/session_attributes_customer_number.png)

1. **[Add an attribute]** (属性の追加) を再度選択します。

1. **[Set dynamically]** (動的に設定) を選択します。**[Destination key]** (宛先キー) ボックスに「**callType**」と入力します。次の図に示すように、**[名前空間]** ボックスで **[システム]** を選択し、**[値]** ボックスで **[チャネル]** を選択します。  
![\[[動的に設定] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/session_attributes_call_type_channel.png)

1. **[保存]** を選択します。

1. Lambda 関数では、着信イベントの `SessionAttributes` フィールドでこの値にアクセスできます。

# Lambda 関数の値を Amazon Connect の問い合わせ属性として保存する
<a name="attribs-with-lambda"></a>

注文システムや Lambda 関数を使用した他のデータベースなど、組織内部が使用するシステム  からデータを取得して、後からフローで参照できる属性としてその値を保存します。

内部システムから Lambda 関数が返す応答は、キーと値のペアからなるデータです。戻り値は外部名前空間で参照できます。例えば、`$.External.attributeName`。後からフローで属性を使用するには、**[問い合わせ属性の設定]** ブロックを使って、キーと値のペアをユーザー定義属性にコピーできます。その後で、[**問い合わせ属性を確認する**] ブロックを使用し、属性値に基づいて問い合わせをブランチするロジックを定義できます。Lambda 関数から取得された問い合わせ属性は、他の Lambda 関数を呼び出すと上書きされます。後からフローで外部属性を参照する場合は、外部属性を保存します。

**ヒント**  
フローから Lambda 関数を呼び出す方法については、「[AWS Lambda 関数へのアクセスを Amazon Connect に許可する](connect-lambda-functions.md)」を参照してください。このトピックでは、Lambda 関数のレスポンスを使用する方法も説明しています。

**Lambda 関数が返す外部の値を、問い合わせ属性として保存する**

1. Amazon Connectで、**[Routing]** (ルーティング)、**[Contact flows]** (問い合わせフロー) の順にクリックします。

1. 既存のフローを選択するか、新しく作成します。

1. [[AWS Lambda 関数](invoke-lambda-function-block.md)] ブロックを追加し、ブロックのタイトルを選択してブロックの設定を開きます。

1. 内部システムから顧客データを取得する関数に AWS Lambda 関数 **ARN** を追加します。

1. [[AWS Lambda 関数](invoke-lambda-function-block.md)] ブロックの後に **[コンタクト属性の設定]** ブロックを追加し、それに [[AWS Lambda 関数](invoke-lambda-function-block.md)] ブロックの **[成功]** ブランチを接続します。

1. **[コンタクト属性の設定]** ブロックを編集し、**[属性を使用]** を選択します。

1. [**宛先キー**] に、customerName など、属性の参照として使用する名前を入力します。これが、この属性を他のブロックで参照するときに [**属性**] フィールドで使用する値です。

1. **[Type]** (タイプ) の場合、**[External]** (外部) を選択します。

1. **[Attribute]** (属性) には、Lambda 関数から返された属性の名前を入力します。関数から返される属性の名前は、内部システムと使用する関数によって異なります。

フローでこのブロックが実行された後、値はユーザー定義属性として、**[宛先キー]** で指定された名前で保存されます。この場合は *customerName* です。これは、動的な属性を使用するブロックでアクセスできます。

アカウント番号などの外部属性の値に基づいてフローをブランチするには、**[Check contact attributes]** (問い合わせ属性を確認する) ブロックを使用し、その後で属性の値を比較する条件を追加します。次に、条件に基づいてフローをブランチします。

****

1. [**問い合わせ属性を確認する**] ブロックの [**確認する属性**] で次のいずれかを実行します。
   + [**タイプ**] として [**外部**] を選択し、Lambda 関数から返されたキー名を [**属性**] フィールドに入力します。
**重要**  
 AWS Lambda 関数から返された属性は、他の Lambda 関数を呼び出すと上書きされます。フローで後から属性を参照するには、ユーザー定義属性として保存します。
   + **[タイプ]** で **[ユーザー定義]** を選択し、**[属性]** フィールドには、**[コンタクト属性の設定]** ブロックで **[宛先キー]** として指定した名前を入力します。

1. **[Add another condition]** (別の条件を追加) を選択します。

1. [**チェックする条件**] の下で、条件に対する演算子を選択し、属性値と比較する値を入力します。入力した比較ごとにブロックがブランチを作成し、指定した条件に基づいてコンタクトをルーティングします。一致する条件がない場合、問い合わせはブロックから [**一致なし**] ブランチを取ります。