翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Connect のフローブロック: 顧客プロファイル
このトピックでは、顧客プロファイルを取得、作成、更新するためのフローブロックを定義します。
## 説明
+ 顧客プロファイルを取得、作成、および更新できます。
+ 最大 5 つの任意の検索識別子を使用してプロファイルを取得するようにブロックを設定できます。
+ 顧客プロフィールのオブジェクトと計算属性を取得できます。
+ 任意の検索識別子を使用してオブジェクトを取得するようにブロックを設定できます。
+ このブロックではプロファイル ID を指定する必要があります。**[profileID]** は手動で指定することも、**[プロフィールを取得]** アクションを使用してプロファイルを検索した後に Customer 名前空間に保存された **profileID** を使用することもできます。
+ 音声、チャット、タスクなどのコンタクトを既存の顧客プロファイルに関連付けることができます。
+ 顧客プロファイルデータが取得されると、この **[レスポンスフィールド]** が[顧客のコンタクト属性](connect-attrib-list.md#customer-profiles-attributes)に保存され、その後のブロックで利用できるようになります。
+ `$.Customer.` JSONPath を使用して **[レスポンスフィールド]** を参照することもできます。 例えば、`$.Customer.City` や `$.Customer.Asset.Status` を使用します。
+ 以下の例では、このブロックの使用例を示します。
+ サポートされているプロファイルフィールドを参照して、パーソナライズされた通話またはチャットエクスペリエンスを提供するために、プロファイルの取得後、[プロンプトの再生](play.md) ブロックを使用します。
+ プロファイルデータを取得した後に [コンタクト属性を確認する](check-contact-attributes.md) ブロックを使用して、この値に基づいてコンタクトを送信します。
+ 詳細については、「[フロー全体でフィールドを保持する方法](#customer-profiles-block-persist-fields)」を参照してください。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ すべてのフロータイプ
## 設定のヒント
+ このブロックを使用する前に、Amazon Connect インスタンスで Customer Profiles が有効になっていることを確認してください。手順については、「[Amazon Connect Customer Profiles の使用](customer-profiles.md)」を参照してください。
+ 問い合わせは、次の状況で **[Error]** (エラー)ブランチへルーティングされます。
+ Amazon Connect インスタンスで Customer Profiles 機能が有効になっていない。
+ リクエストデータの値が有効になっていない。リクエスト値は 255 文字を超えることはできません。
+ Customer Profiles API リクエストがスロットリングされている。
+ Customer Profiles に可用性の問題がある。
+ [Customer Profiles のコンタクト属性](connect-attrib-list.md#customer-profiles-attributes)の合計サイズは、フロー全体で 14,000 文字 (各最大サイズを 255 と想定すると属性 56 個) に制限されます。これには、フロー中に Customer Profiles の **[レスポンスフィールド]** として保持されるすべての値が含まれます。
## プロパティ
Customer Profiles フローブロックでは、次のプロパティタイプを使用できます。
+ **[プロフィールを取得](#customer-profiles-block-properties-get-profile)**
+ **[プロファイルの作成](#customer-profiles-block-properties-create-profile)**
+ **[プロフィールを取得](#customer-profiles-block-properties-update-profile)**
+ **[プロファイルオブジェクトを取得](#customer-profiles-block-properties-get-profile-object)**
+ **[計算属性を取得](#customer-profiles-block-properties-get-calculated-attributes)**
+ **[連絡先をプロフィールに関連付ける](#customer-profiles-block-properties-associate.title)**
## プロパティ: プロファイルを取得
プロパティを **[プロフィールを取得]** に設定する場合は、次の点を考慮します。
+ 少なくとも 1 つの検索識別子を指定する必要があります。最大 5 つの検索識別子を指定できます。
+ 複数の検索識別子を指定する場合は、**[AND]** または **[OR]** のいずれかの論理演算子を 1 つ指定する必要があります。論理演算子は、次のいずれかの式のように、すべての検索識別子に適用されます。
+ (a **AND** b **AND** c)
+ (x **OR** y **OR** z)
+ 後続のブロックに保持する属性を定義して、**[レスポンスフィールド]** のコンタクトの属性に保存します。
+ コンタクトは、次の分岐に送信できます。
+ **成功:** プロファイルが 1 つ見つかりました。[レスポンスフィールド] はコンタクトの属性に保存されます。
+ **エラー:** プロファイルの検索中にエラーが発生しました。これは、システムエラーまたは **[プロフィールを取得]** の設定方法が原因である可能性があります。
+ **複数見つかりました:** 複数のプロファイルが見つかりました。
+ **見つかりません:** プロファイルが見つかりませんでした。
次の画像は、**[プロフィールを取得]** アクション向けに設定された Customer Profiles の **[プロパティ]** ページの例を示しています。
サンプルブロックは、発信者の**電話番号**と一致するプロファイル、または「Account」というユーザー定義属性に保存されているのと同じ**アカウント**番号を共有するプロファイルを検索するように設定されています。1 つのプロファイルが見つかると、この特定の顧客のコンタクト属性に**レスポンスフィールド**として、**AccountNumber**、**FirstName**、**LastName**、**PhoneNumber**、**Attributes.LoyaltyPoints** が保存されます。
![\[Customer Profiles GetProfile ブロックのプロパティページ\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-block-properties-get-profile.png)
## プロパティ: プロファイルの作成
プロパティを **[プロファイルの作成]** に設定する場合は、次の点を考慮します。
+ プロファイルの作成時に **[リクエストフィールド]** に入力する属性を指定します。
+ 後続のブロックに保持する属性を定義して、**[レスポンスフィールド]** のコンタクトの属性に保存します。
コンタクトは、次の分岐にルーティングできます。
+ **成功:** プロファイルの作成が正常に完了し、**[レスポンスフィールド]** がコンタクトの属性に保存されました。
+ **エラー:** **プロファイルの作成**プロセス中にエラーが発生しました。システムエラーまたはプロファイルの作成アクションの設定ミスが原因である可能性があります。
次のサンプルブロックは、**PhoneNumber** と「Language」というカスタム属性を持つプロファイルを作成するように設定されています。プロファイルの作成後、**[Attributes.Language]** レスポンスフィールドはコンタクトの属性に保存されて、以降のブロックで使用できるようになります。
![\[Customer Profiles CreateProfile ブロックのプロパティページ\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-block-properties-create-profile.png)
## プロパティ: プロフィールを更新
プロパティを **[プロフィールを更新]** に設定する場合は、次の点を考慮します。
+ **[プロフィールを更新]** ブロックを使用する前に、以下の画像のとおり **[プロフィールを取得]** ブロックを使用します。**[プロフィールを取得]** ブロックを使用して、更新する特定のプロフィールを検索します。
![\[Customer Profiles UpdateProfile ブロックのプロパティページ\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-block-properties-update-profile-1.png)
+ プロフィールを更新する属性と値を **[リクエストフィールド]** と **[フィールド値をリクエスト]** で指定します。
+ 後続のブロックに保持する属性を定義して、**[レスポンスフィールド]** のコンタクトの属性に保存します。
コンタクトは、次の分岐にルーティングできます。
+ **成功:** プロファイルの更新が正常に完了し、**[レスポンスフィールド]** がコンタクトの属性に保存されました。
+ **エラー:** プロファイルの更新中にエラーが発生しました。このエラーは、システムエラーまたは **[プロフィールを更新]** アクションの設定ミスが原因である可能性があります。
次に表示されているブロックは、**[MailingAddress1]** とユーザーの入力を値として使用してプロフィールを更新するように設定されています。プロファイルの更新後、**[MailingAddress1]** レスポンスフィールドはコンタクトの属性に保存されて、以降のブロックで使用できるようになります。
![\[Customer Profiles UpdateProfiles ブロックのプロパティページ\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-block-properties-update-profile-2.png)
## プロパティ: セグメントメンバーシップを確認
**重要**
このアクションを使用するには、Amazon Connect インスタンスで、**AmazonConnectServiceLinkedRolePolicy** または **AmazonConnectServiceCustomerProfileAccess** のいずれかのポリシーに、ListSegmentDefinitions、GetSegmentMembership、BatchGetProfile、BatchGetCalculatedAttributeForProfile の各 API に対するアクセス許可が必要です 。
**重要**
Spark SQL を使用するセグメントのセグメントメンバーシップをチェックしている場合、チェックされるセグメントは最後に作成されたセグメントであり、リアルタイムでは更新されません。lastComputedAt API 属性は、セグメントスナップショットが最後に作成された時刻を提供します。新しいセグメントスナップショットを実行して、セグメントを更新できます。4XX エラーが表示された場合は、セグメントスナップショットが作成されていることを確認してください。
**セグメントメンバーシップを確認**するようにプロパティを設定する場合は、以下の点を考慮してください。
+ **必須プロファイル ID:** このブロックが機能するにはプロファイル ID が必要です。**[プロファイルオブジェクトを取得]** アクションは、指定された **[ProfileID]** に関連付けられたオブジェクトを取得します。先行する **[プロフィールを取得]** ブロックを使用して **[プロファイル ID]** を必ず指定します。後続のブロックに移動してプロファイルオブジェクトを取得する前に、**[プロフィールを取得]** ブロックを使用して該当するプロファイルを特定します。
+ プロファイル ID については、手動で入力するか、事前定義またはユーザー属性に保存されている定義済みの値を使用するかを選択できます。
次の図は、プロファイルを取得してセグメントメンバーシップを確認するように設定されたフローの例を示しています。
![\[[プロフィールを取得] アクションと [セグメントメンバーシップを確認] アクションを示すフロー。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-block-properties-check-segment-membership-1.png)
+ セグメントの値を指定する必要があります。セグメントは、手動で選択するか、事前定義済みの属性またはユーザー属性に保存されている事前定義済みの値を使用して動的に設定できます。
+ セグメントを動的に設定する場合は、カスタマーセグメントの識別子を参照する属性を指定します。識別子を確認するには、**[セグメント詳細を表示]** ページまたは Customer Profiles API の [ListSegmentDefinitions](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListSegmentDefinitions.html) オペレーションで SegmentDefinitionName を使用できます。
次の図は、**[セグメント詳細を表示]** ページの **[セグメント ID]** の場所を示しています。
![\[[セグメント詳細] セクションの [セグメント ID]。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-block-properties-check-segment-membership-2.png)
+ 次の図は、セグメントメンバーシップを確認する例を示しています。**[プロファイル ID]** は動的に確認し、**[セグメント]** は手動で確認するように設定されています。
![\[[顧客プロファイル] ブロックは、セグメントメンバーシップを確認するように設定されています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-block-properties-check-segment-membership-3.png)
**コンタクトは、以下のブランチにルーティングできます。**
+ **セグメント内**: プロファイルは顧客セグメントに属します。
+ **セグメント内に含まれていません**: プロファイルは顧客セグメントに属していません。
+ **エラー**: セグメントメンバーシップの確認中にエラーが発生しました。システムエラーまたは **[セグメントメンバーシップを確認]** アクションの設定ミスが原因である可能性があります。フローエラーのログ記録の詳細については、「[Amazon CloudWatch ロググループで Amazon Connect フローログを有効にする](contact-flow-logs.md)」を参照してください。
## プロパティ: プロファイルオブジェクトを取得
プロパティを **[プロファイルオブジェクトを取得]** に設定する場合は、次の点を考慮します。
+ **必須プロファイル ID:** このブロックが機能するにはプロファイル ID が必要です。**[プロファイルオブジェクトを取得]** アクションは、指定された **[ProfileID]** に関連付けられたオブジェクトを取得します。次の画像のとおり、前の **[プロフィールを取得]** ブロックを使用して **[ProfileID]** を指定していることを確認します。後続のブロックに移動してプロファイルオブジェクトを取得する前に、**[プロフィールを取得]** ブロックを使用して該当するプロファイルを特定します。
+ プロファイル ID については、手動で入力するか、事前定義またはユーザー属性に保存されている定義済みの値を使用するかを選択できます。
![\[Customer Profiles GetProfileOject ブロックのプロパティページ\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-block-properties-get-profile-object-1.png)
+ 情報を取得するオブジェクトタイプを指定する必要があります。
+ オブジェクトを取得するには、次のオプションのいずれかを選択する必要があります。
+ **最新のプロファイルオブジェクトを使用:** このオプションを使用すると、常に最新のオブジェクトが取得されます。
+ **検索識別子を使用:** このオプションを使用すると、指定した検索識別子を使用してオブジェクトが検索されて取得されます。
+ 後続のブロックに保持する属性を定義して、**[レスポンスフィールド]** のコンタクトの属性に保存します。
コンタクトは、次の分岐にルーティングできます。
+ **成功:** プロファイルオブジェクトの特定が正常に完了し、**[レスポンスフィールド]** がコンタクトの属性に保存されました。
+ **エラー:** プロファイルオブジェクトの取得中にエラーが発生しました。このエラーは、システムエラーまたは **[プロフィールを取得]** アクションの設定ミスが原因である可能性があります。
+ **見つかりません:** オブジェクトが見つかりませんでした。
次に表示されるブロックは、 「Customer」名前空間に保存された **ProfileId** に関連付けられた「Asset」タイプのプロファイルオブジェクトを取得するように設定されています。この特定のシナリオでは、ブロックは Asset ID を使用してアセットを検索します。アセットが見つかると、**Asset.Price** と **Asset.PurchaseDate** がコンタクト属性に保存され、以降のブロックで使用できるようになります。
![\[Customer Profiles GetProfileObject ブロックのプロパティページ\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-block-properties-get-profile-object-2.png)
## プロパティ: 計算属性を取得
**重要**
このアクションを使用するには、Amazon Connect インスタンスに次の API に対するアクセス許可が必要です。**[AmazonConnectServiceLinkedRolePolicy]** または **[AmazonConnectServiceCustomerProfileAccess]** のいずれかのポリシーでの `ListCalculatedAttributeDefinitions` と `GetCalculatedAttributeForProfile`。
プロパティを **[計算属性を取得]** に設定する場合は、次の点を考慮します。
+ **必須プロファイル ID:** このブロックが機能するにはプロファイル ID が必要です。**[計算属性を取得]** アクションは、指定された **[ProfileID]** に関連付けられたオブジェクトを取得します。次の画像のとおり、前の **[プロフィールを取得]** ブロックを使用して **[ProfileID]** を指定していることを確認します。後続のブロックに進んでプロファイルの計算属性を取得する前に、**[プロフィールを取得]** ブロックを使用して該当するプロファイルを特定します。
+ プロファイル ID については、手動で入力するか、事前定義またはユーザー属性に保存されている定義済みの値を使用するかを選択できます。
![\[Customer Profiles GetCalculatedAttributes ブロックのプロパティページ\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-block-properties-get-calculated-attributes-1.png)
+ 後続のブロックに保持する属性を定義して、**[レスポンスフィールド]** のコンタクトの属性に保存します。
+ **[レスポンスフィールド]** のオプションは、Customer Profiles ドメインのために定義される計算属性の定義です。
+ 計算属性の定義でしきい値が使用されている場合、計算属性値はブール値であり、True/False のいずれかを返します。これ以外の場合は、数値または文字列値が返されます。計算属性の戻り値は、**[等しい]**、**[次を超える]**、**[次未満]**、**[次を含む]** などの条件を使用して、**[コンタクト属性を確認する]** ブロックで分岐目的で使用できます。
コンタクトは、次の分岐にルーティングできます。
+ **成功:** 計算属性が特定され、レスポンスフィールドがコンタクトの属性に保存されます。
+ **エラー:** 計算属性の取得中にエラーが発生しました。このエラーは、システムエラーまたは **[計算属性を取得]** アクションの設定ミスが原因である可能性があります。
+ **見つかりません:** 計算属性が見つかりませんでした。
次に表示されているブロックは、コンタクトの属性で指定された **[ProfileID]** に属する計算属性を取得するように設定されています。次の **[レスポンスフィールド]** が取得され、**[平均通話所要時間]** と **[よく入電のある発信者]** のコンタクトの属性に保存されます。
![\[Customer Profiles GetCalculatedAttributes ブロックのプロパティページ\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-block-properties-get-calculated-attributes-2.png)
## プロパティ: 連絡先をプロフィールに関連付けます。
**重要**
このアクションを使用するには、Amazon Connect インスタンスに次の API に対するアクセス許可が必要です。**[AmazonConnectServiceLinkedRolePolicy]** または **[AmazonConnectServiceCustomerProfileAccess]** のいずれかのポリシーでの `ListCalculatedAttributeDefinitions` と `GetCalculatedAttributeForProfile`。
このアクションを使用するには、セキュリティプロファイルの Customer Profiles の表示のアクセス許可も有効にする必要があります。
**[連絡先をプロフィールに関連付ける]** ようにプロパティを設定する場合は、次の点を考慮します。
+ 次の画像に示されるとおり、**[連絡先をプロフィールに関連付ける]** 前に、**[プロフィールを取得]** ブロックを追加します。**[プロフィールを取得]** ブロックを使用してまずプロフィールを検索し、次のブロックでコンタクトとプロファイルを関連付けます。
+ **必須プロファイル ID:** このブロックが機能するにはプロファイル ID が必要です。次の画像のとおり、前の **[プロフィールを取得]** ブロックを使用して **[ProfileID]** を指定していることを確認します。後続のブロックに進んでプロファイルの計算属性を取得する前に、**[プロフィールを取得]** ブロックを使用して該当するプロファイルを特定します。
+ プロファイル ID については、手動で入力するか、事前定義またはユーザー属性に保存されている定義済みの値を使用するかを選択できます。
![\[Customer Profiles AssociateContactToProfile ブロックのプロパティページ\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-block-properties-associate-1.png)
+ コンタクト ID の値を指定する必要があります。
コンタクトは、次の分岐にルーティングできます。
+ **成功:** 連絡先をプロフィールに関連付けました。
+ **エラー:** 連絡先のプロフィールへの関連付け中にエラーが発生しました。このエラーは、システムエラーまたは **[連絡先をプロフィールに関連付ける]** アクションの設定ミスが原因である可能性があります。
次のブロックは、コンタクト属性に保存されている **[プロファイル ID]** を持つプロファイルを、コンタクト属性に保存されている現在のコンタクト ID に関連付けるように設定されています。
![\[Customer Profiles AssociateContactToProfile ブロックのプロパティページ\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-block-properties-associate-2.png)
## プロパティ: プロファイルのレコメンデーションを取得する
**重要**
このアクションを使用するには、Amazon Connect インスタンスに、**AmazonConnectServiceLinkedRolePolicy** または **AmazonConnectServiceCustomerProfileAccess** のいずれかのポリシー`GetProfileRecommendations`の API に対するアクセス許可が必要です。
** プロファイルレコメンデーションの取得**ブロックをセットアップして使用する方法の詳細については、「」を参照してください[ステップ 4: カスタマーエンゲージメントチャネル全体で Predictive Insights を使用する](predictive-insights-get-started.md#use-across-customer-engagement-channels)。
## フロー全体でフィールドを保持する方法
顧客がエージェントと直接やり取りすることなく、コンタクトセンターとやり取りして、配送注文のステータスを把握できるようにしたいとします。また、以前 10 分以上の遅延したことがある顧客からの着信を優先させるとします。
このようなシナリオでは、IVR は顧客に関する関連情報を取得する必要があります。これは Customer Profiles ブロックを介して実行されます。次に、IVR は、エクスペリエンスをパーソナライズして顧客に積極的にサービスを提供するために、この顧客データをその他のフローブロックで活用する必要があります。
1. **[プロンプトの再生]** を使用して、名前を使って顧客に挨拶をしたり、状況を通知したりして、顧客のエクスペリエンスをパーソナライズできます。
![\[[プロンプトの再生] を使用して、名前を使って顧客に挨拶をしたり、状況を通知したりして、顧客のエクスペリエンスをパーソナライズできます。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-block-persist-fields-1.png)
1. **[コンタクト属性の確認]** を使用して、以前のやり取りの平均保留時間に基づいて条件付きで顧客をルーティングします。
![\[[コンタクト属性の確認] を使用して、以前のやり取りの平均保留時間に基づいて条件付きで顧客をルーティングします。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-block-persist-fields-2.png)
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]**、**[エラー]**、**[複数見つかりました]**、**[見つかりません]** の 4 つのブランチを示しています。
![\[設定された [顧客プロファイル] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/customer-profiles-block-configured.png)