Amazon Connect のフローブロック: 顧客プロファイル

• 顧客プロファイルを取得、作成、および更新できます。

  • 最大 5 つの任意の検索識別子を使用してプロファイルを取得するようにブロックを設定できます。

• 顧客プロフィールのオブジェクトと計算属性を取得できます。

  • 任意の検索識別子を使用してオブジェクトを取得するようにブロックを設定できます。

  • このブロックではプロファイル ID を指定する必要があります。[profileID] は手動で指定することも、[プロフィールを取得] アクションを使用してプロファイルを検索した後に Customer 名前空間に保存された profileID を使用することもできます。

• 音声、チャット、タスクなどのコンタクトを既存の顧客プロファイルに関連付けることができます。

• 顧客プロファイルデータが取得されると、この [レスポンスフィールド] が顧客のコンタクト属性に保存され、その後のブロックで利用できるようになります。

• $.Customer. JSONPath を使用して [レスポンスフィールド] を参照することもできます。　例えば、$.Customer.City や $.Customer.Asset.Status を使用します。

• 以下の例では、このブロックの使用例を示します。

  • サポートされているプロファイルフィールドを参照して、パーソナライズされた通話またはチャットエクスペリエンスを提供するために、プロファイルの取得後、プロンプトの再生 ブロックを使用します。

  • プロファイルデータを取得した後に コンタクト属性を確認する ブロックを使用して、この値に基づいてコンタクトを送信します。

  • 詳細については、「フロー全体でフィールドを保持する方法」を参照してください。

• すべてのフロータイプ

• このブロックを使用する前に、Amazon Connect インスタンスで Customer Profiles が有効になっていることを確認してください。手順については、「Amazon Connect Customer Profiles の使用」を参照してください。

• 問い合わせは、次の状況で [Error] (エラー)ブランチへルーティングされます。

  • Amazon Connect インスタンスで Customer Profiles 機能が有効になっていない。

  • リクエストデータの値が有効になっていない。リクエスト値は 255 文字を超えることはできません。

  • Customer Profiles API リクエストがスロットリングされている。

  • Customer Profiles に可用性の問題がある。

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

• プロフィールを取得

• プロファイルの作成

• プロフィールを取得

• プロファイルオブジェクトを取得

• 計算属性を取得

• 連絡先をプロフィールに関連付ける

• 少なくとも 1 つの検索識別子を指定する必要があります。最大 5 つの検索識別子を指定できます。

• 複数の検索識別子を指定する場合は、[AND] または [OR] のいずれかの論理演算子を 1 つ指定する必要があります。論理演算子は、次のいずれかの式など、すべての検索識別子に適用されます。

  • (a と b と c)

  • (x OR y OR z)

• 後続のブロックに保持する属性を定義して、[レスポンスフィールド] のコンタクトの属性に保存します。

• コンタクトは、次の分岐に送信できます。

  • 成功: プロファイルが 1 つ見つかりました。[レスポンスフィールド] はコンタクトの属性に保存されます。

  • エラー: プロファイルの検索中にエラーが発生しました。これは、システムエラーまたは [プロフィールを取得] の設定方法が原因である可能性があります。

  • 複数見つかりました: 複数のプロファイルが見つかりました。

  • 見つかりません: プロファイルが見つかりませんでした。

• プロファイルの作成時に [リクエストフィールド] に入力する属性を指定します。

• 後続のブロックに保持する属性を定義して、[レスポンスフィールド] のコンタクトの属性に保存します。

• 成功: プロファイルの作成が正常に完了し、[レスポンスフィールド] がコンタクトの属性に保存されました。

• エラー: プロファイルの作成プロセス中にエラーが発生しました。システムエラーまたはプロファイルの作成アクションの設定ミスが原因である可能性があります。

• [プロフィールを更新] ブロックを使用する前に、以下の画像のとおり [プロフィールを取得] ブロックを使用します。[プロフィールを取得] ブロックを使用して、更新する特定のプロフィールを検索します。

  

• プロフィールを更新する属性と値を [リクエストフィールド] と [フィールド値をリクエスト] で指定します。

• 後続のブロックに保持する属性を定義して、[レスポンスフィールド] のコンタクトの属性に保存します。

• 成功: プロファイルの更新が正常に完了し、[レスポンスフィールド] がコンタクトの属性に保存されました。

• エラー: プロファイルの更新中にエラーが発生しました。このエラーは、システムエラーまたは [プロフィールを更新] アクションの設定ミスが原因である可能性があります。

• 必須プロファイル ID: このブロックが機能するにはプロファイル ID が必要です。[プロファイルオブジェクトを取得] アクションは、指定された [ProfileID] に関連付けられたオブジェクトを取得します。前述の Get profile ブロックを使用して ProfileID を指定してください。Get profile ブロックを使用して特定のプロファイルを特定してから、次のブロックでプロファイルのオブジェクトを取得します。

  • プロファイル ID については、手動で入力するか、事前定義またはユーザー属性に保存されている定義済みの値を使用するかを選択できます。

    次の図は、プロファイルを取得してセグメントメンバーシップを確認するように設定されたフローの例を示しています。

    

