説明サポートされるチャネルフロータイププロパティ属性を参照する方法属性が 32 KB を上回る場合に起きること設定のヒント設定されているブロックサンプルフローシナリオ

Amazon Connect のフローブロック: 問い合わせ属性を設定する

このトピックでは、キーと値のペアを問い合わせ属性として保存し、後でフローで参照される値を設定するフローブロックを定義します。

説明

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

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

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

問い合わせ属性の詳細については、「Amazon Connect で問い合わせ属性を使用する」を参照してください。

サポートされるチャネル

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

Channel	サポート対象?
音声	可能
チャット	可能
タスク	可能

フロータイプ

このブロックは、次のフロータイプで使用できます。

すべてのフロー

プロパティ

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

以下の項目について属性を設定できます。

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

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

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

属性を参照する方法

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

Lambda での例

Lambda 関数ルックアップから顧客名を参照するには、$.External. を使用しAttributeKey、を Lambda 関数から返された属性のキー (または名前) AttributeKey に置き換えます。
Lambda 関数で Amazon Connect プロンプトを使用するには、プロンプトARNのユーザー定義属性をに設定し、Lambda 関数からその属性にアクセスします。

Amazon Lex での例

Amazon Lex ボットから属性を参照するには、形式 $.Lex. を使用し、参照する Amazon Lex ボットの $.Lex などの部分を含めますIntentName。
カスタマー入力を Amazon Lex ボットスロットに参照するには、$.Lex.Slots. を使用しslotName、をボット内のスロットの名前slotNameに置き換えます。

属性が 32 KB を上回る場合に起きること

属性のサイズ上限は 32 KB (コンタクトレコード属性セクションの最大サイズ) です。コンタクトの属性が 32 KB を上回ると、そのコンタクトは [エラー] ブランチにルーティングされます。対策として、次の選択肢を検討してください。

不要な属性は値を空にして削除する。
属性が 1 つのフローでのみ使用されていて、そのフローの外部 (例えば、Lambda や別のフロー) から参照する必要がない場合は、フロー属性を使用する。この方法なら、複数のフロー間で 32 KB 分の情報を無駄に保持する事態を避けられます。

設定のヒント

ユーザー定義の宛先キーを使用する場合は、任意の名前を付けることができますが、$ および . (ピリオド) 文字は使用できません。これらはどちらもで属性パスを定義するために使用されるため、許可されませんJSONPath。
Amazon Lex V2 ボットに必要な言語属性は、[Set contact attribute] (コンタクト属性の設定) ブロックを使用して設定することができます。(Amazon Connect の言語属性は、Amazon Lex V2 ボットの構築に使用した言語モデルと一致している必要があります。) 次の画像は、スペイン語に設定された言語属性を示しています。

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