• セグメントの値を指定する必要があります。セグメントを手動で選択するか、事前定義された属性またはユーザー属性に保存されている事前定義された値を使用して動的に設定できます。

• セグメントを動的に設定するときは、顧客セグメントの識別子を参照する属性を指定します。識別子は、セグメント詳細の表示ページまたは Customer Profiles API の ListSegmentDefinitions オペレーションの SegmentDefinitionName で確認できます。 ListSegmentDefinitions

  次の図は、セグメントの詳細の表示ページでのセグメント ID の場所を示しています。

  

• 次の図は、セグメントメンバーシップを確認する例を示しています。プロファイル ID は動的にチェックされ、セグメントは手動でチェックされるように設定されます。

  

コンタクトは、次の分岐に送信できます。

• セグメント内: プロファイルは顧客セグメントに属します。

• セグメントにない: プロファイルは顧客セグメントに属していません。

• エラー: セグメントメンバーシップの確認中にエラーが発生しました。これは、システムエラーまたはセグメントメンバーシップの確認アクションの設定ミスが原因である可能性があります。フローエラーのログ記録の詳細については、「」を参照してくださいAmazon CloudWatch ロググループで Amazon Connect フローログを有効にする。

• 必須プロファイル ID: このブロックが機能するにはプロファイル ID が必要です。[プロファイルオブジェクトを取得] アクションは、指定された [ProfileID] に関連付けられたオブジェクトを取得します。次の画像のとおり、前の [プロフィールを取得] ブロックを使用して [ProfileID] を指定していることを確認します。後続のブロックでプロファイルオブジェクトの取得に進む前に、[プロフィールを取得] ブロックを使用して個別のプロファイルを特定します。

  • プロファイル ID については、手動で入力するか、事前定義またはユーザー属性に保存されている定義済みの値を使用するかを選択できます。

  

• 情報を取得するオブジェクトタイプを指定する必要があります。

• オブジェクトを取得するには、次のオプションのいずれかを選択する必要があります。

  • 最新のプロファイルオブジェクトを使用: このオプションを使用すると、常に最新のオブジェクトが取得されます。

  • 検索識別子を使用: このオプションを使用すると、指定した検索識別子を使用してオブジェクトが検索されて取得されます。

• 後続のブロックに保持する属性を定義して、[レスポンスフィールド] のコンタクトの属性に保存します。

• 成功: プロファイルオブジェクトの特定が正常に完了し、[レスポンスフィールド] がコンタクトの属性に保存されました。

• エラー: プロファイルオブジェクトの取得中にエラーが発生しました。このエラーは、システムエラーまたは [プロフィールを取得] アクションの設定ミスが原因である可能性があります。

• 見つかりません: オブジェクトが見つかりませんでした。

• 必須プロファイル ID: このブロックが機能するにはプロファイル ID が必要です。[計算属性を取得] アクションは、指定された [ProfileID] に関連付けられたオブジェクトを取得します。次の画像のとおり、前の [プロフィールを取得] ブロックを使用して [ProfileID] を指定していることを確認します。Get profile ブロックを使用して特定のプロファイルを特定してから、次のブロックでプロファイルの計算属性を取得します。

  • プロファイル ID については、手動で入力するか、事前定義またはユーザー属性に保存されている定義済みの値を使用するかを選択できます。

  

• 後続のブロックに保持する属性を定義して、[レスポンスフィールド] のコンタクトの属性に保存します。

  • [レスポンスフィールド] のオプションは、Customer Profiles ドメインのために定義される計算属性の定義です。

  • 計算属性の定義でしきい値が使用されている場合、計算属性値はブール値であり、True/False のいずれかを返します。これ以外の場合は、数値または文字列値が返されます。計算属性の戻り値は、[等しい]、[次を超える]、[次未満]、[次を含む] などの条件を使用して、[コンタクト属性を確認する] ブロックで分岐目的で使用できます。

• 成功: 計算属性が特定され、レスポンスフィールドがコンタクトの属性に保存されます。

• エラー: 計算属性の取得中にエラーが発生しました。このエラーは、システムエラーまたは [計算属性を取得] アクションの設定ミスが原因である可能性があります。

• 見つかりません: 計算属性が見つかりませんでした。

• 次の画像に示されるとおり、[連絡先をプロフィールに関連付ける] 前に、[プロフィールを取得] ブロックを追加します。[プロフィールを取得] ブロックを使用してまずプロフィールを検索し、次のブロックでコンタクトとプロファイルを関連付けます。

• 必須プロファイル ID: このブロックが機能するにはプロファイル ID が必要です。次の画像のとおり、前の [プロフィールを取得] ブロックを使用して [ProfileID] を指定していることを確認します。[プロフィールを取得] ブロックを使用して、次のブロックでコンタクトを関連付ける個別のプロファイルを特定します。

  • プロファイル ID については、手動で入力するか、事前定義またはユーザー属性に保存されている定義済みの値を使用するかを選択できます。

  

• コンタクト ID の値を指定する必要があります。

• 成功: 連絡先をプロフィールに関連付けました。

• エラー: 連絡先のプロフィールへの関連付け中にエラーが発生しました。このエラーは、システムエラーまたは [連絡先をプロフィールに関連付ける] アクションの設定ミスが原因である可能性があります。