翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Connect のフローデザイナーのフローブロック定義
フローブロックは、フローデザイナーでフローを作成するために使用します。フローブロックをキャンバスにドラッグアンドドロップして、フローを配置します。
次の表に、使用できるすべてのフローブロックの一覧を示します。詳細については、[Block] (ブロック) 列のブロック名を選択してください。
| ブロック | 説明 |
| --- | --- |
| [接続アシスタント](connect-assistant-block.md) | Connect AI エージェントドメインを連絡先に関連付けて、リアルタイムのレコメンデーションを有効にします。 |
| [顧客を認証](authenticate-customer.md) | Amazon Cognito と Amazon Connect Customer Profiles を活用して、顧客が認証できるようにします。 |
| [電話番号への発信](call-phone-number.md) | アウトバウンドウィスパーフローから発信通話を開始します。 |
| [事例](cases-block.md) | ケースを取得、更新、作成します。 |
| [ルーティングの優先度/時間を変更する](change-routing-priority.md) | キューに入っている問い合わせの優先度を変更します。例えば、問い合わせの問題やその他の変数に基づいてこれを行うことができます。 |
| [通話の進捗確認](check-call-progress.md) | 留守番電話からの出力に接続し、それに応じてコンタクトをルーティングするためのブランチを提供します。このブロックはアウトバウンドキャンペーンでのみ機能します。 |
| [コンタクト属性を確認する](check-contact-attributes.md) | 問い合わせの属性の値を確認します。 |
| [オペレーション時間の確認](check-hours-of-operation.md) | キューで定義されたオペレーション時間内または時間外にコンタクトが行われているかどうかを確認します。 |
| [キューの状態を確認する](check-queue-status.md) | 指定された条件に基づいて、キューのステータスを確認します。 |
| [Voice ID を確認する](check-voice-id.md) | Voice ID が返す通話者に関するウォッチリスト内での登録ステータス、音声認証ステータス、または不正通話の検出ステータスに基づいて分岐します。 |
| [人員の確認](check-staffing.md) | 現在の作業キュー、またはブロックで指定したキューで、エージェントが対応可能、対応中、またはオンラインかどうかについて確認します。対応中には、通話中ステータスまたは問い合わせ後作業ステータスが含まれます。 |
| [コンタクトのタグ](contact-tags-block.md) | ユーザー定義タグ (キーバリューペア) を作成し、コンタクトに適用します。 |
| [常設コンタクト関連付けの作成](create-persistent-contact-association-block.md) | 属性を指定して常設コンタクト関連付けを作成し、会話を中断したところから続けられるようにします。 |
| [タスクの作成](create-task-block.md) | 新しいタスクを作成し、その属性を設定して、そのタスクを開始するための問い合わせフローを立ち上げます。Amazon Connect でのタスクの詳細については、「[Amazon Connect のタスクチャネル](tasks.md)」を参照してください。 |
| [Customer Profiles](customer-profiles-block.md) | 顧客プロファイルを取得、作成、および更新できます。 |
| [データテーブル](data-table-block.md) | 問い合わせフロー内のデータテーブルからデータを評価、一覧表示、または書き込みます。 |
| [切断/ハングアップ](disconnect-hang-up.md) | 問い合わせを切断します。 |
| [分散 (%)](distribute-by-percentage.md) | 割合 (%) に基づいてランダムに顧客をルートします。 |
| [終了フロー/再開](end-flow-resume.md) | 発信者とのコンタクトを切断せずに現在のフローを終了する |
| [顧客の入力を取得する](get-customer-input.md) | 顧客の意図に基づいて分岐します。 |
| [メトリクスの取得](get-queue-metrics.md) | コンタクトセンターのキューやエージェントに関するリアルタイムのメトリクスを取得し、それらを属性として返します。 |
| [保存されたコンテンツを取得する](get-stored-content.md) | S3 に保存されているコンテンツを取得し、フローで使用する属性として返します。 |
| [顧客またはエージェントの保留](hold-customer-agent.md) | 顧客またはエージェントとの通話を保留または保留解除します。 |
| [AWS Lambda 関数](invoke-lambda-function-block.md) | 呼び出し AWS Lambda、オプションでキーと値のペアを返します。 |
| [モジュールの呼び出し](invoke-module-block.md) | 公開されたモジュールを呼び出します。 |
| [ループ](loop.md) | 指定されたループ数または指定された配列内の要素数の**ループ**ブランチをループスルーまたは繰り返します。 |
| [プロンプトのループ](loop-prompts.md) | 顧客またはエージェントが保留状態またはキュー内に保存されている場合、プロンプトの順序をループする |
| [プロンプトの再生](play.md) | 割り込み可能な音声プロンプトの再生、テキスト読み上げメッセージの配信、またはチャットのレスポンスの配信を行います。 |
| [コンタクトを再開](resume-contact.md) | 一時停止状態からコンタクトを再開します。 |
| [戻る (モジュールから)](return-module.md) | フローモジュールが正常に実行された後で、そのモジュールを終了します。 |
| [メッセージを送信](send-message.md) | テンプレートまたは指定したカスタムメッセージに基づいて顧客にメッセージを送信します。 |
| [コールバック番号を設定する](set-callback-number.md) | コールバック番号を設定します。 |
| [コンタクト属性の設定](set-contact-attributes.md) | キーと値のペアをコンタクト属性として保存します。 |
| [お客様キューフローの設定](set-customer-queue-flow.md) | 顧客がキューに転送されると、呼び出すフローを指定します。 |
| [切断フローの設定](set-disconnect-flow.md) | 切断イベントの後に実行されるフローを設定します。 |
| [イベントフローの設定](set-event-flow.md) | コンタクトイベント中に実行するフローを指定します。 |
| [保留フローの設定](set-hold-flow.md) | あるフロータイプから別のフロータイプへのリンク。 |
| [ログ記録動作の設定](set-logging-behavior.md) | フローのログを有効にして、コンタクトがフローとやり取りするときにイベントを追跡できるようにします。 |
| [記録と分析の動作の設定](set-recording-behavior.md) | 通話録音のオプションを設定します。 |
| [記録、分析、処理の動作を設定する](set-recording-analytics-processing-behavior.md) | エージェントと顧客の記録動作の設定、自動インタラクションの有効化、画面記録の有効化、問い合わせの分析動作の設定、カスタム処理動作の設定を行うオプションを設定します。 |
| [ルーティング条件の設定](set-routing-criteria.md) | 音声、チャット、タスクなどの任意のチャネルのコンタクトにルーティング条件を設定して、キュー内でコンタクトをどのようにルーティングするかを定義します。ルーティング条件とは、単一または複数のルーティングステップのシーケンスです。 |
| [Voice ID の設定](set-voice-id.md) | 通話がフローに接続されると、その音声を Amazon Connect Voice ID に送信して通話者の本人確認を行い、ウォッチリストの不正行為者と照合します。 |
| [音声の設定](set-voice.md) | フローで使用するテキスト読み上げ機能 (TTS) の言語と音声を設定します。 |
| [ウィスパーフローの設定](set-whisper-flow.md) | ウィスパーフローにリンクすることにより、デフォルトのウィスパーを上書きします。 |
| [作業キューの設定](set-working-queue.md) | **[キューへの転送]** を呼び出すときに使用されるキューを指定します。 |
| [ビューを表示](show-view-block.md) | フロントエンドアプリケーションでユーザーに表示できる UI ベースのワークフローを設定します。 |
| [メディアストリーミングの開始](start-media-streaming.md) | 問い合わせの顧客の音声のキャプチャを開始します。 |
| [メディアストリーミングの停止](stop-media-streaming.md) | [**メディアストリーミングの開始**] ブロックで開始されたら、顧客の音声のキャプチャは停止されます。 |
| [顧客の入力を保存する](store-customer-input.md) | 数値入力を問い合わせ属性に保存します。 |
| [エージェントフローへの転送 (ベータ)](transfer-to-agent-block.md) | エージェントに顧客に転送します。 |
| [フローへの転送](transfer-to-flow.md) | 別のフローに顧客に転送します。 |
| [電話番号への転送](transfer-to-phone-number.md) | 顧客をインスタンスの外部の電話番号に転送します。 |
| [キューへの転送](transfer-to-queue.md) | ほとんどのフローでは、このブロックは現在のフローを終了し、顧客をキューに登録します。顧客キューフローで使用すると、このブロックはすでにキューにある問い合わせを別のキューに転送します。 |
| [待機](wait.md) | フローを一時停止します。 |
# Amazon Connect のフローブロックでサポートされるチャネル
次の表に、使用可能なすべてのフローブロックと、指定されたチャネルを介した問い合わせのルーティングをサポートしているかどうかを示します。
| ブロック | 音声 | Chat | タスク | E メール |
| --- | --- | --- | --- | --- |
| [接続アシスタント](connect-assistant-block.md) | はい | はい | いいえ - エラーブランチ | はい |
| [顧客を認証](authenticate-customer.md) | いいえ - エラーブランチ | はい | いいえ - エラーブランチ | いいえ - エラーブランチ |
| [電話番号への発信](call-phone-number.md) | はい | いいえ - エラーブランチ | いいえ - エラーブランチ | いいえ - エラーブランチ |
| [Cases](cases-block.md) | はい | はい | はい | はい |
| [ルーティングの優先度/時間を変更する](change-routing-priority.md) | はい | はい | はい | はい |
| [通話の進捗確認](check-call-progress.md) | はい | いいえ - エラーブランチ | いいえ - エラーブランチ | いいえ - エラーブランチ |
| [コンタクト属性を確認する](check-contact-attributes.md) | はい | はい | はい | はい |
| [オペレーション時間の確認](check-hours-of-operation.md) | はい | はい | はい | はい |
| [キューの状態を確認する](check-queue-status.md) | はい | はい | はい | はい |
| [Voice ID を確認する](check-voice-id.md) | はい | いいえ - エラーブランチ | いいえ - エラーブランチ | いいえ - エラーブランチ |
| [人員の確認](check-staffing.md) | はい | はい | はい | はい |
| [コンタクトのタグ](contact-tags-block.md) | はい | はい | はい | はい |
| [常設コンタクト関連付けの作成](create-persistent-contact-association-block.md) | いいえ - エラーブランチ | はい | いいえ - エラーブランチ | いいえ - エラーブランチ |
| [タスクの作成](create-task-block.md) | はい | はい | はい | はい |
| [Customer Profiles](customer-profiles-block.md) | はい | はい | はい | はい |
| [切断/ハングアップ](disconnect-hang-up.md) | はい | はい | はい | はい |
| [分散 (%)](distribute-by-percentage.md) | はい | はい | はい | はい |
| [終了フロー/再開](end-flow-resume.md) | はい | はい | はい | はい |
| [顧客の入力を取得する](get-customer-input.md) | はい | Amazon Lex が使用されている場合は、はい それ以外の場合は、いいえ - エラーブランチ | いいえ | なし |
| [メトリクスの取得](get-queue-metrics.md) | はい | はい | はい | はい |
| [顧客またはエージェントの保留](hold-customer-agent.md) | はい | いいえ - エラーブランチ | いいえ - エラーブランチ | いいえ - エラーブランチ |
| [AWS Lambda 関数](invoke-lambda-function-block.md) | はい | はい | はい | はい |
| [モジュールの呼び出し](invoke-module-block.md) | はい | はい | はい | はい |
| [ループ](loop.md) | はい | はい | はい | はい |
| [プロンプトのループ](loop-prompts.md) | はい | いいえ - エラーブランチ | いいえ - エラーブランチ | いいえ - エラーブランチ |
| [プロンプトの再生](play.md) | はい | はい | いいえ – **[成功]** ブランチに分岐しますが、影響はありません。 | いいえ – **[成功]** ブランチに分岐しますが、影響はありません。 |
| [コンタクトを再開](resume-contact.md) | いいえ - エラーブランチ | いいえ - エラーブランチ | はい | いいえ - エラーブランチ |
| [戻る (モジュールから)](return-module.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-recording-behavior.md) | はい | はい | いいえ - エラーブランチ | いいえ - エラーブランチ |
| [記録、分析、処理の動作を設定する](set-recording-analytics-processing-behavior.md) | はい | はい | はい | はい |
| [ルーティング条件の設定](set-routing-criteria.md) | はい | はい | はい | はい |
| [Voice ID の設定](set-voice-id.md) | はい | いいえ - エラーブランチ | いいえ - エラーブランチ | いいえ - エラーブランチ |
| [音声の設定](set-voice.md) | はい | いいえ - 成功ブランチ | いいえ - 成功ブランチ | いいえ - 成功ブランチ |
| [ウィスパーフローの設定](set-whisper-flow.md) | はい | はい | はい | はい |
| [作業キューの設定](set-working-queue.md) | はい | はい | はい | はい |
| [ビューを表示](show-view-block.md) | いいえ - エラーブランチ | はい | いいえ - エラーブランチ | はい |
| [メディアストリーミングの開始](start-media-streaming.md) | はい | いいえ - エラーブランチ | いいえ - エラーブランチ | いいえ - エラーブランチ |
| [メディアストリーミングの停止](stop-media-streaming.md) | はい | いいえ - エラーブランチ | いいえ - エラーブランチ | いいえ - エラーブランチ |
| [顧客の入力を保存する](store-customer-input.md) | はい | いいえ - エラーブランチ | いいえ - エラーブランチ | いいえ - エラーブランチ |
| [エージェントフローへの転送 (ベータ)](transfer-to-agent-block.md) | はい | いいえ - エラーブランチ | いいえ - エラーブランチ | いいえ - エラーブランチ |
| [フローへの転送](transfer-to-flow.md) | はい | はい | はい | はい |
| [電話番号への転送](transfer-to-phone-number.md) | はい | いいえ - エラーブランチ | いいえ - エラーブランチ | いいえ - エラーブランチ |
| [キューへの転送](transfer-to-queue.md) | はい | はい | はい | はい |
| [待機](wait.md) | いいえ - エラーブランチ | はい | はい | はい |
# Amazon Connect のフローブロック: Connect Assistant
このトピックでは、Connect Assistant のフローブロックを定義します。
## 説明
+ Connect アシスタントドメインを連絡先に関連付けて、リアルタイムのレコメンデーションを有効にします。
+ Connect AI エージェントを有効にする方法の詳細については、「」を参照してください[Connect AI エージェントを使用したリアルタイムのサポート](connect-ai-agent.md)。
**ヒント**
Connect AI エージェント[をカスタマイズ](customize-connect-ai-agents.md)する場合は、フローにこのブロックを追加する代わりに、Lambda を作成してから、 [AWS Lambda 関数](invoke-lambda-function-block.md)ブロックを使用してフローに追加する必要があります。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用しているコンタクトのルーティング先を示します。
**注記**
このブロックにアウトバウンドメールが送信されても何も起こりませんが、**課金されます**。これを防ぐには、このブロックの前に [[コンタクト属性を確認する](check-contact-attributes.md)] ブロックを追加し、タスクやアウトバウンド E メールを適切にルーティングします。手順については、「[コンタクトセンターへの問い合わせ方法に基づいて、問い合わせの経験をパーソナライズする](use-channel-contact-attribute.md)」を参照してください。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer Queue flow (顧客キューフロー)]
+ アウトバウンドウィスパーフロー
+ エージェントへの転送フロー
+ キューへの転送フロー
## このブロックの設定方法
次の図は、**Connect Assistant** ブロック設定の **Config** タブを示しています。連絡先に関連付ける Connect アシスタントドメインの完全な Amazon リソースネーム (ARN) を指定します。また、エージェント支援に使用するオーケストレーション AI エージェントも指定します。
![\[Connect Assistant ブロックの Config タブ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/connect-assistant-block-config.png)
## 設定のヒント
+ コールで Connect AI エージェントを使用するには、Contact Lensリアルタイムに設定されている[記録と分析の動作の設定](set-recording-behavior.md)ブロックを追加して、フローAmazon Connect Contact Lensで を有効にする必要があります。[記録と分析の動作の設定](set-recording-behavior.md) ブロックを追加するフロー内の位置は重要ではありません。
Connect AI エージェントは、Contact Lensリアルタイム分析とともに、現在の通話中に検出された顧客の問題に関連するコンテンツをレコメンデーションするために使用されます。
+ Contact Lens チャットで Connect AI エージェントを使用する必要はありません。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** のブランチがあります。
![\[設定された Connect Assistant ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/connect-assistant-block-configured.png)
# Amazon Connect のフローブロック: 顧客を認証
このトピックでは、顧客を認証し、認証結果に応じてフロー内の特定のパスに顧客をルーティングするためのフローブロックを定義します。
**注記**
このブロックを使用する前に:
Amazon Connect インスタンスで [顧客認証] 機能を有効にする必要があります。さらに、ID プロバイダーで新しい Amazon Cognito ユーザープールを作成する必要があります。手順については、「[Amazon Connect でチャットコンタクトの顧客認証を設定する](customer-auth.md)」を参照してください。
Amazon Connect インスタンスで [顧客プロファイル] を[有効](enable-customer-profiles.md)にする必要があります。
## 説明
+ 顧客がチャット中に認証できるようにします。
+ 顧客が正常にサインインして Amazon Cognito から ID トークンを取得すると、Amazon Connect は、顧客プロファイルに情報を保存するために使用した識別子に応じて、既存の顧客プロファイルを更新するか、新しい顧客プロファイルを作成します。
+ 顧客プロファイルに [名] フィールドがある場合、顧客の表示名はその名前に更新されます。
## このブロックのユースケース
このフローブロックは、以下のシナリオでの使用を想定して設計されています。
+ チャット時にサインインして認証するよう顧客に求めることができます。例えば、以下の場合、認証していない顧客にサインインするよう求めます。
+ チャットボットを使用する場合 (エージェントにルーティングされる前)。
+ 支払いなどのトランザクションを実行する場合。
+ ID を検証する場合 (アカウントステータスを指定する前、またはプロファイル情報の更新を許可する前)
+ このブロックを使用して、[Apple Messages for Business](enabling-authentication-for-apple-messages-for-business.md) でのチャット時に顧客を認証することもできます。
## コンタクトのタイプ
| コンタクトのタイプ | サポート対象? |
| --- | --- |
| 音声 | いいえ - **[エラー]** ブランチ |
| Chat | はい |
| タスク | いいえ - **[エラー]** ブランチ |
| E メール | いいえ - [エラー] ブランチ |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
| フロータイプ | サポート対象? |
| --- | --- |
| 着信フロー | はい |
| 顧客キューフロー | いいえ |
| 顧客保留フロー | いいえ |
| 顧客ウィスパーフロー | いいえ |
| アウトバウンドウィスパーフロー | いいえ |
| エージェント保留フロー | いいえ |
| エージェントウィスパーフロー | いいえ |
| エージェントへの転送フロー | いいえ |
| キューへの転送フロー | いいえ |
## このブロックの設定方法
**Authenticate Customer** ブロックを設定するには、 Amazon Connect 管理者ウェブサイトを使用するか、Amazon Connect Flow 言語の [AuthenticateParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-authenticateparticipant.html) アクションを使用します。
次の画像は、**[顧客を認証]** ブロックの [プロパティ] ページの例を示しています。
![\[[顧客を認証] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/authenticate-customer-properties.png)
**Amazon Cognito**
+ **Amazon Cognito ユーザープールを選択**: コンソールページでユーザープールを関連付けたら、ドロップダウンリストからユーザープールの名前を選択します。
+ **Amazon Cognito アプリクライアントを選択**: ユーザープールを選択したら、ドロップダウンリストからアプリクライアントの名前を選択します。
**Amazon Connect Customer Profiles 設定**
+ **デフォルトテンプレートで保存**: デフォルトのテンプレートを選択すると、Amazon Connect Customer Profiles は、事前定義された顧客プロファイルオブジェクトタイプに応じた [Amazon Cognito 標準属性](https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-attributes.html#cognito-user-pools-standard-attributes)を、統合された標準プロファイルオブジェクト内に取り込みます。このテンプレートは、電話番号と E メールを使用して、顧客をプロファイルにマッピングします。
+ **一意の識別子を入力**: Customer Profiles がデータを取り込む方法は、[オジェクトタイプマッピングを作成する](create-object-type-mapping.md)ことでカスタマイズできます。データマッピングまたはキーをカスタマイズする場合は、事前に独自のオブジェクトタイプマッピングを作成し、**[一意の識別子を入力]** を選択して、マッピング名を入力します。
**タイムアウト**: サインインしていない非アクティブな顧客が、[タイムアウト] ブランチにルーティングされるまでの時間を入力します。
+ 最小 (デフォルト): 3 分
+ 最大: 15 分
### フローブロックのブランチ
このブロックは、次の出力ブランチをサポートしています。
![\[設定された [顧客を認証] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/authenticate-customer-configured.png)
+ **成功**: 顧客は認証されました。
+ **タイムアウト**: 顧客は非アクティブであり、割り当てられた時間内にサインインしませんでした。
+ **オプトアウト**: 顧客はサインインしないことを選択しました。
+ **エラー**: [エラーシナリオ](#authenticate-customer-errorscenarios)の 1 つが発生しました。
### 追加の設定のヒント
+ Amazon CloudWatch ロググループでフローログを有効にすることをお勧めします。これにより、顧客がフローを操作する際に、フロー内のイベントに関する詳細情報をリアルタイムで確認できます。また、フローログを使用すると、フローの作成時にそれらをデバッグするのに役立ちます。詳細については、「[Amazon CloudWatch ロググループで Amazon Connect フローログを有効にする](contact-flow-logs.md)」を参照してください。
+ Apple Messages for Business チャットで顧客の認証を有効にする方法については、「[Apple Messages for Business の認証を有効にする](enabling-authentication-for-apple-messages-for-business.md)」を参照してください。
### このブロックで生成されるデータ
このブロックではデータは生成されません。
## エラーシナリオ
コンタクトは、次の状況で **[エラー]** ブランチへルーティングされます。
+ Amazon Connect インスタンスで Customer Profiles が有効になっていません。Customer Profiles を有効にするオプションは、インスタンスの作成時にデフォルトで選択されますが、このオプションの選択を解除することもできます。Customer Profiles を手動で有効にする手順については、「[Amazon Connect インスタンスで Customer Profiles を有効にする](enable-customer-profiles.md)」を参照してください。
+ チャットサブタイプはサポートされていません。
+ 指定した認証コードが正しくありません。
+ クライアントまたはリクエストが正しく設定されていないため、Amazon Cognito トークンエンドポイントでエラーが発生しました (`invalid_request`、`invalid_client`、`unauthorized_client`)。
+ サポートされていないリージョンです。サポートされているリージョンのリストについては「[リージョン別の顧客認証の可用性](regions.md#customerauthentication_region)」を参照してください。
# Amazon Connect のフローブロック: 電話番号の呼び出し
このトピックでは、コンタクトセンターの顧客との音声による対話で使用される [電話番号の呼び出し] のフローブロックを定義します。
## 説明
+ [**Outbound Whisper (アウトバウンドウィスパー)**] フローから発信通話を開始します。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | いいえ |
| タスク | いいえ |
| E メール | いいえ |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ アウトバウンドウィスパーフロー
## プロパティ
次の画像は、電話番号を手動で選択する場合の **[電話番号への発信]** プロパティページの例を示しています。**[インスタンスから番号を選択]** オプションが選択され、ドロップダウンメニューに、インスタンスで使用できる電話番号のリストが表示されます。
![\[[電話番号への発信] プロパティページ。[インスタンスから番号を選択] オプション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/call-phone-number1.png)
次の画像は、電話番号を動的に選択する場合の **[電話番号への発信]** プロパティページの例を示しています。**[属性を使用]** オプションが選択されています。**[名前空間]** ボックスが **[ユーザー定義]** に設定されています。**[属性]** ボックスは **[MainPhoneNumber]** に設定されています。
![\[[電話番号への発信] ブロックのプロパティページ。[属性を使用] オプションが選択され、[名前空間] が [ユーザー定義] に設定されています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/call-phone-number2.png)
直通番号とコールバックのシナリオでエージェントがコールを受け入れた直後に、アウトバウンドウィスパーフローが Amazon Connect で実行されます。フローが実行される場合:
+ 発信者 ID 番号は、[電話番号への発信](#call-phone-number) ブロックで指定されていれば設定されます。
+ [電話番号への発信](#call-phone-number) ブロックに発信者 ID が指定されていない場合、コールが発信されたときにキューに定義されている発信者 ID 番号が使用されます。
+ [電話番号への発信](#call-phone-number) ブロックによって開始されたコールでエラーが発生すると、コールは切断され、エージェントは **AfterContactWork** (ACW) になります。
キューのアウトバウンドウィスパーフローとして、発行されたフローのみが選択できます。
**注記**
カスタム発信者 ID を使用するには、 サポート チケットを開いてこの機能を有効にする必要があります。詳細については、「[発信者 ID の設定](https://docs.aws.amazon.com/connect/latest/adminguide/queues-callerid.html)」を参照してください。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[発信者 ID]** の電話番号と **[成功]** ブランチを示しています。
![\[設定済みの [電話番号への発信] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/call-phone-number-configured.png)
ブロックにはエラーブランチがありません。コールが正常に開始されないと、フローは終了し、エージェントは **AfterContactWork** (ACW) になります。
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
+ [Amazon Connect の顧客キュー優先度フローのサンプル](sample-customer-queue-priority.md)
+ [Amazon Connect のキュー設定フローのサンプル](sample-queue-configurations.md)
## シナリオ
発信者 ID の動作の詳細については、次のトピックを参照してください。
+ [Amazon Connect にアウトバウンド発信者 ID を設定する](queues-callerid.md)
# Amazon Connect のフローブロック: ケース
**ヒント**
このブロックを使用する前に、必ず Amazon Connect Cases を[有効](enable-cases.md)にしてください。有効にしないと、プロパティを設定することはできません。
このトピックでは、ケースを更新および作成するためのフローブロックを定義します。
## 説明
+ ケースを取得、更新、作成します。
+ 問い合わせにリンクされたケースを検索します。
+ 問い合わせをケースにリンクすると、その問い合わせは、ケースの **[Activity feed]** (アクティビティフィード) に記録されます。エージェントがケースにリンクされている問い合わせを受け入れると、ケースはエージェントアプリケーションで新しいタブとして自動的に開きます。
+ 問い合わせを複数のケースにリンクすることは可能ですが、エージェントアプリケーションで自動的に開く新しいケースタブは最大 5 個です。これらは、直近で更新された 5 個のケースです。
+ ケースの詳細については、「[Amazon Connect Cases](cases.md)」を参照してください。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ すべてのフロー
## プロパティ: ケースを取得する
**ヒント**
以下のスクリーンショットは、従来のフローデザイナーに関するものです。
ケースを取得するためにプロパティを設定する場合:
+ **連絡先をケースにリンクするように** を指定できます (はい/いいえ）。「はい」の場合は、次のオプションから選択できます。
+ **現在の問い合わせ**は、現在のフローが実行されている問い合わせです。
+ **関連する連絡先**は、この連絡先[に関連する](https://docs.aws.amazon.com/connect/latest/adminguide/chat-persistence.html#relatedcontactid)連絡先です。
+ 少なくとも 1 つの検索条件を指定する必要があります。それ以外の場合、このブロックは **[Error]** (エラー) 分岐を取ります。
Cases 名前空間で属性を使用するか、手動で設定できます。手動で設定する場合は、「[フロー全体でフィールドを保持する方法](#cases-persist-fields)」の構文を参照してください。
+ 特定の顧客のケースを取得するには、ケースを作成する前にフローに [Customer Profiles](customer-profiles-block.md) ブロックを追加します。次の画像は、[成功] ブランチから **[ケース]** ブロックにリンクされた **[顧客プロファイル]** ブロックを使用したフローデザイナーを示しています。
![\[[成功] ブランチから [ケース] ブロックにリンクされた [顧客プロファイル] ブロックを使用したフローデザイナー。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/cases-block-get-case-properties5.png)
顧客プロファイルを取得するように [Customer Profiles](customer-profiles-block.md) ブロックを設定します。次の画像は、設定された **[顧客プロファイル]** のプロパティページの例を示しています。**[アクション]** ボックスは **[プロファイルを取得]** に設定されています。**[検索キーを選択]** ボックスは **[メールアドレス]** に設定されています。**[属性を使用]** オプションが選択されています。**[タイプ]** ボックスは **[顧客]** に設定されています。**[属性]** ボックスは **[メールアドレス]** に設定されています。**[レスポンスフィールド]** は **[名]**、**[姓]** に設定されています。
![\[[プロファイルを取得] アクション用に設定された [顧客プロファイル] のプロパティページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/cases-block-get-case-properties4.png)
**[ケース]** ブロックの **[プロパティ]** ページで、次の画像に示すように、**[顧客 ID]** セクションを設定します。**[コンタクトをケースにリンク]** オプションは **[はい]** に設定されています。**[リクエストフィールド]** ボックスは **[顧客 ID]** に設定されています。**[顧客 ID]** セクションで、**[属性を使用]** オプションが選択されています。**[タイプ]** ボックスは **[顧客]** に設定されています。**[属性]** ボックスは **[プロファイル ARN]** に設定されています。
![\[顧客 ID によってケースを検索するように設定された [ケース] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/cases-block-get-case-properties3.png)
+ どの検索条件でも、最後に更新されたケースのみを取得するように指定できます。これは、**[Get last updated case]** (最後に更新されたケースを取得) を選択することで可能になります。
+ ケースの名前空間でケースフィールドを永続化して、**[Get case]** (ケースを取得) に設定された **[Cases]** ブロックの後のフローにあるブロックでそれらを利用できます。これは、**[Response fields]** (レスポンスフィールド) セクションを利用し、他のブロックで使用するフィールドを選択することで可能になります。
Cases 名前空間で属性を使用するか、手動で設定できます。手動で設定する場合は、「[フロー全体でフィールドを保持する方法](#cases-persist-fields)」の構文を参照してください。
+ **[Get case]** (ケースを取得) プロパティは、択一フィールドタイプのオプションを示します。
+ **[Get case]** (ケースを取得) プロパティは、テキストフィールドタイプに Contains 関数を使用します。
+ **[Get case]** (ケースを取得) プロパティは、タイプが number、boolean のフィールドに EqualTo 関数を使用します。
+ **[Get case]** (ケースを取得) プロパティは、任意の日付フィールド検索に [greater than or equal to] (次以上:) を使用します。
+ 問い合わせは、次の分岐にルーティングできます。
+ **[Success]** (成功): ケースが見つかりました。
+ **[Contact not linked]** (問い合わせがリンクされていません): 問い合わせをケースにリンクするように指定すると、このエラー分岐が表示されます。ケースが取得された後に問い合わせがリンクされなかった可能性があります (部分的な成功/部分的な失敗)。これが発生した場合、フローはこの分岐に従います。
+ **[Multiple found]** (複数見つかりました): 該当の検索条件で複数のケースが見つかりました。
+ **[None found]** (見つかりません): 該当の検索条件ではケースが見つかりません。
+ **[Error]** (エラー): ケースの検索中にエラーが発生しました。これは、システムエラーまたは **[Get case]** (ケースを取得) の設定方法が原因である可能性があります。
以下の画像は、**[ケースを取得]** アクション用に設定されたケースの **[プロパティ]** ページの例を示しています。
最初の画像は、**[顧客 ID]** と **[タイトル]** でケースを検索するように設定された **[プロパティ]** ページを示しています。**[顧客 ID]** は、顧客の **[プロファイル ARN]** からプルされています。この画像では、**[コンタクトをケースにリンク]** オプションは **[はい]** に設定されています。**[リクエストフィールド]** は **[顧客 ID、タイトル]** に設定されています。**[顧客 ID]** セクションで、**[属性を使用]** オプションが選択されています。**[タイプ]** ボックスは **[顧客]** に設定されています。**[属性]** ボックスは **[プロファイル ARN]** に設定されています。
![\[顧客 ID とタイトルでケースを検索するように設定された [ケース] ブロックのプロパティページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/cases-block-get-case-properties1.png)
この次の画像は、**[Late Arrival]** (到着遅延) で検索するように設定されたブロックを示しています。**[タイトル]** で、**[手動で設定]** オプションが **[到着が遅い]** に設定されています。**[最後に更新されたケースを取得]** オプションが選択されています。**[レスポンスフィールド]** オプションには、エージェントに表示される 3 つのフィールド（**[ステータス]**、**[概要]**、**[タイトル]**) が示されています。
![\[「到着が遅い」によってケースを検索するように設定された [ケース] ブロックのプロパティページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/cases-block-get-case-properties2.png)
## プロパティ: ケース ID を取得する
ケース ID を取得するようにプロパティを設定する場合:
+ **連絡先をケースにリンクするように** を指定できます (はい/いいえ）。「はい」の場合は、次のオプションから選択できます。
+ **現在の問い合わせ**は、現在のフローが実行されている問い合わせです。
+ **関連する連絡先**は、この連絡先[に関連する](https://docs.aws.amazon.com/connect/latest/adminguide/chat-persistence.html#relatedcontactid)連絡先です。
+ 問い合わせをケースにリンクすると、問い合わせと、問い合わせの詳細へのリンクが、エージェントアプリケーションでエージェントに表示されるケースに表示されます。
+ **検索する問い合わせ**を指定して、現在の問い合わせ[チェーン](https://docs.aws.amazon.com/connect/latest/adminguide/contacts-contact-chains-attributes.html#contact-chains)内の別の問い合わせにリンクされたケースを取得できます。これにより、E メールの返信、通話転送、永続チャット、キューに入れられたコールバックなどのフォローアップ連絡先をより簡単に同じケースにリンクできます。
+ **現在の連絡先**
+ **最初の問い合わせ**
+ **タスク問い合わせ**
+ **以前の連絡先**
+ **関連する連絡先**
+ ケースが見つかった場合、**連絡先が検索するために**、そのケースのケース ID はケース名前空間に保持されます。ケース名前空間のケース ID の属性値にアクセスすることで、他のブロックでも使用できます。
+ 問い合わせは、次の分岐にルーティングできます。
+ **[Success]** (成功): ケースが見つかりました。問い合わせをケースにリンクするように を指定した場合、問い合わせも正常にリンクされました。
+ **[Contact not linked]** (問い合わせがリンクされていません): 問い合わせをケースにリンクするように指定すると、このエラー分岐が表示されます。ケースが取得された後に問い合わせがリンクされなかった可能性があります (部分的な成功/部分的な失敗)。これが発生した場合、フローはこの分岐に従います。
+ **[Multiple found]** (複数見つかりました): 該当の検索条件で複数のケースが見つかりました。
+ **[None found]** (見つかりません): 該当の検索条件ではケースが見つかりません。
+ **[Error]** (エラー): ケースの検索中にエラーが発生しました。これは、システムエラーまたは**ケース ID **の取得の設定方法が原因である可能性があります。
## プロパティ: ケースを更新する
ケースを更新するためにプロパティを設定する場合:
+ **連絡先をケースにリンクするように** を指定できます (はい/いいえ）。「はい」の場合は、次のオプションから選択できます。
+ **現在の問い合わせ**は、現在のフローが実行されている問い合わせです。
+ **関連する連絡先**は、この連絡先[に関連する](https://docs.aws.amazon.com/connect/latest/adminguide/chat-persistence.html#relatedcontactid)連絡先です。
+ 次の画像に示すように、**[ケースを更新]** の前に **[ケースを取得]** ブロックを追加します。**[ケースを取得]** ブロックを使用して、更新するケースを探します。
![\[[成功] ブランチから [ケースを更新] ブロックにリンクされた [ケースを取得] ブロックを示すフローデザイナー。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/cases-block-get-case-update-case.png)
+ 少なくとも 1 つの **[Request]** (リクエスト) フィールドに更新を指定する必要があります。指定しない場合、このブロックは **[Error]** (エラー) 分岐を取ります。
Cases の名前空間の属性を使用するか、**[Request]** (リクエスト) フィールドを手動で設定することができます。手動で設定する場合は、「[フロー全体でフィールドを保持する方法](#cases-persist-fields)」の構文を参照してください。
+ 問い合わせは、次の分岐にルーティングできます。
+ **[Success]** (成功): ケースが更新され、問い合わせがケースにリンクされました。
+ **[Contact not linked]** (問い合わせがリンクされていません): 問い合わせをケースにリンクするように指定すると、このエラー分岐が表示されます。ケースは更新されたが、問い合わせがケースにリンクされなかった可能性があります (部分的な成功/部分的な失敗)。これが発生した場合、フローはこの分岐に従います。
+ **[Error]** (エラー): ケースが更新されませんでした。ケースが更新されなかったため、問い合わせはケースにリンクされませんでした。
次の画像は、**[Update case]** (ケースを更新) の設定例を示しています。最初の画像は、更新の一環として、問い合わせがケースにリンクされることを示しています。更新するケースを特定するために、**[Case Id]** (ケース ID) が指定されます。(ケース ID はケースの一意識別子であり、ここで指定できる唯一のフィールドです。 他のフィールドは機能せず、エラーが発生します。)
![\[[ケースを更新] ブロック。[コンタクトをケースにリンク] オプションが [はい] に設定され、[タイプ] が [ケース] に設定され、[属性] が [ケース ID] に設定されています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/cases-block-update-case-properties1.png)
次の画像は、**[リクエスト]** フィールドを示しています。ここで、ケースを更新するフィールドを指定します。
![\[[ケースを更新] ブロック。[リクエスト] フィールドが [タイトル] に設定され、[手動で設定] オプションが [フローから更新されたケース] に設定されています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/cases-block-update-case-properties2.png)
## プロパティ: ケースを作成する
ケースを作成するためにプロパティを設定する場合:
+ **連絡先をケースにリンクするように** を指定できます (はい/いいえ）。「はい」の場合は、次のオプションから選択できます。
+ **現在の問い合わせ**は、現在のフローが実行されている問い合わせです。
+ **関連する連絡先**は、この連絡先[に関連する](https://docs.aws.amazon.com/connect/latest/adminguide/chat-persistence.html#relatedcontactid)連絡先です。
+ ケーステンプレートを指定する必要があります。詳細については、「[Amazon Connect Cases で顧客の問題を記録するケーステンプレートを作成する](case-templates.md)」を参照してください。
+ 必須フィールドは、**[Required]** (必須) フィールドセクションに表示されます。ケースを作成するには、それらに値を割り当てる必要があります。
+ ケースを作成するには、顧客を指定する必要があります。
+ **[Cases]** ブロックの前のフローに [Customer Profiles](customer-profiles-block.md) ブロックを追加することをお勧めします。[Customer Profiles](customer-profiles-block.md) ブロックを使用して、プリフェッチされたデータを含む顧客プロファイルを取得するか、新しい顧客プロファイルを作成してから、それを使用してケースを作成します。
+ **[ケース]** ブロックの **[顧客 ID]** の値を指定するには、次の画像に示すようにフィールドを設定します。ここでは、**[属性を使用]** が選択され、**[タイプ]** が **[顧客]** に設定され、**[属性]** が **[プロファイル ARN]** に設定されています。
![\[[顧客 ID] として [属性を使用] 値を提供するように設定された [ケースの作成] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/create-case-block-properties2.png)
値を手動で設定する場合は、完全な顧客プロファイル ARN を次の形式で指定する必要があります。
`arn:aws:profile:your AWS Region:your AWS account ID:domains/profiles domain name/profiles/profile ID `
+ [Request fields] (リクエストフィールド) セクションでは、必須フィールド以外のフィールドの値を指定できます。
Cases 名前空間で属性を使用するか、手動で設定できます。手動で設定する場合は、「[フロー全体でフィールドを保持する方法](#cases-persist-fields)」の構文を参照してください。
+ 問い合わせがケースにリンクされるように指定できます。問い合わせをケースにリンクすると、問い合わせと、問い合わせの詳細へのリンクが、エージェントアプリケーションでエージェントに表示されるケースに表示されます。
+ ケースを作成すると、作成されたケース ID はケースの名前空間に保持されます。ケース名前空間のケース ID の属性値にアクセスすることで、他のブロックでも使用できます。
+ 問い合わせは、次の分岐にルーティングできます。
+ **[Success]** (成功): ケースが作成され、問い合わせがケースにリンクされました。
+ **[Contact not linked]** (問い合わせがリンクされていません): 問い合わせをケースにリンクするように指定すると、このエラー分岐が表示されます。これは、ケースは作成されたが、問い合わせがケースにリンクされなかった可能性があるためです (部分的な成功/部分的な失敗)。これが発生した場合、フローはこの分岐に従います。
+ **[Error]**(エラー) : ケースが作成されませんでした。ケースが作成されなかったため、問い合わせはケースにリンクされませんでした。
次の画像は、**[Create case]** (ケースを作成) の設定例を示しています。最初の画像は、新しいケースが [General inquiry] (一般的な問い合わせ) テンプレートを使用して作成されることを示しています。
![\[[テンプレート] オプションが [一般的なお問い合わせ] に設定された [ケースの作成] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/cases-block-create-case-properties1.png)
次の画像は、ケースが **[Shipment delayed]** (発送の遅延) に設定される理由を示しています。
![\[[ケースの理由] ボックスが [手動で設定] または [発送が遅れた] に設定された [ケースの作成] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/cases-block-create-case-properties.png)
## フロー全体でフィールドを保持する方法
顧客がコンタクトセンターに電話をかけて、エージェントと話すことなくケースのステータスを把握できるようにしたい場合を考えてみましょう。IVR が顧客に対するステータスを読み取るようにしたいとします。システムフィールドからステータスを取得することも、カスタムステータスフィールド (例えば、名前を *Detailed status* とするもの) を使用することもできます。
顧客のためにステータスを取得して読み取るようにフローを設定する方法は次のとおりです。
1. フローに **[Cases]** ブロックを追加します。ケースを見つけるために **[Get case]** (ケースを取得) に設定します。
![\[[アクション] が [ケースを取得] に設定された [ケース] ブロックのプロパティページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/cases-example-ivr-1.png)
1. **[Request fields]** (リクエストフィールド) セクションで、顧客 **[Profile ARN]** (プロファイル ARN) でケースを検索します。
![\[[顧客 ID] に設定された [リクエストフィールド] ドロップダウン、[顧客] に設定された [タイプ]、[プロファイル ARN] に設定された [属性]。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/cases-example-ivr-2.png )
1. **[Response fields]** (レスポンスフィールド) セクションで、フロー全体で渡すフィールドを追加します。この例では、**[Status]** (ステータス) を選択します。
![\[[ステータス] に設定された [レスポンスフィールド] ドロップダウン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/cases-example-ivr-3.png )
1. [プロンプトの再生](play.md) ブロックをフローに追加します。
1. 属性を手動で設定するように [プロンプトの再生](play.md) を設定します。
![\[テキスト読み上げまたはチャットテキストメッセージを手動で再生するように設定された [プロンプトの再生] プロパティページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/cases-example-ivr-4.png)
顧客のためにケースのステータスを読み取るには、次の構文を使用します。
+ システムフィールドについては、構文を読んで、どのフィールドを参照しているかを理解できます。例: `$.Case.status` はケースのステータスを示します。システムフィールド ID のリストについては、「[システムケースフィールド](case-fields.md#system-case-fields)」トピックの「*フィールド ID*」列を参照してください。
+ カスタムフィールドの場合、構文は UUID (一意の ID) を使用してフィールドを表します。例えば、次の画像では、*Detailed status* (ステータスの詳細) という名前のカスタムフィールドの ID は `12345678-aaaa-bbbb-cccc-123456789012` です。
![\[カスタムフィールドのステータス ID を含むテキスト読み上げメッセージ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/cases-example-ivr-5.png)
## カスタムフィールド ID を見つける
カスタムフィールドの UUID を見つけるには:
1. Amazon Connect のナビゲーションメニューで、**[Agent applications]** (エージェントアプリケーション)、**[Custom fields]** (カスタムフィールド) の順に選択してから、必要なカスタムフィールドを選択します。
1. カスタムフィールドの詳細ページで、ページの URL を確認します。UUID は URL の最後の部分です。例えば、次の URL の場合:
`https://instance alias.my.connect.aws/cases/configuration/fields/update/12345678-aaaa-bbbb-cccc-123456789012`
UUID は `12345678-aaaa-bbbb-cccc-123456789012` です。
次の画像は、URL の末尾のカスタムフィールド ID の位置を示しています。
![\[[アカウント ID] ページ。ブラウザに URL が表示され、URL の末尾のカスタムフィールド ID が強調表示されています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/cases-block-custom-field-uuid.png)
## 設定のヒント
+ 必ず [[Cases service quotas]](amazon-connect-service-limits.md#cases-quotas) (Cases のサービスクォータ) を確認し、引き上げをリクエストしてください。クォータは、このブロックがケースを作成するときに適用されます。
+ [ケース] ブロックでは、最大 10 個の**レスポンスフィールド**を指定できます。10 個を超える数を指定してフローを公開すると、次のエラーが表示されます。
`Invalid or missing parameter data` `One or more parameters are invalid or missing. Click on the block header to edit the block and fix the problematic parameters before publishing.`
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。このブロックはケースを作成するように設定され、**[成功]** ブランチと **[エラー]** ブランチがあることを示しています。
![\[設定済みの [ケース] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/create-case-block-configured.png)
# Amazon Connect のフローブロック: ルーティングの優先度/時間の変更
このトピックでは、キュー内の顧客の優先度または時間を変更するための [ルーティング優先度/経過時間の変更] フローブロックの設定について説明します。
## 説明
+ キュー内の顧客の位置を変更します。例えば、問い合わせをキューの先頭に移動するか、キューの後尾に移動します。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer queue flow (顧客キューフロー)]
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
次の画像は、**[ルーティング優先度/経過時間の変更]** ブロックの **[プロパティ]** ページを示しています。コンタクトのルーティング経過時間に 8 秒を加えるように設定されています。
![\[[ルーティング優先度/経過時間の変更] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/change-routing-priority-properties.png)
このブロックには、キューにおけるお問い合わせの位置を変更するための 2 つのオプションがあります。
+ **Set priority (優先度の設定)**: 新規問い合わせの優先度の既定値は 5 です。1 や 2 などの高い優先度を割り当てることで、キュー内の他の問い合わせよりその問い合わせの優先度を上げることができます。
+ デフォルトの優先度: 5
+ 有効な値の範囲: 1 (最高)～9223372036854775807 (最低)。これより大きい数値を入力すると、フローの公開時に失敗します。
+ **Adjust by time (時間により調整)**: 現在の問い合わせがキューで費やした時間から、秒または分を加算または減算できます。問い合わせは、先着順でエージェントにルーティングされます。したがって、キュー内に他の問い合わせがある場合、特定の問い合わせの「キューされていた時間」を変更すると、キュー内の位置も変更されます。
このブロックの仕組みは次のとおりです。
1. Amazon Connect では、問い合わせが実際に「キューされていた時間」(この特定の問い合わせがキュー内で費やした時間) を受け取り、**[Adjust by time](時間で調整)** プロパティで指定された秒数を追加します。
1. 秒を追加すると、この特定の問い合わせは実際以上に古く見えます。
1. ルーティングシステムは、この問い合わせの「キューされていた時間」が実際よりも長いと認識するため、リスト内でランク付けされた位置が影響を受けます。
## 設定のヒント
+ このブロックを使用する場合、すでにキューに入っている問い合わせに対して変更が有効になるまでに少なくとも 60 秒かかります。
+ 問い合わせの優先度を変更してすぐに有効にする必要がある場合は、問い合わせをキューに入れる前に、つまり [キューへの転送](transfer-to-queue.md) ブロックを使用する前に、優先度を設定します。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[キュー時間]** が \$18 秒に設定され、**[成功]** ブランチがあることを示しています。
![\[設定された [ルーティングの優先度/経過時間の変更] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/change-routing-priority-configured.png)
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
+ [Amazon Connect の顧客キュー優先度フローのサンプル](sample-customer-queue-priority.md)
+ [Amazon Connect のキュー設定フローのサンプル](sample-queue-configurations.md)
## シナリオ
ルーティングプライオリティの機能の詳細については、次のトピックを参照してください。
+ [Amazon Connect でのルーティングプロファイルの使用方法](concepts-routing.md)
+ [Amazon Connect でのルーティングの仕組み](about-routing.md)
# Amazon Connect のフローブロック: 通話の進捗の確認
このトピックでは、留守番電話からの出力に対応してコンタクトを適切なブランチにルーティングするためのフローブロックを定義します。
## 説明
+ 留守番電話からの出力に接続し、それに応じてコンタクトをルーティングするためのブランチを提供します。
+ 以下のブランチがサポートされています。
+ **[Call answered]** (応答された通話): この通話には人間が対応しました。
+ **[Voicemail (beep)]** (ボイスメール: ビープ音あり): Amazon Connect は、通話がボイスメールで終了したことを認識し、ビープ音を検出しました。
+ **[Voicemail (no beep)]** (ボイスメール: ビープ音なし):
+ Amazon Connect は、通話がボイスメールで終了したことを識別しましたが、ビープ音は検出されませんでした。
+ 通話がボイスメールで終了したことを Amazon Connect が認識しましたが、不明なビープ音を受け取りました。
+ **[Not detected]** (未検出): ボイスメールであるかどうかを認識できませんでした。これは、通話の応答が人間の音声によるものか、あるいは留守番電話によるものかを、Amazon Connect が明確に判断できない場合に発生します。この状態になる典型的な原因としては、長い沈黙や大きすぎる周囲の雑音などが考えられます。
+ **[Error]** (エラー): 通話のためのメディアが確立された後、Amazon Connect が正常に動作しないためにエラーが発生した場合、フローはこのパスに分岐します。メディアは、通話が人間の音声または留守番電話のいずれかで応答された場合に確立されます。通話がネットワークによって拒否された場合や、通話の発信中にシステムエラーが発生した場合、フローは実行されません。
+ このブロックは、[カスタマーファーストコールバックのユースケース](customer-first-cb.md)で重要です。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | いいえ - エラーブランチ |
| タスク | いいえ - [エラー] ブランチ |
| E メール | いいえ - [エラー] ブランチ |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ すべてのフロータイプ
## プロパティ
次の画像は、**[通話の進捗を確認]** ブロックの **[プロパティ]** ページを示しています。
![\[[通話の進捗を確認] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/check-call-progress-properties.png)
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[応答した呼び出し]**、**[ボイスメール (ビープ音)]**、**[ボイスメール (ビープ音なし)]**、**[検出されませんでした]**、**[エラー]** の各分岐があります。
![\[設定された [通話の進捗を確認] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/check-call-progress-configured.png)
# Amazon Connect のフローブロック: コンタクト属性の確認
このトピックでは、コンタクト属性の値との比較に基づいて分岐するフローブロックを定義します。
## 説明
+ コンタクト属性の値との比較に基づいて分岐します。
+ サポートされている比較条件には、[**～と等しい**]、[**～を超える**]、[**～以下**]、[**～より開始**]、[**～を含む**] などがあります。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ すべてのフロー
## プロパティ
次の画像は、**[コンタクト属性の確認]** ブロックの **[プロパティ]** ページを示しています。この例では、ブロックは、コンタクトが **PremiumCustomer** ([[ユーザー定義属性]](connect-attrib-list.md#user-defined-attributes)) かどうかを確認するように設定されています。
![\[[コンタクト属性の確認] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/check-contact-attributes-properties.png)
### 動的なチェック条件が可能
以下のような条件をチェックできます。
+ \$1.Attributes.verificationCode
NULL 値をチェックするには、Lambda を使用する必要があります。
### Amazon Lex 属性
**Type** = **Lex** である属性は次のように設定できます。
+ **[Alternative Intents]** (代替インテント): 通常は、優勢な Lex インテントで分岐するようにフローを設定します。ただし、状況によっては、代替インテントで分岐できます。これは、顧客が意味していたかもしれない事項です。
例えば、次の **[コンタクト属性の確認]** プロパティページの画像では、代替インテントは、Amazon Lex が 70% を超える信頼度で顧客が*詐欺*を企図していると判断した場合、それに応じてフローを分岐する必要があることを示しています。
![\[代替インテントについて設定された [コンタクト属性の確認] ブロックの [プロパティ] ページ。\]](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% の信頼度で、顧客が優勢なインテントではなく代替インテントを企図していると判断する場合、分岐します。
+ **[Intent Confidence Score]** (インテント信頼スコア): ボットが顧客のインテントを理解していることについてのボットの信頼度。例えば、顧客が「予定を更新したい」と言った場合、「*更新*」は「*スケジュールの変更*」または「*キャンセル*」を意味する場合があります。Amazon Lex は、0 から 1 までのスケールで信頼スコアを提供します。
+ 0 = 信頼性なし
+ 0.5 = 50% の信頼度
+ 1 = 100% の信頼度
+ **[Intent Name]** (インテント名): Amazon Lex によって返されるユーザーのインテント。
+ **[Sentiment Label]** (感情ラベル): 最高スコアの優勢な感情が何か。[POSITIVE] (肯定的)、[NEGATIVE] (否定的)、[MIXED] (混合)、または [NEUTRAL] (ニュートラル) で分岐できます。
+ **[Sentiment Score]** (感情スコア): Amazon Lex は、Amazon Comprehend と統合して、発話に現れる感情を判断します。
+ 肯定的
+ 否定的
+ [Mixed] (混合): 発話は肯定的な感情と否定的な感情の両方を表しています。
+ [Neutral] (ニュートラル): 発話は肯定的な感情も否定的な感情も表していません。
+ **セッションの属性**: セッション固有のコンテキスト情報を表すキーバリューのペアのマップ。
+ **スロット**: 対話中にユーザーによる入力から Amazon Lex が検出した、インテントのスロットのマップ (キー/値のペア)。
## 設定のヒント
+ 比較する条件が複数ある場合、Amazon Connectではリストされている順序でそれらの条件がチェックされます。
例えば、次の **[コンタクト属性の確認]** プロパティページの画像では、Amazon Connect が最初に **[60 超]** という条件を比較し、最後に **[2 超]** という条件を比較するように設定されています。
![\[複数の条件を比較するように設定された [コンタクト属性の確認] ブロックのプロパティページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/check-contact-attributes-tips-order-conditions-are-checked.png)
+ このブロックは、大文字と小文字を区別しないパターンマッチングをサポートしていません。例えば、**green** という単語と顧客タイプの **Green** をマッチさせようとすると、失敗します。大文字と小文字の入れ替えをすべて含める必要があります。
## Configured
次の画像は、このブロックが設定されているときの表示例を示しています。このブロックには、60 以上、10 以上、2 以上、および **[一致なし]** の条件ごとに 1 つずつ、合計 4 つのブランチがあることを示しています。
![\[設定済みの [コンタクト属性の確認] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/check-contact-attributes-configured.png)
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
+ [Amazon Connect に含まれる最初のコンタクトエクスペリエンスの着信フローのサンプル](sample-inbound-flow.md)
+ [Amazon Connect のコールバックでの割り込み可能キューフローのサンプル](sample-interruptible-queue.md)
## シナリオ
このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [Amazon Connect で問い合わせ属性を参照する方法](how-to-reference-attributes.md)
+ [コンタクトセンターへの問い合わせ方法に基づいて、問い合わせの経験をパーソナライズする](use-channel-contact-attribute.md)
# Amazon Connect のフローブロック: オペレーション時間の確認
このトピックでは、フローブロックを定義して、定義されたオペレーション時間内に問い合わせが発生したかどうかをチェックします。
## 説明
**Check hours of operation** フローブロックを設定して、問い合わせが任意の時点でどのパスを取るかを決定します。
+ ブロックで直接定義されたオペレーション時間をチェックします。
+ 何も指定しない場合、キューで定義されている現在の時間をチェックします。
+ 設計したオペレーション時間がオープン (時間単位) かクローズ (時間単位) かをチェックし、各ブランチの設定を提供します。
+ オプションで、オペレーション時間に関連するオーバーライド用の追加のブランチを作成する方法を提供する場合。たとえば、標準時間外パスを取る前に休日に特別な挨拶を再生する方法などです。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer queue flow (顧客キューフロー)]
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
**Check hours of operation** フローブロックを選択してプロパティを表示し、現在の日付と時刻に基づいて問い合わせが取るパスを定義します。
1. Amazon Connect 内で、**ルーティング**メニューに移動します。
1. **フロー**ページを選択します。
1. 目的のリソースを開きます。
1. Check **hours of operation **ブロックを見つけます。デフォルトのブランチがあります。
1. **時間単位**
1. **時間外**
1. **[エラー]**
1. フローブロックをクリックして、オプションでこのフローのオペレーション時間を指定します。
1. 指定しない場合、Amazon Connect は問い合わせのキューに関連付けられた時間を使用します。
1. 特定の日付に特別な分岐を設定する場合は、**オプションの分岐**セクションを見つけます。
![\[オペレーション時間のプロパティを確認します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/check-hours-of-operation-properties.png)
1. **Check override** を選択します。
1. 独自のパスを持つオーバーライドの名前を指定します。
1. **確認**を選択して変更を保存します。
1. 必要に応じて操作を繰り返します。
![\[オペレーションブランチの時間を確認します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/check-hours-of-operation-branches.png)
1. 新しいノードごとに目的のフローパスを構築します。
標準のday-of-the-week「」を参照してください[Amazon Connect を使用し、キューのオペレーション時間とタイムゾーンを設定する](set-hours-operation.md)。
オーバーライドの詳細については、「」を参照してください[オペレーション時間の延長、短縮、休日変則のオーバーライドを設定する](hours-of-operation-overrides.md)。
## エージェントキュー
インスタンス内のエージェントごとに自動的に作成されるエージェントキューには、オペレーション時間が含まれません。
このブロックを使用してエージェントキューのオペレーション時間を確認すると、このチェックは失敗し、問い合わせは [**Error (エラー)**] ブランチにルーティングされます。
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
[Amazon Connect に含まれる最初のコンタクトエクスペリエンスの着信フローのサンプル](sample-inbound-flow.md)
# Amazon Connect のフローブロック: キューの状態の確認
このトピックでは、顧客キューに設定した条件に基づいて、顧客キューの状態を確認するためのフローブロックを定義します。
## 説明
+ 指定された条件に基づいて、キューのステータスを確認します。
+ [**キューされていた時間**] または [**キューのキャパシティー**] の比較に基づいて分岐します。ます。
+ [**キューされていた時間**] とは、最も古い問い合わせがエージェントにルーティングされるか、キューから削除されるまでにキュー内で費やした時間です。
+ [**キュー容量**] とは、キューで待機している問い合わせの数です。
+ [**一致なし**] ブランチをたどります。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer queue flow (顧客キューフロー)]
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
次の画像は、**[キューの状態を確認する]** ブロックの **[プロパティ]** ページを示しています。この例では、コンタクトが BasicQueue に 2 分以上入っているかどうかを確認します。
![\[[キューの状態を確認する] の [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/check-queue-status-properties.png)
## 設定のヒント
条件を追加する順序は、実行時に意味を持ちます。結果は、条件をブロックに追加したのと同じ順に従って、条件に対して評価されます。問い合わせは、最初に一致した条件によってルーティングされます。
例えば、次の条件順序では、すべての値が最初の 2 つの条件のいずれかに一致します。他の条件に一致することはありません。
+ キューされていた時間 <= 90
+ キューされていた時間 >= 90
+ キューされていた時間 >= 9
+ キューされていた時間 >= 12
+ キューされていた時間 >= 15
+ キューされていた時間 >= 18
+ キューされていた時間 > 20
+ キューされていた時間 > 21
次の例では、キュー内の待機時間が 90 以下 (<=90) のすべての問い合わせは、最初の条件にのみ一致します。つまり、9 以下 (<=9)、12 以下 (<=12)、15 以下 (<=15)、18 以下 (<=18)、20 以下 (<=20)、21 以下 (<=21) は決して実行されません。90 より大きい値は、21 以上 (>=21) 条件ブランチにルーティングされます。
+ キューされていた時間 <= 90
+ キューされていた時間 <= 9
+ キューされていた時間 <= 12
+ キューされていた時間 <= 15
+ キューされていた時間 <= 18
+ キューされていた時間 < 20
+ キューされていた時間 < 21
+ キューされていた時間 > 21
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。これには、**[キューされていた時間]** 条件、**[一致なし]**、および **[エラー]** の 3 つのブランチがあります。
![\[設定済みの [キューの状態を確認する] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/check-queue-status-configured.png)
## シナリオ
このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [Amazon Connect でキュー内の問い合わせを管理するフローを設定する](queue-to-queue-transfer.md)
# Amazon Connect のフローブロック: 音声 ID を確認
**注記**
サポート終了通知: 2026 年 5 月 20 日、 AWS は Amazon Connect Voice ID のサポートを終了します。2026 年 5 月 20 日以降、Amazon Connect コンソールの Voice ID にアクセスしたり、管理者ウェブサイトまたは問い合わせコントロールパネルの Voice ID Amazon Connect 機能にアクセスしたり、Voice ID リソースにアクセスしたりできなくなります。詳細については、「[Amazon Connect Voice ID のサポート終了](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)」を参照してください。
このトピックでは、[音声 ID を確認] ブロックが Amazon Connect Voice ID によって返されるデータに基づいて分岐する方法を説明します。
## 説明
**注記**
[Voice ID の設定](set-voice-id.md) ブロックは、事前のフローで設定する必要があります。このブロックは、[Amazon Connect Voice ID](voice-id.md) に音声を送信して顧客のアイデンティティを確認し、そのステータスを返します。
**[Check Voice ID]** (Voice ID を確認する) ブロックでは、音声分析の結果と Voice ID が返すステータスに基づいて、分岐が行われます。
+ **[Enrollment status]** (登録ステータス):
+ **登録済み**: この通話者は音声認証に登録済みです。
+ **未登録**: 発信者は音声認証にまだ登録されていません。このステータスが返された場合は、例えば、登録のためにコールをエージェントに直接ルーティングしたりします。
+ **オプトアウト**: 発信者が音声認証をオプトアウトしています。
登録ステータスの確認は課金されません。
+ **[Voice authentication status]** (音声認証ステータス):
+ **認証済み**: 発信者のアイデンティティが確認されました。つまり、認証スコアがしきい値 (デフォルトのしきい値 90 またはカスタムしきい値) 以上です。
+ **非認証**: 認証スコアが設定したしきい値より低くなっています。
+ **不明**: 認証のための発信者の音声分析ができません。これは通常、認証の結果を出すのに必要な 10 秒の音声を、Voice ID が取得できなかったために発生します。
+ **未登録**: 発信者は音声認証にまだ登録されていません。このステータスが返された場合は、例えば、登録のためにコールをエージェントに直接ルーティングしたりします。
+ **オプトアウト**: 発信者が音声認証をオプトアウトしています。
結果が**[Inconclushive]** (不明)、**[Not enrolled]** (未登録)、または**[Opted out]** (オプトアウト) となった場合には、課金の対象になりません。
+ **[Fraud detection status]** (不正検出ステータス):
+ **[High risk]** (高リスク): リスクスコアが、設定されたしきい値に等しいか、それを超えています。
+ **[Low risk]** (低リスク): リスクスコアが、設定されたしきい値より小さい値です。
+ **[Inconclusive]** (不明): 通話者の声を分析できず、ウォッチリスト内にある不正通話を検出できません。
結果が**[Inconclusive]** (不明) の場合、課金対象にはなりません。
**注記**
**[登録ステータス]** および **[音声認証]** の場合、特定の顧客が対象となるため、[[顧客 ID]](connect-attrib-list.md) システム属性を [[コンタクト属性の設定](set-contact-attributes.md)] ブロックで設定する必要があります。**[不正検出]** については、その必要はありません。これは、特定の顧客に対して機能するのではなく、電話をかけてきた相手がウォッチリスト上の不正行為者に該当するかどうかを検出するための機能です。これは、正常に認証された顧客が、依然として高い不正リスクを抱えている可能性があることを意味します。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | いいえ - エラーブランチ |
| タスク | いいえ - [エラー] ブランチ |
| E メール | いいえ - [エラー] ブランチ |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer queue flow (顧客キューフロー)]
+ [Customer whisper flow (顧客ウィスパーフロー)]
+ アウトバウンドウィスパーフロー
+ エージェントウィスパーフロー
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
このブロックには設定するプロパティがありません。代わりに認証しきい値と、[Voice ID の設定](set-voice-id.md) から返されたボイスプリントに関する評価の結果に基づいて、問い合わせをルーティングするためのブランチが作成されます。
次の画像は、登録ステータスを確認するように設定されたときの **[音声 ID を確認]** ブロックの **[プロパティ]** ページを示しています。この設定が、**[Voice authentication]** (音声認証) と **[Fraud detection]** (不正検出)の場合では、それぞれ異なるステータス結果が返されます。
![\[[音声 ID を確認] ブロックの [プロパティ] ページ。[登録ステータス] オプションが選択されています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/check-voice-id-properties.png)
## 設定のヒント
このブロックを使用するフローを作成する場合は、次の順序でこれらのブロックを追加します。
1. [Voice ID の設定](set-voice-id.md) ブロック
1. [コンタクト属性の設定](set-contact-attributes.md) ブロック: **[Enrollment status]** (登録ステータス) および **[Voice authentication]** (音声認証) は特定の顧客に対して動作するため、[顧客 ID](connect-attrib-list.md)のシステム属性を [コンタクト属性の設定](set-contact-attributes.md) ブロックで設定する必要があります。
1. **[Check Voice ID]** (Voice ID を確認する) ブロック。
## 設定されているブロック
次の 3 つの画像は、以下を確認するように設定されたときの、このブロックの表示例を示しています。
1. 不正検出
1. 音声認証
1. 登録ステータス
![\[3 つの設定済み [音声 ID を確認] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/check-voice-id-configured.png)
## 詳細情報
このブロックの詳細については、以下のトピックを参照してください。
+ [Amazon Connect で Voice ID によるリアルタイムの発信者認証を使用する](voice-id.md)
+ [コンタクトコントロールパネル (CCP) の音声 ID に発信者を登録する](use-voiceid.md)
# Amazon Connect のフローブロック: 人員の確認
このトピックでは、現在のキューまたは指定した顧客キューで、エージェントが対応可能かどうかを確認するためのフローブロックを定義します。
## 説明
+ 現在の作業キュー、またはブロックで指定したキューで、エージェントが[対応可能](metrics-definitions.md#available-real-time)、[対応中](metrics-definitions.md#staffed-agents)、または[オンライン](metrics-definitions.md#online-agents)かどうかについて確認します。
+ エージェントに通話を転送し、その通話をキューに入れる前に、[**Check hours of operation (オペレーション時間を確認する)**] および [**Check staffing (人員の確認)**] ブロックが使用されていることを確認します。これらにより、通話が勤務時間内にあり、エージェントがサービスに配置されていることが確認されます。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer queue flow (顧客キューフロー)]
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
次の画像は、**[人員の確認]** ブロックの **[プロパティ]** ページを示しています。BasicQueue のエージェントにコンタクトをルーティングするための空きがあるかどうかを確認するように設定されています。
![\[[人員の確認] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/check-staffing-properties.png)
[**チェックするステータス**] ドロップダウンボックスで、次のいずれかのオプションを選択します。
+ [使用可能](metrics-definitions.md#available-real-time) = キュー内の少なくとも 1 人のエージェントが**対応可能**であるかどうかを確認します。
+ [配置エージェント](metrics-definitions.md#staffed-agents) = キュー内の少なくとも 1 人のエージェントが、**対応可能**、**通話中**、または**アフターコンタクトワーク中**かどうかを確認します。
+ [オンラインエージェント](metrics-definitions.md#online-agents) = キュー内の少なくとも 1 人のエージェントが、**対応可能**、**配置済み**、またはカスタム状態にあるかどうかを確認します。
## 設定のヒント
+ フローで **[Check staffing]** (人員の確認) ブロックを使用する前にキューを設定する必要があります。[作業キューの設定](set-working-queue.md) ブロックを使用してキューを設定できます。
+ キューが設定されていない場合、問い合わせは [**Error (エラー)**] ブランチにルーティングされます。
+ 1 つのフローから別のフローに問い合わせが転送されると、フローに設定されているキューがそのフローから次のフローに渡されます。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[True]**、**[False]**、**[エラー]** の 3 つのブランチがあります。
![\[設定済みの [人員の確認] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/check-staffing-configured.png)
## シナリオ
このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [Amazon Connect で問い合わせを特定のエージェントに転送する](transfer-to-agent.md)
# Amazon Connect のフローブロック: コンタクトのタグ
このトピックでは、コンタクトにタグを作成して適用するためのフローブロックを定義します。
## 説明
+ このブロックを使用して、ユーザー定義タグ (キー:バリューペア) を作成し、コンタクトに適用します。
+ ユーザー定義タグは、最大 6 つ作成できます。
+ フローで参照する値は後で設定できます。例えば、タグのセグメントへの関連性がなくなった場合など、フローのタグを削除することもできます。
+ タグを使用して Amazon Connect の使用状況をさらに詳しく表示する方法の詳細については、「[Amazon Connect の使用状況を詳細に表示する詳細な請求を設定する](granular-billing.md)」を参照してください。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ すべて
## プロパティ
次の画像は、**[コンタクトのタグ]** ブロックの **[プロパティ]** ページを示しています。このタグは、現在のコンタクトにキーが **[Department]**、値が **[Finance]** のタグを指定するように設定されています。
![\[コンタクトのタグのプロパティページ\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/granularbilling-contacttags-properties.png)
次の画像のとおり、コンタクトのタグを解除するようにブロックを設定することもできます。
![\[コンタクトのタグのプロパティページ\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/granularbilling-contacttags-properties-untag.png)
## 設定のヒント
+ Amazon Connect がユーザー定義のタグを処理する方法の詳細については、「[ユーザー定義のタグについて知っておくべきこと](granular-billing.md#about-user-defined-tags)」を参照してください。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** の 2 つのブランチがあります。
![\[設定済みのコンタクトのタグのブロック\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/granularbilling-contacttaggingblock-config.png)
# Amazon Connect のフローブロック: 常設コンタクト関連付けの作成
このトピックでは、常設コンタクトの関連付けを作成するためのフローブロックを定義し、コンタクトとの会話を中断した場所から続行できるようにします。
## 説明
+ 現在のチャットで常設チャットのエクスペリエンスを有効にします。
+ これにより、必要なリハイドレートモードを選択できます。チャットのリハイドレートの詳細については、「[顧客が Amazon Connect でチャットの会話を再開できるようにする](chat-persistence.md)」を参照してください。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | いいえ - [エラー] ブランチ |
| Chat | はい |
| タスク | いいえ - [エラー] ブランチ |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer Queue flow (顧客キューフロー)]
+ 顧客保留フロー
+ 顧客ウィスパーフロー
+ アウトバウンドウィスパーフロー
+ エージェント保留フロー
+ エージェントウィスパーフロー
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
次の画像は、**[常設コンタクト関連付けの作成]** ブロックの **[プロパティ]** ページを示しています。
![\[常設コンタクト関連付けの作成ブロックのプロパティページ\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/create-persistent-contact-association-properties.png)
## 設定のヒント
+ 常設チャットを有効にするには、**[常設コンタクト関連付けの作成]** ブロックを追加するか、[StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html) API の `SourceContactId` の以前の `contactId` を指定します。ただし、この両方を指定することはできません。新しいチャットで `SourceContactID` の永続化を有効にできるのは 1 回のみです。
次の機能を使用する場合は、**[常設コンタクト関連付けの作成]** ブロックを使用して常設チャットを有効にすることをお勧めします。
+ [Amazon Connect チャットウィジェット](add-chat-to-website.md)
+ [Apple Messages for Business](apple-messages-for-business.md)
+ 過去のチャット会話全体をリハイドレートしたり、過去のチャット会話の特定のセグメントからリハイドレートしたりするように永続チャットを設定できます。リハイドレートタイプの詳細については、「[顧客が Amazon Connect でチャットの会話を再開できるようにする](chat-persistence.md)」を参照してください。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** の 2 つのブランチがあります。
![\[設定済みの [常設コンタクト関連付けの作成] ブロック\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/create-persistent-contact-association-configured.png)
# Amazon Connect のフローブロック: タスクの作成
このトピックでは、新しいタスクを手動で作成するか、既存のタスクテンプレートに基づいて作成するためのフローブロックを定義します。
## 説明
+ 手動で、または[タスクテンプレート](task-templates.md)を利用して、新しいタスクを作成します。
+ タスク属性を設定します。
+ フローを開始してタスクをすぐに開始するか、将来の日付と時刻にスケジュール設定します。
Amazon Connect のタスクの詳細については、「[Amazon Connect のタスクチャネル](tasks.md)」と「[Amazon Connect タスクでのタスクの一時停止と再開](concepts-pause-and-resume-tasks.md)」を参照してください。
**注記**
Amazon Connect インスタンスが 2018 年 10 月以前に作成されている場合、問い合わせはエラーブランチにルーティングされます。問い合わせが正常なパスにルーティングされるようにするには、次の許可を持つ IAM ポリシーを作成し、そのポリシーを Amazon Connect のサービスロールにアタッチします。Amazon Connect のサービスロールは、Amazon Connect インスタンスの **[Account overview]** (アカウントの概要) ページに表示されます。
```
{
"Effect": "Allow",
"Action": "connect:StartTaskContact",
"Resource": "*"
}
```
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ すべてのフロー
## プロパティ
**[タスクの作成]** ブロックを設定するときには、**[手動で作成]** または **[テンプレートを使用]** を選択します。選択に応じて、**[プロパティ]** ページの残りの部分で入力する必要があるフィールドが決まります。この 2 つのオプションの詳細を以下に示します。
### オプション 1: 手動で作成
次の画像は、**[手動で作成]** を選択したときの **[プロパティ]** ページを示しています。ページ上のすべての設定は、手動または動的に指定できます。
![\[[タスクを作成] ブロックの [プロパティ] ページ、[手動で作成] オプション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/create-task-properties-manually.png)
ページ下部の **[テンプレートを使用]** を選択すると、ページ全体がそのオプションに切り替わります。必要に応じて、**[手動で作成]** に戻り、手動設定を続けることができます。
### オプション 2: テンプレートを使用
[テンプレートを作成](task-templates.md)したら、そのテンプレートを **[タスクの作成]** ブロックで指定できるようになります。
次の画像は、**[テンプレートを使用]** を選択したときの **[プロパティ]** ページを示しています。
+ 選択したテンプレートにフローが含まれていない場合は、タスクを実行するフローを指定する必要があります。
+ テンプレートによって入力されたページ上のフィールドの設定を上書きすることはできません。
![\[[プロパティ] ページ、[テンプレートを使用] オプション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/create-task-properties-template.png)
## 設定のヒント
+ **タスクの作成** タスクが正常に作成されたかどうかに基づいてブランチをブロックします。
+ **成功** タスクが作成された場合。新しく作成したタスクの問い合わせ ID で応答します。
+ **エラー** タスクが作成されなかった場合。
+ **タスクコンタクト ID の参照**: 新しく作成されたタスクは、ブロックの **[フロー]** セクションで指定したフローを実行するか、選択したタスクテンプレートによって設定されたフローを実行します。後続のブロックで新しく作成されたタスクの問い合わせ ID は、参照できます。
例えば、**[Play prompt]** (プロンプトの再生) ブロックでタスクの問い合わせ ID を参照する場合などです。次の属性を使用して、タスクの問い合わせ ID を動的に指定できます。
+ **[名前空間: システム]**
+ **[値: タスクコンタクト ID]**
+ **タスクのスケジュール設定**: **[属性を使用して日付と時刻を設定]** する場合: 日付フィールドの値は Unix タイムスタンプ (エポック秒) でなければなりません。このため、ほとんどの場合、**[名前空間]** には **[ユーザー定義]** 属性を選択します。
例えば、フローに *scheduledTaskTime* という名前のキーを持つユーザー定義属性を設定する **[コンタクト属性の設定]** ブロックがあるとします。その場合、**[タスクの作成]** ブロックで、**[ユーザー定義]** を選択すると、キーは *scheduledTaskTime* になります。
この例を続けるには、*scheduledTaskTime* の値に Unix タイムスタンプを指定する必要があります。例えば、1679609303 は、2023 年 3 月 23 日木曜日午後 10 時 8 分 23 秒 (UTC) に対応する Unix タイムスタンプです。
日付と時刻が経過すると、問い合わせは常に**[Error]** (エラー) ブランチへルーティングされます。**[Error]** (エラー) ブランチへ移動するのを回避するには、エポック秒を将来の有効な日付と時刻に更新してください。
+ タスクを自動的にコンタクトに関連付けるには、**[コンタクトへのリンク]** オプションを使用します。
+ タスクと API スロットリングの[サービスクォータ](amazon-connect-service-limits.md)、および必要に応じてリクエストが増加することを確認してください。クォータは、このブロックがタスクを作成するときに適用されます。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** の 2 つのブランチがあります。
![\[設定された [タスクの作成] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/create-task-configured.png)
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
+ [Amazon Connect に含まれる最初のコンタクトエクスペリエンスの着信フローのサンプル](sample-inbound-flow.md)
# 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)
# Amazon Connect のフローブロック: データテーブル
## 説明
Amazon Connect のデータテーブルブロックを使用すると、問い合わせフロー内のデータテーブルからデータを評価、一覧表示、または書き込むことができます。このブロックは、Amazon Connect データテーブルに保存されている構造化データとやり取りすることで、動的な意思決定、パーソナライズされたカスタマーエクスペリエンス、データ管理を容易にします。
## ユースケース
データテーブルブロックは、次の場合に便利です。
+ **設定の取得** – データテーブルに保存されているビジネスルール、ルーティングパラメータ、または運用設定にアクセスします。
+ **動的ルーティングの決定** — データテーブルをクエリして、顧客属性に基づいて適切なキュー、エージェント、またはフローパスを決定します。
+ **ステータスチェック** – 特定のアクションに進む前に、アカウントのステータス、適格性、またはその他の条件を確認します。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ すべてのフロー
## 設定の概要
### アクションの選択
実行するオペレーションのタイプを選択します。
+ データテーブルからの読み取り – データのクエリまたは取得 (アクションの評価または一覧表示)
+ データテーブルへの書き込み – 新しいレコードを作成するか、既存のレコードを更新します。
### データテーブルを定義する
+ データテーブルを直接選択するには、**手動で設定**を選択します。
+ ドロップダウンからターゲットデータテーブルを選択する
+ 重要: 特定のデータテーブルを選択すると、インターフェイスはそのテーブルから使用可能な属性を関連する設定セクションに自動的に入力します。
## データテーブル値の評価
評価アクションを使用して、データテーブルをクエリし、定義された基準に基づいて特定の属性値を取得します。
次の図は、**データテーブル**の値を評価するように設定されたデータテーブルブロックの**プロパティ**ページを示しています。
![\[評価アクション用に設定されたデータテーブルブロックのプロパティページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/data-table-evaluate.png)
### 設定手順
1. アクションとして**データテーブルから読み**取るを選択します。
1. 読み取りアクションドロップダウンから**データテーブル値の評価**を選択します。
1. クエリの設定:
+ データテーブルブロックごとに最大 5 つのクエリを設定できます。データテーブルの評価ブロックごとに少なくとも 1 つのクエリが必要です。
+ 各クエリについて:
+ **クエリ名 (必須)** – クエリのわかりやすい名前を指定します。重要: クエリ名は、この特定のブロック内だけでなく、フロー全体で一意である必要があります。
+ **プライマリ属性** – データテーブルを手動で選択すると、UI はそのテーブルのスキーマからプライマリ属性のリストを自動的に入力します。すべてのプライマリ属性フィールドは必須です。表示される各プライマリ属性の値を指定する必要があります。これらの属性は、データテーブル内の特定の行 (複数可) を識別するフィルターとして機能します。
+ **クエリ属性** – データテーブルを手動で選択すると、ドロップダウンにそのテーブルから使用可能なすべての属性が自動的に入力されます。ドロップダウンから 1 つ以上の属性を選択します。これらは、返され、フローで使用できるデータフィールドです。取得された値は、クエリ名を使用して後続のブロックで参照できます。
### Evaluate の主な詳細
+ **クエリ制限** – ブロックあたり最大 5 つのクエリ
+ **最小要件** – 少なくとも 1 つのクエリを設定する必要があります
+ **クエリ名の一意性** – 問い合わせフロー全体で一意である必要があります
+ **属性マッチング** – プライマリ属性は完全一致を使用して行を見つけます
+ **必須フィールド** – すべてのプライマリ属性が必須です
### Evaluate 用に取得したデータへのアクセス
評価アクションを実行した後、取得した属性値には、名前空間形式 を使用してアクセスできます`$.DataTables.QueryName.AttributeName`。括弧と一重引用符を使用して、特殊文字で属性名を参照します。例えば、`$.DataTables.CustomQuery['my attribute name with spaces']`。**データテーブル**名前空間の動的ドロップダウン選択を使用する場合、ルート名前空間 は省略`$.DataTables.`できます。
+ **コンポーネント:**
+ `QueryName` – 設定でクエリに割り当てた一意の名前
+ `AttributeName` – 取得するために選択した属性の名前
+ **使用状況** – これらの値は、次のような後続のフローブロックで参照できます。
+ 問い合わせ属性ブロックを確認する (条件分岐の場合)
+ 問い合わせ属性ブロックを設定する (他の名前空間に保存するため)
+ プロンプトブロックを再生する (パーソナライズされたメッセージを提供するため)
+ Lambda 関数ブロックを呼び出す (入力パラメータとして渡す)
+ **例** – 属性accountStatus」とloyaltyTier」を取得するCustomerLookup」という名前のクエリを設定した場合:
+ アクセスアカウントのステータス: `$.DataTables.CustomerLookup.accountStatus`
+ ロイヤルティ階層にアクセスする: `$.DataTables.CustomerLookup.loyaltyTier`
+ **メモ:**
+ クエリが結果を返さないか、 属性が見つからない場合、参照は空または null になります。
+ タイプリストのデータテーブル値はサポートされていません。
+ 後続のデータテーブルブロックは、データテーブル名前空間から以前のクエリをクリアします。
+ データテーブル名前空間のクエリ結果は、データテーブルフローブロックを含むフローでのみ使用できます。
## データテーブル値を一覧表示する
リストアクションを使用して、指定した条件に一致するデータテーブルから行全体を取得します。
次の図は、**データテーブル**値を一覧表示するように設定されたデータテーブルブロックの**プロパティ**ページを示しています。
![\[リストアクション用に設定されたデータテーブルブロックのプロパティページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/data-table-list.png)
### 設定手順
1. アクションとして**データテーブルから読み**取るを選択します。
1. 読み取りアクションドロップダウンから**データテーブル値を一覧表示**を選択します。
1. プライマリ値グループの設定:
+ 最大 5 つのプライマリ値グループを追加して、さまざまなフィルタリング条件のセットを定義できます。
+ プライマリ値グループごとに:
+ **グループ名 (必須)** – プライマリ値グループのわかりやすい名前を指定します。この名前は、後続のフローブロックで取得されたレコードセットを参照するために使用されます。重要: グループ名は、この特定のブロック内だけでなく、フロー全体で一意である必要があります。
+ **プライマリ属性** – データテーブルを手動で選択すると、UI はそのテーブルのスキーマからプライマリ属性のリストを自動的に入力します。すべてのプライマリ属性フィールドは必須です。表示される各プライマリ属性の値を指定する必要があります。これらの属性は、返されるデータテーブル内の特定の行を識別するフィルターとして機能します。
注: 特定の属性値を取得する評価アクションとは異なり、リストアクションは、プライマリ属性条件に一致するレコード全体 (すべての属性) を返します。
### リストの主な詳細
+ **プライマリ値グループの制限** – ブロックあたり最大 5 つのプライマリ値グループ
+ **グループ名の一意性** – 問い合わせフロー全体で一意である必要があります
+ **属性マッチング** – プライマリ属性は完全一致を使用して行を見つけます
+ **戻り動作** – 選択した属性だけでなく、完全なレコードを返します。プライマリ値グループが設定されていない場合、テーブル全体が 32KB の制限で にロードされます。
### リストの取得データへのアクセス
List アクションを実行すると、取得されたデータは構造化された形式で保存されます。次の名前空間パターンを使用してデータにアクセスできます。
+ **メタデータアクセス:**
+ データテーブル ID: `$.DataTableList.ResultData.dataTableId`
+ ロックバージョン: `$.DataTableList.ResultData.lockVersion.dataTable`
+ **データアクセスのリスト** — リストから特定のデータにアクセスするには:
+ インデックスで特定の行にアクセスします。 `$.DataTableList.ResultData.primaryKeyGroups.GroupName[index]`
+ プライマリキー値にアクセスします。 `$.DataTableList.ResultData.primaryKeyGroups.GroupName[index].primaryKeys[index].attributeValue`
+ アクセス属性値: `$.DataTableList.ResultData.primaryKeyGroups.GroupName[index].attributes[index].attributeValue`
+ **使用状況** – これらの値は、次のような後続のフローブロックで参照できます。
+ 問い合わせ属性ブロックを設定する (特定の値を抽出して保存する)
+ Lambda 関数ブロックまたはモジュールを呼び出す (処理のために結果セット全体を渡すため)
+ **例** – "OrderHistory" という名前のプライマリ値グループを設定した場合:
+ 最初の行にアクセスする: `$.DataTableList.ResultData.primaryKeyGroups.OrderHistory[0]`
+ 最初の行の最初の属性値にアクセスします。 `$.DataTableList.ResultData.primaryKeyGroups.OrderHistory[0].attributes[0].attributeValue`
+ **メモ:**
+ リストは、選択したレコードだけでなく、完全なレコード (すべての属性) を返します。
+ 一致するレコードが見つからない場合、primaryKeyGroups 配列は空になります。
+ プライマリキーグループが設定されていない場合、テーブル全体がロードされ、結果は「デフォルト」グループ名でアクセスできます。 `$.DataTableList.ResultData.primaryKeyGroups.default[index]`
+ フローブロック内の配列要素にアクセスするときは、バックティックを使用して JSONPath リファレンスをラップします。 ``$.DataTableList.ResultData.primaryKeyGroups.[index]``
## データテーブルへの書き込み
書き込みアクションを使用して、データテーブルに新しいレコードを作成したり、既存のレコードを更新したりできます。
次の図は、**データテーブル**に書き込むように設定されたデータテーブルブロックの**プロパティ**ページを示しています。
![\[書き込みアクション用に設定されたデータテーブルブロックのプロパティページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/data-table-write.png)
### 設定手順
1. データ**テーブルへの書き込み**をアクションとして選択します。
1. プライマリ値グループの設定:
+ 複数のプライマリ値グループを追加して、書き込みまたは更新する異なるレコードを定義できます。書き込みデータテーブルブロックごとに少なくとも 1 つのプライマリ値グループが必要です。
+ インターフェイスには、タブを介して 2 つの入力方法があります。
+ 入力タブ – 構造化フォームベースの設定 (ほとんどのユーザーに推奨)
+ Raw JSON タブ – 上級ユーザーの直接 JSON 入力
+ プライマリ値グループごとに:
+ **グループ名 (必須)** – プライマリ値グループのわかりやすい名前を指定します。この名前は、後続のフローブロックで書き込みオペレーションを参照するために使用されます。重要: グループ名は、この特定のブロック内だけでなく、フロー全体で一意である必要があります。
+ **プライマリ属性** – データテーブルを手動で選択すると、UI はそのテーブルのスキーマからプライマリ属性のリストを自動的に入力します。すべてのプライマリ属性フィールドは必須です。表示される各プライマリ属性の値を指定する必要があります。これらの属性は、どのレコードを作成または更新するかを決定するキーフィールドとして機能します。一致するプライマリ属性値を持つレコードが存在する場合は更新されます。存在しない場合は、新しいレコードが作成されます。
+ **書き込む属性を設定する**
+ **属性名 (必須)** – データテーブルを手動で選択すると、ドロップダウンにそのテーブルから使用可能なすべての属性が自動的に入力されます。書き込みまたは更新する属性を選択します。Add attribute **to write をクリックして、複数の属性**を追加できます。
+ **属性値設定** – 属性ごとに、次のいずれかのオプションを選択します。
+ 属性値を設定する (デフォルトで選択) – 属性に書き込む値を指定します。このフィールドは、このオプションが選択されている場合は必須です。値は、静的テキスト、問い合わせ属性、またはシステム変数です。
+ デフォルト値を使用する – データテーブルスキーマで定義されたデフォルト値を使用します。このオプションを選択した場合、追加の値入力は必要ありません。
+ **ロックバージョンの設定** – ロックバージョン設定は、データテーブルへの同時書き込みオペレーションの処理方法を制御します。
+ 最新オプションを使用する – 常に最新バージョンのレコードに書き込みます。同時更新の可能性が低い、または許容できるほとんどのユースケースに適しています。
+ 動的設定オプション – Lambda またはモジュールを使用して、実行時にバージョン番号を動的に指定できます。
### 書き込みの属性制限
書き込みアクションの合計属性制限は、1 つのブロック内のすべてのプライマリ値グループで 25 です。この制限は次のように計算されます。
+ プライマリ値グループに「書き込む属性」が設定されていない場合 – そのグループのプライマリ属性値の数は、合計制限にカウントされます。
+ プライマリ値グループに「書き込む属性」が設定されている場合 – 書き込む属性の数は合計制限にカウントされます (この場合、プライマリ属性はカウントされません）。
**例:**
+ 例 1: 3 つのプライマリ属性を持ち、書き込む属性がないプライマリ値グループ = 制限に対して 3
+ 例 2: 書き込む 3 つのプライマリ属性と 5 つの属性を持つプライマリ値グループ = 制限に対して 5
+ 例 3: 3 つのプライマリ値グループ。それぞれ 3 つのプライマリ属性と 5 つの書き込み属性を持つ = 制限に対して 15 (5 \$1 5 \$1 5)
重要: すべてのプライマリ値グループでカウントされたすべての属性の合計が 25 を超えることはできません。
### 書き込みの主な詳細
+ **最小要件** – 少なくとも 1 つのプライマリ値グループを設定する必要があります
+ **プライマリ値グループに制限なし** – List アクションとは異なり、プライマリ値グループの数には固定制限はありません。
+ **属性制限** – すべてのプライマリ値グループでカウントされた属性の合計が 25 を超えることはできません
+ **属性マッチング** – プライマリ属性は完全一致を使用してターゲットレコードを識別します
+ **必須フィールド** – すべてのプライマリ属性と選択した属性値 (「属性値の設定」を選択した場合) は必須です
+ **アップサート動作** – 一致するプライマリ属性を持つレコードが存在する場合は更新されます。存在しない場合は、新しいレコードが作成されます。
## 設定されているブロック
設定すると、このブロックには**成功**と**エラー**のブランチがあります。
# Amazon Connect のフローブロック: 切断/ハングアップ
このトピックでは、通話の終了時にコンタクトを切断するためのフローブロックを定義します。
## 説明
+ 問い合わせを切断します。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer queue flow (顧客キューフロー)]
+ エージェントへの転送フロー
+ キューへの転送フロー
# Amazon Connect のフローブロック: 分散 (%)
このトピックでは、割合 (%) に基づいて、顧客をランダムにキューにルーティングするためのフローブロックを定義します。
## 説明
+ このブロックは、A/B テストを行うのに便利です。割合 (%) に基づいてランダムに顧客をルーティングします。
+ 問い合わせはランダムに分配されるため、正確にパーセント表示されない場合があります。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer queue flow] (顧客キューフロー)
+ アウトバウンドウィスパーフロー
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
次の画像は、**[分散 (%)]** ブロックの **[プロパティ]** ページを示しています。コンタクトの 50% をテストブランチにルーティングするように設定されています。
![\[[分散 (%)] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/distribute-by-percentage-properties.png)
## 仕組み
このブロックにより、ブロックの設定方法に基づいて静的割り当てルールが作成されます。内部ロジックは 1～100 の乱数を生成します。この数値は、どのブランチを取るかを識別します。内部ロジックは、現在または過去のボリュームをそのロジックの一部として使用しません。
例えば、ブロックが次のように設定されているとします。
+ 20% = A
+ 40% = B
+ 残り 40% = デフォルト
問い合わせ a がフローを介してルーティングされている場合、Amazon Connect は乱数を生成します。
+ 乱数が 0～20 の間である場合、問い合わせは A ブランチにルーティングされます。
+ 21～60 の間である場合、問い合わせは B ブランチにルーティングされます。
+ 60 より大きい場合、問い合わせはデフォルトブランチにルーティングされます。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[50% テスト]** と **[50% デフォルト]** の 2 つのブランチを示しています。
![\[設定された [分散 (%)] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/distribute-by-percentage-configured.png)
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
+ [Amazon Connect の A/B コンタクト分散テストのサンプルフロー](sample-ab-test.md)
# Amazon Connect のフローブロック: 終了フロー/再開
## 説明
**重要**
終了フロー/再開ブロックはターミナルフローブロックです。このブロックは、インタラクション全体を中断することなく、一時停止したフローを終了してコンタクトに戻ることができます。ただし、**[終了フロー/再開]** ブロックをインバウンドフローまたは切断フローに配置すると、**[切断]** ブロックと同様に機能して、コンタクトを終了します。
+ コンタクトを切断せずに現在のフローを終了する
+ このブロックは、多くの場合、[**キューへ転送**] ブロックの [**成功**] ブランチに使用されます。コールがエージェントによって取得されるまで、フローは終了しません。
+ [**Loop prompts (プロンプトのループ)**] ブロックが中断された場合に、このブロックを使用することもできます。顧客を [**プロンプトのループ**] ブロックに戻すことができます。
+ このブロックを使用して、インタラクション全体を中断することなく、一時停止したフローを終了してコンタクトに戻ることができます。例えば、[タスクを一時停止したり再開したりする](concepts-pause-and-resume-tasks.md)フローで役に立ちます。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
**重要**
**[終了フロー/再開]** ブロックをインバウンドフローまたは切断フローに配置すると、**[切断]** ブロックと同様に機能し、コンタクトを終了します。
+ すべてのフロー
## プロパティ
次の画像は、**[終了フロー/再開]** ブロックの **[プロパティ]** ページを示しています。
![\[[終了フロー/再開] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/end-flow-properties.png)
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。[終了フロー/再開] 終了イベントのブランチはありません。
![\[[終了フロー/再開] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/end-flow-configured.png)
# Amazon Connect のフローブロック: 顧客の入力の取得
このトピックでは、顧客情報のキャプチャ、顧客の応答用のインタラクティブな電話メニューの作成、フロー内の特定のパスへの顧客のルーティングなどのタスクのフローブロックを定義します。
## 説明
お客様からのインタラクティブで動的な入力を取得します。DTMF 入力 (電話からの入力) と Amazon Lex ボットによる割り込み可能なプロンプトに対応しています。
このブロックでは、個々の数字 (0～9) と特殊文字 \$1 と \$1 のみを使用できます。複数桁の入力はサポートされていません。顧客のクレジットカード番号を収集するなど、複数桁を入力する場合は、[[顧客の入力を保存する](store-customer-input.md)] ブロックを使用します。
## このブロックのユースケース
このブロックは、以下のシナリオでの使用を想定して設計されています。
+ お客様がタッチトーンキーパッドを使用して応答できる、インタラクティブな電話メニューを作成する。たとえば、「セールスの場合は 1 を押し、サポートの場合は 2 を押してください」
+ Amazon Lex ボットでこのブロックを使用して、音声認識のプロンプトを有効にする。お客様は話しかけることでプロンプトを中断できます。お客様にとって、対話がより自然で、応答性の高いものになります。
+ お客様からの入力内容に基づいて、フロー内の特定のパスにお客様をルーティングする。これにより、お客様をご要望に基づいて適切な部署やサービスに案内できます。
+ お客様が満足度や懸念を表明できるような選択肢を提示して、お客様からのフィードバックを収集する。
+ アンケートを実施してお客様の意見を聞き、貴重なフィードバックやインサイトを収集する。
+ お客様の問題に関する具体的な質問をして、お客様にトラブルシューティングプロセスを案内する。回答内容に基づいて、お客様に合わせたソリューションを提案できます。
## コンタクトのタイプ
次の表は、このブロックでのコンタクトのルーティング方法をチャネルごとに示しています。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい (ただし、Amazon Lex が使用されている場合。それ以外の場合は **[エラー]** ブランチに分岐) |
| タスク | いいえ |
| E メール | いいえ |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
| フロータイプ | サポート対象? |
| --- | --- |
| 着信フロー | はい |
| 顧客キューフロー | はい |
| 顧客保留フロー | いいえ |
| 顧客ウィスパーフロー | いいえ |
| アウトバウンドウィスパーフロー | はい |
| エージェント保留フロー | いいえ |
| エージェントウィスパーフロー | いいえ |
| エージェントへの転送フロー | はい |
| キューへの転送フロー | はい |
## このブロックの設定方法
Get customer input ブロックを設定するには、 Amazon Connect 管理ウェブサイトを使用するか、Amazon Connect Flow 言語の [GetParticipantInput](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-getparticipantinput.html) アクション、または [ConnectParticipantWithLexBot](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-connectparticipantwithlexbot.html) および [Compare](https://docs.aws.amazon.com/connect/latest/APIReference/flow-control-actions-compare.html) アクションを使用します。
**Topics**
+ [プロンプトの選択](#get-customer-input-prompt)
+ [DTMF 入力用に設定する](#get-customer-input-dtmf)
+ [Amazon Lex 入力用に を設定する](#get-customer-input-lex-tab-properties)
+ [フローブロックのブランチ](#gci-branches)
+ [追加の設定のヒント](#get-customer-input-tips)
+ [このブロックで生成されるデータ](#gci-data)
### プロンプトの選択
次の画像は、**[お客様の入力を取得する]** ブロックの **[プロパティ]** ページを示しています。「Welcome to Example Corp」という音声プロンプトを再生するように、手動で設定されています。
![\[[顧客の入力を取得する] ブロックのプロパティページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-customer-input-properties1a.png)
次のオプションの中から、お客様に再生するプロンプトを選択します。
+ **プロンプトライブラリ (オーディオ) から選択**: Amazon Connect に含まれている録音済みプロンプトのいずれかから選択するか、 Amazon Connect 管理ウェブサイトを使用して独自のプロンプトを記録およびアップロードできます。
+ **[S3 バケットから音声ファイルを指定]**: S3 バケットにある音声ファイルを手動で、または動的に指定できます。
+ **[テキスト読み上げまたはチャットテキスト]**: 再生するプロンプトをプレーンテキストまたは SSML で入力できます。これらのテキストベースのプロンプトは、Amazon Polly を使用してお客様に音声プロンプトとして再生されます。SSML 拡張テキストで入力した方が、指定したテキストから Amazon Connect で音声を生成する方法を細かく制御できます。発音、音量、話す速度など、音声のさまざまな要素をカスタマイズして制御できます。
### DTMF 入力用に設定する
次の画像は、**[プロパティ]** ページの [DTMF] セクションを示しています。お客様が 1 を押すか 2 を押すかに応じて適切な分岐を判断するために、条件が 2 つ追加されています。お客様が何も入力しなかった場合は 5 秒後にタイムアウトします。
![\[プロパティページの [DTMF] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-customer-input-properties2a.png)
次のオプションを選択します。
+ [**Set timeout (タイムアウトの設定)**]: ユーザーがプロンプトに応答する方法を決定するまでの待機時間を指定します。
+ 最小値: 1 秒
+ 最大値: 180 秒
この時間が経過すると、タイムアウトエラーが発生します。音声チャネルの場合、一桁目の DTMF が入力されるまでのタイムアウトです。静的に定義する必要があり、0 より大きい有効な整数でなければなりません。
+ **[条件の追加]**: 顧客の入力と比較照合される数値。
#### DTMF を使用する場合の Flow 言語表現
次のコード例は、DTMF の設定が、Flow 言語の [GetParticipantInput](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-getparticipantinput.html) アクションではどのように表現されるかを示しています。
```
{
"Parameters": {
"StoreInput": "False",
"InputTimeLimitSeconds": "5",
"Text": "Welcome to Example Corp. Please press 1 for sales, press 2 for support"
},
"Identifier": "Get Customer Input",
"Type": "GetParticipantInput",
"Transitions": {
"NextAction": "d8701db7-3d31-4581-bd4c-cb49c38c6f43",
"Conditions": [
{
"NextAction": "d8701db7-3d31-4581-bd4c-cb49c38c6f43",
"Condition": {
"Operator": "Equals",
"Operands": [
"1"
]
}
},
{
"NextAction": "d8701db7-3d31-4581-bd4c-cb49c38c6f43",
"Condition": {
"Operator": "Equals",
"Operands": [
"2"
]
}
}
],
"Errors": [
{
"NextAction": "d8701db7-3d31-4581-bd4c-cb49c38c6f43",
"ErrorType": "InputTimeLimitExceeded"
},
{
"NextAction": "d8701db7-3d31-4581-bd4c-cb49c38c6f43",
"ErrorType": "NoMatchingCondition"
},
{
"NextAction": "d8701db7-3d31-4581-bd4c-cb49c38c6f43",
"ErrorType": "NoMatchingError"
}
]
}
}
```
### Amazon Lex 入力用に を設定する
+ **Lex ボットを選択**: Amazon Lex ボットを作成したら、ドロップダウンリストからボットの名前を選択します。構築済みのボットのみが、ドロップダウンリストに表示されます。
+ [ARN を入力]: Amazon Lex ボットの Amazon リソースネームを指定します。
+ **[セッション属性]**: 現在のコンタクトのセッションにのみ適用される [Amazon Lex セッション属性](connect-attrib-list.md#attribs-lex-table)を指定します。次の図は、最大通話時間が 8000 ミリ秒 (8 秒) に設定されたセッション属性を示しています。
![\[[顧客の入力の取得] ブロックの [プロパティ] ページ、[セッション属性] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-customer-input-properties3.png)
+ **インテント**
+ **[インテントを追加]**: このオプションを選択し、比較対象とする Amazon Lex ボットのインテントの名前を入力します。
インテントを追加する方法はいくつかあります。
+ インテントをテキストボックスに手動で入力します。
+ インテントを検索します。
+ ドロップダウンリストからインテントを選択します。
+ インテントのドロップダウンリストをロケールでフィルタリングします。選択したロケールに基づいて、ボットのインテントがドロップダウンリストに表示されます。
ドロップダウンリストから Lex ボットの ARN とエイリアスを選択すると、ロケールを使用して検索することで、そのボットのインテントを追加できます。インテントをリストに表示するには、ボットに Amazon Connect タグが付いていて、ボットエイリアスにバージョンが関連付けられている必要があります。
**[インテント]** ドロップダウンボックスには、Amazon Lex V1 ボットやクロスリージョンボットのインテントは表示されません。ボット ARN が動的に設定されている場合のインテントも表示されません。これらのインテントについては、次のオプションを使って検索してください。
+ **AmazonConnectEnabled** タグが true に設定されているかどうかを確認します。
1. Amazon Lex コンソールを開いて **[ボット]** を選択し、ボットを選択して、**[タグ]** を選択します。
1. **AmazonConnectEnabled** タグが存在しない場合は、**AmazonConnectEnabled = true** を追加します。
1. Amazon Connect 管理者ウェブサイトに戻ります。フローデザイナーを更新して、**[顧客の入力の取得]** ブロックの選択内容を確認します。
+ バージョンがエイリアスに関連付けられているかどうか確認します。
1. Amazon Connect 管理ウェブサイトで、**ルーティング**、**フロー**、ボット、**エイリアス**を選択します。次の図に示すように、**[フローとフローモジュールで使用]** が有効になっていることを確認します。
![\[[エイリアス] タブ、[フローとフローモジュールで使用] トグル。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/bot-alias-enabled.png)
1. フローデザイナーを更新して、**[顧客の入力の取得]** ブロックの選択内容を確認します。
+ **[Use sentiment override]** (感情の上書きを使用): Amazon Lex インテントの前に、感情スコアに基づいて分岐します。
感情スコアは、顧客の最後の発話に基づいています。会話全体に基づいているわけではありません。
例えば、希望する予約時間が空いていないため、否定的な感情を抱いた顧客から電話があったとします。この場合、否定的な感情スコアに基づいてフローを分岐できます (例: 否定的な感情が 80% を超える場合)。または、顧客から電話があった場合に、その顧客が 80% を超える肯定的な感情を抱いているときは、分岐してサービスでアップセルすることができます。
次の画像は、[Amazon Lex] タブの [インテント] セクションを示しています。否定的な感情スコアが 80% のときにコンタクトをルーティングするように設定されています。
![\[[顧客の入力の取得] ブロックの [プロパティ] ページ、[インテント] タブ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-customer-input-properties5.png)
否定的な感情スコアと肯定的な感情スコアの両方を追加すると、常に否定的なスコアが最初に評価されます。
感情スコア、代替インテント、および感情ラベルを問い合わせ属性とともに使用する方法については、「[コンタクト属性を確認する](check-contact-attributes.md)」を参照してください。
+ **メッセージでボットを初期化**
+ **目的**: 顧客の初期メッセージを渡すには、このオプションを選択します。または、カスタムメッセージを手動で入力するか動的に入力し、これを Lex ボットを初期化する初期メッセージとして使用して、顧客のチャットエクスペリエンスを向上させます。どちらのオプションもテキストのみをサポートしています。
[StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html) API の呼び出し中に、初期メッセージが新しく作成されたチャットに送信されます。
カスタムメッセージを設定するには、初期メッセージを手動で入力するか、属性を動的に渡します。
+ **お客様の最初のアトランスを使用 (テキストのみ)**: 常にボット初期化メッセージを ``$.Media.InitialMessage`` としてブロックをシリアル化します。
+ **手動で設定**: プレーンテキストメッセージまたは[属性の参照](connect-attrib-list.md)を受け入れます。最大 1,024 文字をサポートします。
+ **動的に設定**: テキスト値を持つ、選択された属性を受け入れます。最大 1,024 文字をサポートします。
+ **必須**: いいえ。これは必須パラメータではありません。
+ **ユースケース**:
+ ウェブチャット、SMS、WhatsApp、または Apple Messages for Business チャネルで **[お客様の最初のアトランスを使用 (テキストのみ)]** を使用して、Lex により、顧客の最初のチャットメッセージに対してインテントで応答します。
+ **[手動で設定]** を使用して、フローのユースケースに基づいて Lex インテントに静的にジャンプします。
このオプションを使用すると、顧客がチャットウィジェットを開いたときに、インタラクティブメッセージをプロアクティブに表示できます。
+ **[動的に設定]** を使用して、属性 (顧客プロファイル、コンタクトの詳細、ケース情報など) またはチャットウィジェットから渡された追加情報 (製品ページ、顧客のショッピングカートの詳細、[ユーザー定義属性](connect-attrib-list.md#user-defined-attributes)に割り当てられた顧客設定など) に基づいて Lex インテントに動的にジャンプします。
このオプションを使用すると、顧客がチャットウィジェットを開いたときに、インタラクティブメッセージをプロアクティブに表示できます。
**注記**
初期メッセージ属性がコンタクトの一部として含まれていない場合、コンタクトは **[エラー]** ブランチにルーティングされます。
ウェブチャット、SMS、Apple Messages for Business などの異なるメッセーングタイプごとに個別のフローを設定するには、**[顧客の入力の取得]** ブロックの前に、[[コンタクト属性を確認する]](check-contact-attributes.md) ブロックを使用して、初期メッセージが使用可能であることを確認します。
次の画像は、**[顧客の入力の取得]** ブロックを示しています。**[メッセージでボットを初期化]** と **[手動で設定]** が選択されています。
![\[[顧客の入力の取得] ブロックの [メッセージでボットを初期化] オプション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-customer-input-properties-initialize-bot-1.png)
#### 音声入力の設定可能なタイムアウト
音声の問い合わせのタイムアウト値を設定するには、Lex ボットを呼び出す [**顧客の入力を取得する**] ブロックで、次のセッション属性を使用します。これらの属性を使用すると、発信者からの音声入力 (はい/いいえの質問に対する回答、日付やクレジットカード番号の提供) を Amazon Lex で収集する前に顧客が発話を終了したと判断するまで待つ時間を指定できます。
------
#### [ Amazon Lex ]
+ **発話の最大時間**
`x-amz-lex:audio:max-length-ms:[intentName]:[slotToElicit]`
入力を打ち切って Amazon Connect に戻るという判断をするまでの顧客の発話時間の長さ。多くの入力が予想される場合や、顧客が情報を提供するまでの時間を増やす場合は、この時間を延長できます。
デフォルト = 12,000 ミリ秒 (12 秒)。最大許容値は 15000 ミリ秒です。
**重要**
**[発話の最大時間]** を 15000 ミリ秒より長くすると、コンタクトは **[エラー]** ブランチにルーティングされます。
+ **無音開始しきい値**
`x-amz-lex:audio:start-timeout-ms:[intentName]:[slotToElicit]`
顧客は話さないと見なすまでに待つ時間。顧客のために、情報を探したり思い出したりする時間を確保する場合には、発話前として割り当てられた時間を延長することが可能です。例えば、顧客がクレジットカードを取り出してその番号を入力できるまでの時間をより長く見込む場合は、時間を延長できます。
デフォルト = 3,000 ミリ秒 (3 秒)。
+ **無音終了しきい値**
`x-amz-lex:audio:end-timeout-ms:[intentName]:[slotToElicit] `
顧客が発話を停止してから発話が完了したと見なすまでに待つ時間。入力している間の無音の時間を見込む場合は、割り当てられた時間を延長できます。
デフォルト = 600 ミリ秒 (0.6 秒)
------
#### [ Amazon Lex (Classic) ]
+ **発話の最大時間**
`x-amz-lex:max-speech-duration-ms:[intentName]:[slotToElicit]`
入力を打ち切って Amazon Connect に戻るという判断をするまでの顧客の発話時間の長さ。多くの入力が予想される場合や、顧客が情報を提供するまでの時間を増やす場合は、この時間を延長できます。
デフォルト = 12,000 ミリ秒 (12 秒)。最大許容値は 15000 ミリ秒です。
**重要**
**[発話の最大時間]** を 15000 ミリ秒より長くすると、コンタクトは **[エラー]** ブランチにルーティングされます。
+ **無音開始しきい値**
`x-amz-lex:start-silence-threshold-ms:[intentName]:[slotToElicit]`
顧客は話さないと見なすまでに待つ時間。顧客のために、情報を探したり思い出したりする時間を確保する場合には、発話前として割り当てられた時間を延長することが可能です。例えば、顧客がクレジットカードを取り出してその番号を入力できるまでの時間をより長く見込む場合は、時間を延長できます。
デフォルト = 3,000 ミリ秒 (3 秒)。
+ **無音終了しきい値**
`x-amz-lex:end-silence-threshold-ms:[intentName]:[slotToElicit]`
顧客が発話を停止してから発話が完了したと見なすまでに待つ時間。入力している間の無音の時間を見込む場合は、割り当てられた時間を延長できます。
デフォルト = 600 ミリ秒 (0.6 秒)
------
#### Lex 音声対話中のチャット入力のタイムアウトを設定可能
**[Intents]** (インテント) の下の **[Chat timeout]** (チャットタイムアウト) フィールドを使用して、チャット入力のタイムアウトを設定します。Lex 音声対話で非アクティブな顧客がタイムアウトするまでの時間を入力します。
+ 最小: 1 分
+ 最大 7 日
次の画像は、顧客が 2 分間非アクティブになるとチャットをタイムアウトするように設定された **[顧客の入力の取得]** ブロックを示しています。
![\[[プロパティ] ページの [インテント] セクション、[チャットのタイムアウト] オプション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-customer-input-chattimeout.png)
すべての参加者が人間である場合のチャットタイムアウトの設定については、「[チャット参加者のチャットタイムアウトを設定する](setup-chat-timeouts.md)」を参照してください。
#### Amazon Lex への割り込みの設定と使用
説明が終わるのを待つことなく、顧客が自分の声を使って Amazon Lex ボットを文の途中で中断できるようにすることができます。例えば、オプションのメニューからの選択に慣れている顧客は、プロンプト全体を聞かなくてもすぐに選択できるようになっています。
------
#### [ Amazon Lex ]
+ **割り込み**
割り込みは、デフォルトではグローバルで有効になっています。Amazon Lex コンソールで無効にすることができます。詳細については、「[Enabling your bot to be interrupted by your user](https://docs.aws.amazon.com/lexv2/latest/dg/interrupt-bot.html)」を参照してください。さらに、`allow-interrupt` セッション属性を使用して割り込みの動作を変更できます。例えば、`x-amz-lex:allow-interrupt:*:*` は、すべてのインテントとすべてのスロットについて割り込みを許可します。詳細については、「*Amazon Lex V2 開発者ガイド*」の「[ユーザー入力をキャプチャするためのタイムアウトの設定](https://docs.aws.amazon.com/lexv2/latest/dg/session-attribs-speech.html)」を参照してください。
------
#### [ Amazon Lex (Classic) ]
+ **割り込み**
`x-amz-lex:barge-in-enabled:[intentName]:[slotToElicit]`
割り込みは、デフォルトではグローバルで無効になっています。グローバル、ボット、またはスロットのレベルで Lex ボットを有効にするには、 Lex ボットを呼び出している [**顧客入力の取得**] ブロックでセッション属性を設定する必要があります。この属性は Amazon Lex 割り込みのみを制御し、DTMF 割り込みは制御しません。詳細については、「[フローブロックが Amazon Lex セッション属性を使用する方法](how-to-use-session-attributes.md)」を参照してください。
次の画像は、割り込みが有効な **[セッション属性]** セクションを示しています。
![\[[プロパティ] ページの [セッション属性] セクション、[値] が [true] に設定されています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/barge-in-session-attribute.png)
------
#### DTMF 入力の設定可能なフィールド
次のセッション属性を使用して、Lex ボットが DTMF 入力に応答する方法を指定します。
+ **終了文字**
`x-amz-lex:dtmf:end-character:[IntentName]:[SlotName]`
発話を終了する DTMF 終了文字。
デフォルト = \$1
+ **削除文字**
`x-amz-lex:dtmf:deletion-character:[IntentName]:[SlotName]`
それまでに入力された DTMF ディジットをクリアして発声を終了する DTMF 文字。
デフォルト = \$1
+ **終了タイムアウト**
`x-amz-lex:dtmf:end-timeout-ms:[IntentName]:[SlotName]`
発話が終了したと見なすための DTMF ディジットの間のアイドル時間 (ミリ秒単位)。
デフォルト = 5000 ミリ秒 (5 秒)。
+ **発話あたりの許可される DTMF ディジットの最大数**
`x-amz-lex:dtmf:max-length:[IntentName]:[SlotName]`
特定の発話で許可される DTMF ディジットの最大数。増やすことはできません。
デフォルト = 1024 文字
詳細については、「[フローブロックが Amazon Lex セッション属性を使用する方法](how-to-use-session-attributes.md)」を参照してください。
#### Amazon Lex を使用する場合の Flow 言語表現
次のコード例は、Amazon Lex の設定が、Flow 言語の [ConnectParticipantWithLexBot](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-connectparticipantwithlexbot.html) アクションではどのように表現されるかを示しています。
```
{
"Parameters": {
"Text": "Welcome to Example Corp. Please press 1 for sales, press 2 for support",
"LexV2Bot": {
"AliasArn": "arn:aws:lex:us-west-2:23XXXXXXXXXX:bot-alias/3HL7SXXXXX/TSTALXXXXX"
},
"LexTimeoutSeconds": {
"Text": "300"
}
},
"Identifier": "Get Customer Input",
"Type": "ConnectParticipantWithLexBot",
"Transitions": {
"NextAction": "d8701db7-3d31-4581-bd4c-cb49c38c6f43",
"Errors": [
{
"NextAction": "d8701db7-3d31-4581-bd4c-cb49c38c6f43",
"ErrorType": "InputTimeLimitExceeded"
},
{
"NextAction": "d8701db7-3d31-4581-bd4c-cb49c38c6f43",
"ErrorType": "NoMatchingError"
},
{
"NextAction": "Get Customer Input-ygqIfPM1n2",
"ErrorType": "NoMatchingCondition"
}
]
}
}
```
#### フラグメント化されたアクションの表現
次のコード例は、会話の後で Lex ボットから返された Amazon Lex 感情スコアに対する、フラグメント化された [Compare](https://docs.aws.amazon.com/connect/latest/APIReference/flow-control-actions-compare.html) アクションを示しています。
```
{
"Parameters": {
"ComparisonValue": "$.Lex.SentimentResponse.Scores.Negative"
},
"Identifier": "Get Customer Input-ygqIfPM1n2",
"Type": "Compare",
"Transitions": {
"NextAction": "Get Customer Input-xDRo1hbBRB",
"Conditions": [
{
"NextAction": "d8701db7-3d31-4581-bd4c-cb49c38c6f43",
"Condition": {
"Operator": "NumberGreaterOrEqualTo",
"Operands": [
"0.08"
]
}
}
],
"Errors": [
{
"NextAction": "Get Customer Input-xDRo1hbBRB",
"ErrorType": "NoMatchingCondition"
}
]
}
}
```
### フローブロックのブランチ
次の図は、このブロックが DTMF 入力用に設定されている場合の表示例です。入力の 2 つのブランチとして **[Pressed 1]** と **[Pressed 2]** が表示されています。また、**[タイムアウト]**、**[デフォルト]**、および **[エラー]** のブランチも示しています。
![\[設定された [顧客の入力の取得] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-customer-input-branches.png)
1. **[タイムアウト]**: Amazon Lex で指定されたチャットタイムアウト、または DTMF 用に **[タイムアウトの設定]** で指定した時間が経過しても、お客様から何も入力がない場合の対応。
1. **[デフォルト]**: お客様の入力が DTMF のどの条件にも一致しない場合、または Amazon Lex ボットでインテントが実行された場合。上の図のように、1 または 2 以外の値を入力した場合、コンタクトは **[デフォルト]** ブランチにルーティングされます。
1. **[エラー]**: ブロックを実行したが、DTMF でエラーが発生した場合、または Amazon Lex ボットのインテントに基づいた処理ができない場合。
### 追加の設定のヒント
+ Amazon Connect ライブラリまたは S3 バケットからのプロンプトの選択については、[プロンプトの再生](play.md) ブロックを参照してください。
+ このブロックは、DTMF 入力またはチャット応答を受け入れるように設定できます。Amazon Lex と連携するように設定することもでき、例えば、コンタクトを発話に基づいてルーティングできます。
+ Amazon Lex との統合に使用できるセッション属性。このトピックでは、Amazon Lex との統合に使用できるセッション属性の一部について説明します。使用可能なすべての Amazon Lex セッション属性のリストについては、「[ユーザー入力をキャプチャするためのタイムアウトの設定](https://docs.aws.amazon.com/lexv2/latest/dg/session-attribs-speech)」を参照してください。(テキスト読み上げまたはチャットに) テキストを使用する場合は、最大 3,000 の課金対象文字 (合計 6,000 文字) を使用できます。
+ Amazon Lex ボットは、フローで使用すると、発声とキーパッド入力の両方をサポートします。
+ 音声と DTMF の両方で、会話ごとに 1 つのセッション属性のセットしか存在できません。優先順位は次のとおりです。
1. Lambda が提供するセッション属性: 顧客の Lambda 呼び出し中はセッション属性よりも優先されます。
1. Amazon Connect コンソールが提供するセッション属性: [**顧客入力の取得**] ブロックで定義されます。
1. サービスのデフォルト: 属性が定義されていない場合にのみ使用されます。
+ 入力をシャープ記号 \$1 で終了し、星の記号 \$1 を使用してキャンセルするよう問い合わせに求めることができます。Lex ボットの使用時に顧客に \$1 で入力を終了するよう求めないと、さらにキーが押されるのを待機するのを Lex が停止するまで顧客は 5 秒待つことになります。
+ タイムアウト機能を制御するには、Lex セッション属性をこのブロックで使用するか、Lex Lambda 関数で設定します。Lex Lambda 関数で属性を設定する場合は、Lex ボットが呼び出されるまでデフォルト値が使用されます。詳細については、[Amazon Lex デベロッパーガイド](https://docs.aws.amazon.com/lex/latest/dg/using-lambda.html)の「*Using Lambda Functions*」を参照してください。
+ この記事で説明しているセッション属性のいずれかを指定する場合は、ワイルドカードを使用できます。ワイルドカードを使用すると、インテントまたはボットに複数のスロットを設定できます。
ワイルドカードの使用例をいくつか以下に示します。
+ 特定のインテント (PasswordReset など) のすべてのスロットを 2000 ミリ秒に設定する例は、次のとおりです。
名前 = `x-amz-lex:max-speech-duration-ms:PasswordReset:*`
値 = 2000
+ すべてのボットのすべてのスロットを 4000ミリ秒に設定する例は、次のとおりです。
名前 = `x-amz-lex:max-speech-duration-ms:*:*`
値 = 4000
ワイルドカードは、フローのボット全体に適用されますが、ブロック全体には適用されません。
例えば、Get\$1Account\$1Number ボットがあるとします。フローには、2 つの **[Get customer input]** (顧客の入力を取得する) ブロックがあります。最初のブロックでは、ワイルドカードを使用してセッション属性を設定します。2番目のブロックでは、属性を設定しません。このシナリオでは、ボットの動作の変更は、セッション属性が設定されている最初の [**顧客の入力を取得する**] ブロックにのみ適用されます。
+ セッション属性をインテントレベルとスロットレベルに適用するように指定できるため、特定のタイプの入力を収集するときにのみ属性を設定するように指定できます。例えば、アカウント番号を収集する場合は、日付を収集する場合よりも長い [**無音開始しきい値**] を指定できます。
+ Amazon Connect を使用して Lex ボットに DTMF 入力が送信された場合、顧客入力は [[Lex リクエスト属性](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt-request-attribs.html)] として利用可能になります。属性名は `x-amz-lex:dtmf-transcript` で、この値は最大 1024 文字です。
さまざまな DTMF 入力シナリオを以下に示します。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/get-customer-input.html)
コードの説明は以下のとおりです。
+ [DEL] = 削除文字 (デフォルトは **\$1**)
+ [END] = 終了文字 (デフォルトは **\$1**)
### このブロックで生成されるデータ
このブロックではデータは生成されません。
## エラーシナリオ
次のシナリオを検討してみましょう。フローが 2 つあり、それぞれがお客様からの DTMF 入力を取得します。
1. 1 つのコンタクトフローでは **[顧客の入力の取得]** ブロックを使用して、顧客から DTMF 入力を要求します。
1. DTMF 入力があると、その入力が **[フローへの転送]** ブロックを使用して、コンタクトを次のフローに移動します。
1. 次のコンタクトフローでは、**[顧客の入力を保存する]** ブロックを使用して、顧客からより多くの DTMF 入力を取得します。
最初のフローと 2 番目のフローの間には設定時間があります。このため、顧客が 2 番目のフローに対して非常に速く DTMF 入力を入力すると、一部の DTMF の桁が削除される可能性があります。
例えば、顧客は 5 を押し、2 番目のフローからのプロンプトを待ってから「123」と入力する必要があります。この場合、123 は問題なくキャプチャされます。しかし、プロンプトを待たずに非常に速く「5123」と入力すると、[顧客の入力を保存する] ブロックは 23 または 3 しかキャプチャできない可能性があります。
2 番目のフローの **[顧客の入力を保存する]** ブロックですべての桁が確実に取得されるようにするには、お客様がプロンプトの再生を待ってから DTMF 入力を行う必要があります。
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
+ [Amazon Connect に含まれる最初のコンタクトエクスペリエンスの着信フローのサンプル](sample-inbound-flow.md)
+ [Amazon Connect のコールバックでの割り込み可能キューフローのサンプル](sample-interruptible-queue.md)
+ [Amazon Connect のキュー設定フローのサンプル](sample-queue-configurations.md)
+ [Amazon Connect での記録動作のサンプル](sample-recording-behavior.md)
## その他のリソース
Amazon Lex の詳細とプロンプトの追加については、以下のトピックを参照してください。
+ [Amazon Connect で会話型 AI ボットを作成する](connect-conversational-ai-bots.md)
+ [音声とチャットに同じ Amazon Lex ボットを使用する方法](one-bot-voice-chat.md)
+ [Amazon Polly でフローブロックのプロンプトにテキスト読み上げを追加する](text-to-speech.md)
# Amazon Connect のフローブロック: メトリクスの取得
デフォルトでは、このブロックは現在のキューのキューメトリクスを返します。オプションで、別のキュー/チャネルの組み合わせのメトリクスを返すか、キュー内の問い合わせの位置などの問い合わせレベルのメトリクスを返すかを選択できます。メトリクスは、JSONPath または問い合わせ属性の確認ブロックを介して参照できる属性として返されます。
## 説明
+ 5～10 秒の遅延でほぼリアルタイムでキューメトリクスを取得して、より詳細なルーティングを決定します。
+ キュー内の問い合わせや稼動可能なエージェントの数など、キューまたはエージェントのステータスに基づいてコンタクトをルーティングできます。
+ キューメトリクスは、デフォルトですべてのチャネルにわたり集約され、属性として返されます。
+ デフォルトでは、現在のキューが使用されます。
+ エージェントベースのメトリクス (オンラインのエージェント、稼働可能なエージェント、配置されたエージェントなど) については、エージェントがいない場合にはメトリクスは返されません。
+ キューの推定待機時間の場合、メトリクスは 1 つのチャネルが指定されている場合にのみ返されます。
+ 取得できるメトリクスは次のとおりです。
+ キュー名
+ キュー ARN
+ [キュー内の問い合わせ](metrics-definitions.md#contacts-in-queue)
+ [キューの最も古い問い合わせ](metrics-definitions.md#oldest-real-time)
+ [オンラインエージェント](metrics-definitions.md#online-agents)
+ [使用可能なエージェント](metrics-definitions.md#available-real-time)
+ [対応エージェント](metrics-definitions.md#staffed-agents)
+ [アフターコンタクトワーク中のエージェント](metrics-definitions.md#agent-after-contact-work)
+ [ビジー状態のエージェント](metrics-definitions.md#agents-on-contact)
+ [エージェント不在](metrics-definitions.md#agent-non-response) (エージェント応答なし)
+ [非生産的なエージェント](metrics-definitions.md#agent-non-productive)
+ [キューの推定待機時間](metrics-definitions.md#estimated-wait-time)
+ [問い合わせの推定待機時間](metrics-definitions.md#estimated-wait-time)
+ [キュー内の問い合わせ位置](metrics-definitions.md#position-in-queue)
+ 音声やチャットなどのチャネル別にメトリクスを返すように指定できます。キュー別やエージェント別にフィルターすることもできます。これらのオプションを使用すると、キュー内のチャットや音声の問い合わせ数、これらの問い合わせに対応可能なエージェントがいるかどうかを確認できます。
+ キュー内の問い合わせや利用可能なエージェントの数など、キューのステータスに基づいて問い合わせをルーティングできます。キューメトリクスは、すべてのチャネルで集約され、属性として返されます。デフォルトでは、現在のキューが使用されます。
+ **メトリクスの取得**ブロックの後、 [コンタクト属性を確認する](check-contact-attributes.md) を使用してメトリクス値を確認し、それらに基づいてルーティングロジックを定義します。たとえば、キュー内の問い合わせの数、使用可能なエージェントの数、キュー内の最も古い問い合わせの数などです。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ すべてのフロー
## プロパティ
次の図は、**メトリクスの取得**ブロックの**プロパティ**ページを示しています。**[音声]** チャネルのメトリクスを取得するように設定されています。
![\[メトリクスの取得ブロックのプロパティページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-metrics-properties1.png)
メトリクスをチャネル別、キュー別、エージェント別に取得できます。
+ チャネルを指定しないと、すべてのチャネルのメトリクスが返されます。
+ キューを指定しないと、現在のキューのメトリクスが返されます。
+ 動的属性は、1 つのチャネルのメトリクスのみを返すことができます。
例えば、次の画像は、**[チャット]** チャネルと **[BasicQueue]** について設定された **[プロパティ]** ページを示しています。これらの設定を選択した場合、**[キューメトリクスの取得]** は、チャットコンタクトのみを含むようにフィルターされた BasicQueue のメトリクスを返します。
![\[[プロパティ] ページの [オプションパラメータ] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-metrics-properties3.png)
## 設定のヒント
### [問い合わせ属性の設定] ブロックでのチャネルの指定
動的属性は、1 つのチャネルのメトリクスのみを返すことができます。
**メトリクスの取得**ブロックで動的属性を使用する前に、[コンタクト属性の設定](set-contact-attributes.md)ブロックで属性を設定し、どのチャネルを指定する必要があります。
次の図に示すように、テキストを使用してチャネルを動的に設定する場合は、属性値として「**Voice**」または「**Chat**」と入力します (この値は大文字と小文字が区別されません)。
![\[[コンタクト属性の設定] ブロックの [プロパティ] ページ、[値] が [チャット] に設定されています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-metrics-properties2.png)
### メトリクスの取得ブロックの後に問い合わせ属性の確認ブロックを使用する
**メトリクスの取得**ブロックの後に、返されたメトリクスに基づいてブランチに[コンタクト属性を確認する](check-contact-attributes.md)ブロックを追加します。以下のステップを使用します。
1. **メトリクスを取得**したら、**問い合わせ属性の確認**ブロックを追加します。
1. [**問い合わせ属性を確認する**] ブロックで、[**確認する属性**] を [**キューメトリクス**] に設定します。
1. **値**ドロップダウンボックスには、メトリクスの取得ブロックでチェックできる**メトリクス**のリストが表示されます。ルーティングの決定に使用するメトリクスを選択します。
![\[[確認する属性] セクション、使用可能なメトリクスのドロップダウンリスト。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-metrics-block-returned-metrics.png)
### Get metrics ブロックがエラーをスローする理由
**メトリクスの取得**ブロックは、次のシナリオでエラーをスローします。
1. フローにこのブロックを追加する。
1. リアルタイムのメトリクスレポートで、アクティビティが行われていないため、空のメトリクスが返される。
1. 表示する**メトリクスがないため、メトリクスの取得**ブロックはエラーをスローします。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** の 2 つのブランチがあります。
![\[設定されたメトリクスの取得ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/get-metrics-configured.png)
## シナリオ
このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [Amazon Connect で問い合わせ属性を参照する方法](how-to-reference-attributes.md)
# Amazon Connect のフローブロック: 保存されたコンテンツを取得する
このトピックでは、フロー内で使用される保存済みコンテンツを取得するためのフローブロックを指定します。
## 説明
このブロックを使用して、フローで分岐決定を行う必要がある場合に、S3 バケットから保存されたデータを取得します。例えば、このブロックを使用して、Amazon S3 バケットに保存されている E メールメッセージ本文にアクセスできます。このフローブロックでは、現在次のオプションを使用できます。
E メールメッセージ (プレーンテキスト)
このブロックは、S3 バケットに存在する E メールメッセージのプレーンテキストバージョンをダウンロードし、`$.Email.EmailMessage.Plaintext`フロー属性に保存します。E メールメッセージのコンテンツはプレーンテキストファイルとしてダウンロードされ、フロー属性の最大サイズ制限により、現在サポートされている最大サイズは 32 KB です。このオプションを使用する[Amazon Connect インスタンスの E メールを有効にする](enable-email1.md)前に、必ず を確認してください。
## このブロックのユースケース
このフローブロックは、次のシナリオで使用するように設計されています。
+ これを使用して、[問い合わせ属性](check-contact-attributes.md)と[メッセージを送信](send-message.md)フローブロックをチェックし、自動 E メールレスポンスとルーティングを設定します。
+ [問い合わせ属性の確認](check-contact-attributes.md)ブロックで、名前空間に E **メール**を選択し、**キー**に E **メールメッセージ**を選択します。次に、ユースケースに応じて条件を追加します。たとえば、E メールメッセージに「Refund」という単語が含まれている場合に、特定のキューにルーティングする場合 (**注意**: キーワードでは大文字と小文字が区別されます）。
+ [メッセージを送信](send-message.md) ブロックで、E メールテンプレートを選択するか、メッセージを入力して自動応答を送信します。
### CheckContactAttributes のプロパティ設定
[コンタクト属性を確認する](check-contact-attributes.md) ブロックで、名前空間に E **メール**を選択し、**キー**に E **メールメッセージ**を選択します。次に、ユースケースに応じて条件を追加します。
## コンタクトのタイプ
次の表は、このブロックでのコンタクトのルーティング方法をチャネルごとに示しています。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | いいえ |
| Chat | いいえ |
| タスク | いいえ |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer queue flow (顧客キューフロー)]
+ 顧客保留フロー
+ 顧客ウィスパーフロー
+ アウトバウンドウィスパーフロー
+ エージェント保留フロー
+ エージェントウィスパーフロー
+ エージェントへの転送フロー
+ キューへの転送フロー
+ 切断フロー
## このブロックの設定方法
Amazon Connect 管理ウェブサイトを使用するか、Amazon Amazon Connect Flow 言語`LoadContactContent`の を使用して、保存**済みコンテンツの取得**ブロックを設定できます。
## フロー言語表現
次のコード例は、Amazon Connect フロー言語で `LoadContactContent` を使用する方法を示しています。
```
{
"Parameters": {
"ContentType": enum "EmailMessage"
},
"Identifier": "string",
"Type": "LoadContactContent",
"Transitions": {
"NextAction": "string",
"Errors": [
{
"NextAction": "string",
"ErrorType": "NoMatchingError"
}
]
}
}
```
## エラーシナリオ
フローサービスが次のいずれかのエラーシナリオに該当する場合、問い合わせはエラーブランチにルーティングされます。
+ E メールメッセージ (プレーンテキスト) を使用する場合:
+ プレーンテキスト形式の E メールメッセージのサイズが 32KB を超える場合。
+ Amazon Connect は S3 バケットから E メール本文をダウンロードできません。これは、S3 バケットポリシーが正しく設定されていない ([「ステップ 4: E メールを有効にして Amazon S3 バケットを作成する](enable-email1.md#enable-email-buckets)」を参照）、Amazon Connect が S3 バケットに適切にアクセスできない ([ステップ 5: CORS ポリシーを設定する](enable-email1.md#config-email-attachments-cors1)」を参照）、または連絡先にプレーンテキスト形式の E メールメッセージがないことが原因である可能性があります。
# Amazon Connect のフローブロック: 顧客またはエージェントの保留
このトピックでは、顧客またはエージェントを保留にし、後で通話を再開するためのフローブロックを定義します。
**重要**
ビデオ通話または画面共有セッション中、エージェントは顧客が保留中であっても、顧客のビデオまたは画面共有を表示できます。それに応じて PII に対処するのは顧客の責任です。この動作を変更する場合は、カスタム CCP とコミュニケーションウィジェットを構築します。詳細については、「[アプリ内通話、ウェブ通話、ビデオ通話、および画面共有をアプリケーションにネイティブに統合する](config-com-widget2.md)」を参照してください。
## 説明
+ 顧客またはエージェントとの通話を保留または保留解除します。これは、例えば、顧客がクレジットカード情報を入力している間にエージェントを保留にする場合に便利です。
+ このブロックがチャット会話中にトリガーされた場合、コンタクトは **[エラー]** ブランチにルーティングされます。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | いいえ - エラーブランチ |
| タスク | いいえ - [エラー] ブランチ |
| E メール | いいえ - [エラー] ブランチ |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ アウトバウンドウィスパーフロー
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
次の画像は、**[顧客またはエージェントの保留]** ブロックの **[プロパティ]** ページを示しています。ドロップダウンリストには、**[エージェント保留中]**、**[顧客保留中]**、**[すべてカンファレンス]** の 3 つのオプションがあることを示しています。
![\[[顧客またはエージェントの保留] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/hold-customer-or-agent-properties.png)
これらのオプションは次のように定義されます。
+ [**Agent on hold (エージェントが保留中)**] = 顧客が通話中
+ [**Conference all (電話会議)**] = エージェントと顧客が通話中
+ [**Customer on hold (顧客が保留中)**] = エージェントが通話中
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[エージェント保留中]** について設定され、**[成功]** と **[エラー]** の 2 つのブランチがあります。
![\[設定された [顧客またはエージェントの保留] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/hold-customer-or-agent-configured.png)
## サンプルフロー
[コンタクトセンターエージェントとの通話でのセキュアな顧客データ入力のサンプル](sample-secure-input-with-agent.md)
# Amazon Connect: AWS Lambda function のフローブロック
このトピックでは、 を呼び出すためのフローブロックを定義します AWS Lambda。取得したレスポンスは、[[コンタクト属性の設定](set-contact-attributes.md)] ブロックで使用できます。
## 説明
+ 呼び出し AWS Lambda。
+ 返されたデータを使用して、[[コンタクト属性の設定](set-contact-attributes.md)] ブロックでコンタクト属性を設定できます。
+ 例については、[チュートリアル: Lambda 関数を作成してフローで呼び出す](connect-lambda-functions.md#tutorial-invokelambda)を参照してください。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer Queue flow (顧客キューフロー)]
+ [Customer Hold flow (顧客の保留フロー)]
+ [Customer Whisper flow (顧客ウィスパーフロー)]
+ エージェント保留フロー
+ エージェントウィスパーフロー
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
次の画像は、**[AWS Lambda 関数]** ブロックの **[プロパティ]** ページを示しています。
![\[AWS Lambda 関数ブロックのプロパティページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/aws-lamdba-function-properties.png)
**[アクションを選択]** ボックスで、以下のオプションから選択します。
+ [Lambda を呼び出す](#properties-invoke-lamdba)
+ [Lambda 結果をロード](#properties-load-lamdba) (非同期的に実行する場合)
### Lambda を呼び出す
![\[[アクションを選択] ボックスで設定された [Lambda を呼び出す] と、[実行モード] のオプション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/invoke-lambda-properties2.png)
**[アクションを選択]** を **[Lambda を呼び出す]** に設定する場合は、以下のプロパティに注意してください。
+ **実行モード**:
+ **同期**: [同期] を選択すると、Lambda 呼び出しが完了した後にのみ、コンタクトは次のブロックにルーティングされます。
+ **非同期**: Lambda が完了するのを待たずに、コンタクトは次のブロックにルーティングされます。
非同期実行モードを使用して呼び出される Lambda を待機するように [[待機](wait.md)] ブロックを設定できます。
+ **タイムアウト**: Lambda がタイムアウトするまでの待機時間を入力します。**[同期モード]** では最大 8 秒、**[非同期モード]** では最大 60 秒を入力できます。
Lambda 呼び出しが調整されると、リクエストが再試行されます。一般的なサービス障害 (500 エラー) が発生した場合も再試行されます。
Lambda の呼び出しがエラーを返した場合、Amazon Connect は指定したタイムアウトまでの間に最大 3 回再試行します。その時点で、問い合わせは [**Error (エラー)**] ブランチにルーティングされます。
+ **レスポンスの検証**: Lambda 関数のレスポンスは、STRING\$1MAP または JSON のいずれかです。フローで **[AWS Lambda 関数]** ブロックを設定するときに、これを設定する必要があります。
+ レスポンスの検証を STRING\$1MAP に設定すると、Lambda 関数は文字列型のキーバリューペアのフラットオブジェクトを返します。
+ レスポンスの検証を JSON に設定すると、Lambda 関数は、ネストされた JSON を含む任意の有効な JSON を返します。
### Lambda 結果をロード
![\[Config タブの Lambda AWS Lambda 結果のロードアクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/load-lambda-result.png)
**[アクションを選択]** を **[Lambda 結果をロード]** に設定する場合は、以下のプロパティに注意してください。
+ **Lambda 呼び出し RequestId**: これは、**[非同期モード]** で実行する場合の Lambda の requestId です。
`$.LambdaInvocation.InvocationId` は、非同期に実行された直近の Lambda の requestId を示します。
**[Lambda 結果をロード]** アクションを選択する場合は、**[Lambda 呼び出し RequestId]** で以下のオプションを選択します。
+ **名前空間** = **Lambda 呼び出し**
+ **キー** = **呼び出し ID**
## 設定のヒント
+ フローで AWS Lambda 関数を使用するには、まず関数をインスタンスに追加します。詳細については、「[Amazon Connect インスタンスに Lambda 関数を追加する](connect-lambda-functions.md#add-lambda-function)」を参照してください。
+ 関数をインスタンスに追加したら、ブロックの **[Select a function]** (関数の選択) ドロップダウンリストから関数を選択し、フローで使用することができます。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** の 2 つのブランチがあります。ブロックは、**[非同期]** 実行モードに設定されています。**[同期]** 実行モードに設定すると、**[タイムアウト]** ブランチが表示されます。
![\[設定された AWS Lambda 関数ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/invoke-lambda-configured.png)
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
[Amazon Connect での Lambda 統合フローのサンプル](sample-lambda-integration.md)
## シナリオ
このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [AWS Lambda 関数へのアクセスを Amazon Connect に許可する](connect-lambda-functions.md)
# Amazon Connect のフローブロック: 公開されたモジュールを呼び出す
このトピックでは、公開されたモジュールを呼び出してフローに再利用可能なセクションを作成するためのフローブロックを定義します。
## 説明
公開されたモジュールを呼び出します。これにより、問い合わせフローの再利用可能なセクションを作成できます。
詳細については、「[Amazon Connect の再利用可能な機能のためのフローモジュール](contact-flow-modules.md)」を参照してください。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
## プロパティ
次の画像は、**[呼び出しモジュール]** ブロックの **[プロパティ]** ページを示しています。
![\[[呼び出しモジュール] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/invoke-module-properties.png)
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** の 2 つのブランチがあります。
![\[設定された [呼び出しモジュール] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/invoke-module-configured.png)
# Amazon Connect のフローブロック: ループ
このトピックでは、**[ループ]** ブランチで顧客がループされた回数をカウントするためのフローブロックを定義します。
## 説明
+ ループブランチを介して、設定された番号の同じブロックを**ループ**します。
+ ループが完了すると、**Complete** ブランチが続きます。
+ 指定された入力が正しくない場合、**エラー**ブランチに従います。
+ このブロックは、多くの場合、[**Get customer input (顧客入力の取得)**] ブロックで使用されます。例えば、顧客がアカウント番号の入力に成功しなかった場合、ループして別のアカウントを入力する機会を与えることができます。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ すべてのフロー
## プロパティ
次の画像は、**[ループ]** ブロックの **[プロパティ]** ページを示しています。3 回繰り返した後、分岐するように設定されています。
![\[[ループ] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set number of loops.png)
**アクションの選択ドロップダウンで**、次のオプションから選択します。
+ ループ数の設定
+ ループする配列を設定する
## ループ数の設定
![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set number of loops highlight.png)
選択アクションが「ループ数の設定」に設定されている場合、次のプロパティに注意してください。
+ ループブロックは指定された数だけループオーバーします
+ 指定された入力が有効な数値でない場合、エラーブランチが取得されます。
+ ループ名を指定すると、\$1.Loop. から現在のインデックスにアクセスできます。インデックス、0 から開始
## ループする配列を設定する
![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set array for looping.png)
選択アクションが「ループする配列を設定する」に設定されている場合、次のプロパティに注意してください。
+ ループブロック内の各要素をループスルーする配列またはリストを指定できます。
+ ブロックは入力内の要素の数をループします
+ 配列をループオーバーするにはループ名が必要です
+ ループ名を使用して以下にアクセスできます。
+ \$1.Loop.。インデックス - 現在のインデックス、0 から開始
+ \$1.Loop.。要素 - 現在のループ要素
+ \$1.Loop.。要素 - 提供された入力配列
+ 無効な配列が指定されている場合、エラーブランチが取得されます
## 設定のヒント
+ ループ数に 「0」 を入力した場合、このブロックが最初に実行されたときに、[**完全**] なブランチをたどります。
+ ループ名を指定する場合、ループ名は一意である必要があります。つまり、同じループ名で他のループをアクティブにすることはできません。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。これには**、ループ**、**完了**、**エラー**の 3 つのブランチがあります。
![\[設定された [ループ] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/new loop block.png)
# Amazon Connect のフローブロック: プロンプトのループ
このトピックでは、顧客またはエージェントが保留状態またはキューにいる間に一連のプロンプトをループするためのフローブロックを定義します。
## 説明
+ 顧客またはエージェントが保留状態またはキュー内に保存されている場合、プロンプトの順序をループする
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | いいえ - エラーブランチ |
| タスク | いいえ - [エラー] ブランチ |
| E メール | いいえ - [エラー] ブランチ |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 顧客キューフロー
+ [Customer Hold flow (顧客保留フロー)]
+ エージェント保留フロー
## プロパティ
次の画像は、**[プロンプトのループ]** ブロックの **[プロパティ]** ページを示しています。ドロップダウンリストから選択できるプロンプトのタイプとして、**[音声記録]**、**[テキスト読み上げ]**、**[S3 ファイルパス]** の 3 つがあることを示しています。
![\[[プロンプトのループ] ブロックの [プロパティ] ページ、プロンプトタイプのドロップダウンリスト。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/loop-prompts-properties.png)
### 割り込みオプションの仕組み
複数のプロンプトがある場合に、[**中断**] を 60 秒に設定したとします。以下に、何が起こるかを示します。
+ ブロックは、リストされている順序でプロンプトをすべて再生します。
+ プロンプトの合計再生時間が 75 秒の場合、60 秒後にプロンプトは中断され、0 秒ポイントにリセットされます。
+ 60 秒後に再生されるはずの重要かもしれない情報を、顧客が聞けない可能性があります。
このシナリオは、Amazon Connect が提供するデフォルトのオーディオプロンプトを使用する場合に特に起こり得ます。これは、これらのオーディオプロンプトが最大 4 分になり得るためです。
## 割り込みオプションの仕組み
[プロンプトをループ] ブロックでは、**[割り込み中もプロンプトを続行]** オプションを有効にすることができます。
![\[[プロンプトをループ] の [割り込み] オプションウィジェット。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/loop-prompts-interrupt-1.png)
このループで 40 秒のプロンプトを 3 つ設定し、割り込みを 60 秒に設定したシナリオを考えてみましょう。ケースごとに何が起こるかは、以下のとおりです。
**[割り込み中もプロンプトを続行]** を有効にしない場合:
+ ブロックは、60 秒のタイムアウトまでプロンプトを順番に再生します。つまり、最初のプロンプトは完全に再生され、その後に 2 番目のプロンプトが 20 秒再生されます。
+ 60 秒後、Connect は [プロンプトをループ] ブロックの [タイムアウト] ブランチでフローロジックを実行します。これには、短いサイレンスや再生プロンプトブロックを介した別のプロンプトなど、さまざまな音声処理が含まれる場合があります。
+ [タイムアウト] ブランチで [再開] ブロックを実行すると、Connect は最初のプロンプトの先頭からプロンプトを再開します。
+ この動作により、60 秒後にスケジュールされている重要な情報 (3 番目のプロンプトなど) を顧客が聞くことができない場合があります。これは、Amazon Connect のデフォルトの音声プロンプト (最大 4 分の長さ) を使用した場合に特に発生する可能性があります。
**[割り込み中もプロンプトを続行]** を有効にした場合:
+ ブロックはプロンプトを順番に再生します。
+ Connect は、60 秒間に最初のプロンプトと 2 番目のプロンプトの 20 秒間を再生した後で、[プロンプトをループ] ブロックの [タイムアウト] ブランチでフローロジックを実行します。
+ [タイムアウト] ブランチが、さまざまな音声を再生するフローブロック ([プロンプトを再生]、[顧客の入力を取得する]、[顧客の入力を保存]、[Lex ボットを呼び出す] など) を使用していない場合、Connect は割り込みが発生した場所からプロンプト音声の再生を継続します。顧客にとって、これは 2 番目のプロンプトと 3 番目のプロンプトが中断なしで再生されたように聞こえます。
+ [タイムアウト] ブランチに、さまざまな音声設定 (待機時間が長いためにコールバックを提案するプロンプトなど) が含まれている場合、Connect は [プロンプトをループ] ブロックを中断して、この音声を再生します。次に、[タイムアウト] ブランチのロジックを実行してから、[プロンプトをループ] ブロックの次のプロンプトの先頭から再開します。例えば、2 番目のプロンプト中に中断された場合、Connect は [タイムアウト] ブランチのロジックを実行した後で、3 番目のプロンプトの先頭から再開します。
## 設定のヒント
+ 次のブロックは、**プロンプトのループ**ブロックの前で使用できません。
+ [顧客の入力を取得する](get-customer-input.md)
+ [ループ](loop.md)
+ [プロンプトの再生](play.md)
+ [メディアストリーミングの開始](start-media-streaming.md)
+ [メディアストリーミングの停止](stop-media-streaming.md)
+ [顧客の入力を保存する](store-customer-input.md)
+ [電話番号への転送](transfer-to-phone-number.md)
+ **コールバックキューへの転送**など、[キューへの転送](transfer-to-queue.md)
+ Amazon Connect ライブラリまたは S3 バケットからのプロンプトの選択については、[プロンプトの再生](play.md) ブロックを参照してください。
+ [**ループプロンプト**] がキューフローで使用されると、オーディオプレイバックは、フローを使用してプリセット時間に中断できます。
+ 常に、20 秒を超える中断期間を使用してください。これは、利用可能なエージェントが問い合わせを受け入れるために必要な時間です。中断期間が 20 秒未満の場合、問い合わせが [**Error (エラー)**] ブランチに入ることがあります。これは、アクティブなエージェントにルーティングされ、参加する 20 秒のウィンドウにある顧客のキューからの削除を Amazon Connect がサポートしていないためです。
+ ループの内部カウンタは、フローではなく、コールに対して保持されます。コール中にフローを再利用しても、ループカウンタはリセットされません。
+ このブロックがチャット会話中にトリガーされた場合、コンタクトは **[エラー]** ブランチにルーティングされます。
+ 一部の既存のフローには、**[Error]** (エラー) ブランチを持たない **[Loop prompts]** (プロンプトのループ) ブロックのバージョンがあります。この場合、チャット問い合わせは顧客キューフローの実行を停止します。チャットは、次のエージェントが利用可能になったときにルーティングされます。
## 設定されているブロック
次の画像は、このブロックが Amazon Connect ライブラリからのプロンプトを再生するように設定されたときの表示例を示しています。**[音声記録]** の横にある「\$1」を選択すると、ファイルの完全な名前が表示されます。設定されたブロックには、**[タイムアウト]** と **[エラー]** の 2 つのブランチがあります。
![\[Amazon Connect ライブラリからのプロンプトを再生するように設定された [プロンプトのループ] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/loop-prompts-configured.png)
次の画像は、このブロックが Amazon S3 からのプロンプトを再生するように設定されたときの表示例を示しています。**[S3 パス]** の横の[\$1] を選択すると、フルパスが表示されます。設定されたブロックには、**[タイムアウト]** と **[エラー]** の 2 つのブランチがあります。
![\[Amazon S3 からのプロンプトを再生するように設定された [プロンプトのループ] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/loop-prompts-configured2.png)
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
+ [Amazon Connect のコールバックでの割り込み可能キューフローのサンプル](sample-interruptible-queue.md)
## シナリオ
このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [Amazon Connect でキュー内の問い合わせを管理するフローを設定する](queue-to-queue-transfer.md)
# Amazon Connect のフローブロック: プロンプトの再生
このトピックでは、音声プロンプト、テキスト読み上げメッセージ、または顧客やエージェントへのチャット応答を再生するためのフローブロックを定義します。
## 説明
このブロックを使用して、音声プロンプトやテキスト読み上げメッセージの再生、またはチャットレスポンスの送信を行います。
お客様 (発信者またはチャットを利用しているお客様) とエージェントに対してプロンプトを再生できます。
通話の場合は、次のオプションがあります。
+ **録音済みのプロンプトを使用する**: Amazon Connect には、あらかじめオプションが用意されたライブラリがあります。
+ **独自のプロンプトを録音する**。次のオプションがあります。
+ Amazon Connect ライブラリを使用する。 Amazon Connect 管理ウェブサイトから直接録音をアップロードします。
+ Amazon S3 を使用する。プロンプトを S3 に保存しておき、通話中に動的にアクセスします。
+ **テキスト読み上げ**。音声として読み上げるプレーンテキストまたは SSML (音声合成マークアップ言語) を入力します。
チャットの場合は、次のオプションがあります。
+ **テキストプロンプトのみ**。お客様とエージェントの両方にプレーンテキストメッセージを送信します。録音済みのプロンプトなどの音声オプションは、チャットでは使用できません。
## このブロックのユースケース
このフローブロックは、以下のシナリオでの使用を想定して設計されています。
+ お客様へのあいさつを再生する。例えば、「カスタマーサービスラインをご利用くださり、ありがとうございます」など。
+ データベースから取得した情報をお客様やエージェントに提示する。例えば、「アカウントの残高は \$1123.45 です」など。
+ お客様がキューに入っている間や保留中に、事前に録音した音声を再生する。
+ 自分の声で録音しておいた音声を S3 バケットから再生する。
+ 着信フローでは、音声メッセージまたはテキストメッセージを顧客とエージェントに同時に再生します。
## プロンプトの要件
+ **サポートされている形式**: Amazon Connect は、プロンプトに使用する .wav ファイルをサポートしています。8 KHz の .wav ファイルと U-Law エンコーディングのモノチャネルオーディオを使用する必要があります。そうしないと、プロンプトが正しく再生されません。公開されているサードパーティーツールを使用して、.wav ファイルを U-Law エンコーディングに変換できます。ファイルを変換した後、Amazon Connect にアップロードします。
+ **サイズ**: Amazon Connect は、50 MB 未満かつ 5 分未満のプロンプトをサポートします。
+ **S3 バケットにプロンプトを保存する場合**: アフリカ (ケープタウン) など、デフォルトで無効になっている AWS リージョン ([オプトイン](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html)リージョンとも呼ばれます) の場合、バケットは同じリージョンに存在する必要があります。
## コンタクトのタイプ
| コンタクトのタイプ | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい チャットコンタクトがルーティングされた先のブロックが通話用に設定されている場合、コンタクトは **[エラー]** ブランチにルーティングされます。 |
| タスク | はい タスクコンタクトがルーティングされた先のブロックが通話用に設定されている場合、コンタクトは **[エラー]** ブランチにルーティングされます。 |
| E メール | いいえ – **[成功]** ブランチに分岐しますが、影響はありません。 |
エージェントまたは顧客のないコンタクトのコールバックがこのブロックにルーティングされた場合、コンタクトは **[エラー]** ブランチにルーティングされます。
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
| フロータイプ | サポート対象? |
| --- | --- |
| 着信フロー | はい |
| 顧客キューフロー | はい。Amazon Connect ライブラリからプロンプトを再生できますが、Amazon S3 に保存されているプロンプトは再生できません。 |
| 顧客保留フロー | いいえ。代わりに [[プロンプトのループ](loop-prompts.md)] フローブロックを使用してください。 |
| 顧客ウィスパーフロー | はい。Amazon Connect ライブラリからプロンプトを再生できますが、Amazon S3 に保存されているプロンプトは再生できません。 |
| アウトバウンドウィスパーフロー | はい。Amazon Connect ライブラリからプロンプトを再生できますが、Amazon S3 に保存されているプロンプトは再生できません。 |
| エージェント保留フロー | いいえ。代わりに [[プロンプトのループ](loop-prompts.md)] フローブロックを使用してください。 |
| エージェントウィスパーフロー | はい。Amazon Connect ライブラリからプロンプトを再生できますが、Amazon S3 に保存されているプロンプトは再生できません。 |
| エージェントへの転送フロー | はい |
| キューへの転送フロー | はい |
## このブロックの設定方法
**プロンプトの再生**ブロックを設定するには、 Amazon Connect 管理者ウェブサイトを使用するか、Amazon Connect フロー言語で [MessageParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-messageparticipant.html) アクションを使用します。
**Topics**
+ [Amazon Connect のプロンプトライブラリに保存されているプロンプト](#play-properties-library)
+ [Amazon S3 に保存されているプロンプト](#play-properties-s3)
+ [テキスト読み上げまたはチャットテキスト](#play-properties-text-to-speech)
+ [フローブロックのブランチ](#play-branches)
+ [追加の設定のヒント](#play-tips)
+ [このブロックで生成されるデータ](#play-data)
### Amazon Connect のプロンプトライブラリに保存されているプロンプト
1. フローデザイナーで、**[プロンプトの再生]** ブロックの設定ペインを開きます。
1. **[プロンプトライブラリ (音声) から選択]** を選択します。
1. Amazon Connect に含まれている録音済みプロンプトのいずれかを選択するか、 Amazon Connect 管理者ウェブサイトを使用して独自のプロンプト[を記録およびアップロード](prompts.md)します。プロンプトを一括アップロードする方法はありません。
次の画像は、プロンプトライブラリからの音声プロンプトを再生するように設定された **[プロンプトの再生]** ブロックの **[プロパティ]** ページを示しています。
![\[[プロンプトの再生] ブロックの [プロパティ] ページ、プロンプトライブラリ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/playprompt-properties-library-manually.png)
次のコード例は、上記と同じ設定が、Flow 言語の [MessageParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-messageparticipant.html) アクションではどのように表現されるかを示しています。
```
{
"Identifier": "12345678-1234-1234-1234-123456789012",
"Type": "MessageParticipant",
"Parameters": {
"PromptId": "arn:aws:connect:us-west-2:1111111111:instance/aaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/prompt/abcdef-abcd-abcd-abcd-abcdefghijkl"
},
"Transitions": {
"NextAction": "a625f619-81b0-46c3-a855-89151600bdb1",
"Errors": [
{
"NextAction": "a625f619-81b0-46c3-a855-89151600bdb1",
"ErrorType": "NoMatchingError"
}
]
}
}
```
### Amazon S3 に保存されているプロンプト
S3 バケットに必要な数だけプロンプトを保存しておき、バケットパスを指定して、それらを参照します。最高のパフォーマンスを得るには、Amazon Connect インスタンスと同じ AWS リージョンに S3 バケットを作成することをお勧めします。
**S3 バケットにある音声ファイルを指定するには**
1. フローデザイナーで、**[プロンプトの再生]** ブロックの設定ペインを開きます。
1. **[S3 バケットから音声ファイルを指定]** を選択します。
1. **[手動で設定]** を選択し、S3 にある音声プロンプトを指す S3 ファイルパスを指定します。例えば、`https://u1.s3.amazonaws.com/en.lob1/welcome.wav`。
次の画像は、S3 ファイルパスを手動で設定するように設定された **[プロンプトの再生]** ブロックの **[プロパティ]** ページを示しています。
![\[[プロンプトの再生] ブロックの [プロパティ] ページ、手動で指定された S3 ファイルパス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/playprompt-properties-s3-manually.png)
次のコード例は、上記と同じ設定が、Flow 言語の [MessageParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-messageparticipant.html) アクションではどのように表現されるかを示しています。
```
{
"Identifier": "UniqueIdentifier",
"Type": "MessageParticipant",
"Parameters": {
"Media": {
"Uri": "https://u1.s3.amazonaws.com/en.lob1/welcome.wav",
"SourceType": "S3",
"MediaType": "Audio"
}
},
"Transitions": {
"NextAction": "Next action identifier on success",
"Errors": [
{
"NextAction": "Next action identifier on failure",
"ErrorType": "NoMatchingError"
}
]
}
}
```
**属性を使用して S3 バケットにある音声ファイルのパスを指定するには**
+ 属性を使用して S3 バケットパスを指定できます (下図を参照)。
![\[属性を使用して手動で指定された S3 ファイルパス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/playprompt-properties-s3-jsonpath.png)
—OR—
+ 次の例に示すように、S3 パスに連結を指定することができます。これにより、例えば、基幹業務や言語別にプロンプトをパーソナライズできます。例: `https://example.s3.amazon.aws.com/$['Attributes']['Language']/$['Attributes']['LOB']/1.wav`
次のコード例は、上記と同じ設定が、Flow 言語の [MessageParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-messageparticipant.html) アクションではどのように表現されるかを示しています。
```
{
"Identifier": "UniqueIdentifier",
"Type": "MessageParticipant",
"Parameters": {
"Media": {
"Uri": "https://u1.s3.amazonaws.com/$['Attributes']['Language']/$['Attributes']['LOB']/1.wav",
"SourceType": "S3",
"MediaType": "Audio"
}
},
"Transitions": {
"NextAction": "Next action identifier on success",
"Errors": [
{
"NextAction": "Next action identifier on failure",
"ErrorType": "NoMatchingError"
}
]
}
}
```
**ユーザー定義のコンタクト属性を使用して S3 パスを動的に指定するには**
1. 次の図は、**S3filepath** という名前のユーザー定義の属性を示しています。
![\[王的に設定された S3 ファイルパス、ユーザー定義に設定された名前空間。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/playprompt-properties-s3-attributes.png)
次のコード例は、上記と同じ設定が、Flow 言語の [MessageParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-messageparticipant.html) アクションではどのように表現されるかを示しています。
```
{
"Parameters": {
"Media": {
"Uri": "$.Attributes.MyFile",
"SourceType": "S3",
"MediaType": "Audio"
}
},
"Identifier": "9ab5c4ee-7da8-44b3-b6c9-07f24e1846dc",
"Type": "MessageParticipant",
"Transitions": {
"NextAction": "a625f619-81b0-46c3-a855-89151600bdb1",
"Errors": [
{
"NextAction": "a625f619-81b0-46c3-a855-89151600bdb1",
"ErrorType": "NoMatchingError"
}
]
}
}
```
次の図は、S3 パスを動的に設定した場合の、このブロックの表示例です。S3 パスが表示されていて、**[成功]** と **[エラー]** の 2 つのブランチがあります。
![\[S3 パス用に設定された [プロンプトの再生] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/play-prompt-configured2.png)
### テキスト読み上げまたはチャットテキスト
プレーンテキストまたは SSML でプロンプトを入力できます。これらのテキストベースのプロンプトは、Amazon Polly を使用してお客様に音声プロンプトとして再生されます。
例えば、次の図の **[プロンプトの再生]** ブロックは、「**Thank you for calling**」というメッセージをお客様に再生するように設定されています。
![\[手動で設定されたテキスト読み上げプロンプト。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/play-prompt-sample-ssml.png)
次のコード例は、上記と同じ設定が、Flow 言語の [MessageParticipant](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-messageparticipant.html) アクションではどのように表現されるかを示しています。
```
{
"Parameters": {
"Text": "Thank you for calling"
},
"Identifier": "9ab5c4ee-7da8-44b3-b6c9-07f24e1846dc",
"Type": "MessageParticipant",
"Transitions": {
"NextAction": "a625f619-81b0-46c3-a855-89151600bdb1",
"Errors": [
{
"NextAction": "a625f619-81b0-46c3-a855-89151600bdb1",
"ErrorType": "NoMatchingError"
}
]
}
}
```
SSML 拡張された入力テキストを使用すると、Amazon Connect を使用して入力したテキストから音声を生成する方法を詳細に制御できます。発音、音量、ピッチ、話す速度など、音声のさまざまな要素をカスタマイズして制御できます。
Amazon Connect で使用できる SSML タグのリストについては、「[Amazon Connect でサポートされている SSML タグ](supported-ssml-tags.md)」を参照してください。
詳細については、「[Amazon Polly でフローブロックのプロンプトにテキスト読み上げを追加する](text-to-speech.md)」を参照してください。
次の図は、テキスト読み上げ用に設定された **[プロンプトの再生]** ブロックの表示例です。再生されるテキストと、**[成功]** と **[エラー]** の 2 つのブランチがあることを示しています。
![\[テキスト読み上げように設定された [プロンプトの再生] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/play-prompt-configured.png)
### フローブロックのブランチ
このブロックは、次の出力ブランチをサポートしています。
+ **成功**: 指定した音声メッセージまたはテキストメッセージが正常に再生されたことを示します。
+ **エラー**: 指定した音声メッセージまたはテキストメッセージを再生できなかったことを示します。
+ **OK**: 一部の既存のフローには、**[エラー]** ブランチがないバージョンの **[プロンプトの再生]** ブロックがあります。この場合は、実行時に常に [**Okay**] (オーケー) ブランチが取得されます。[**エラー**] ブランチを持っていない [**プロンプトの再生**] ブロックの設定を更新すると、[**エラー**] ブランチはエディタでブロックに自動的に追加されます。
### 追加の設定のヒント
+ コンタクト属性を使用してダイナミックプロンプトを設定する方法のステップバイステップの手順については、「[Amazon Connect で再生するプロンプトを動的に選択する](dynamically-select-prompts.md)」を参照してください。
+ S3 バケットからプロンプトを再生する場合、最高のパフォーマンスを得るには、Amazon Connect インスタンスと同じ AWS リージョンにバケットを作成することをお勧めします。
+ テキスト読み上げまたはチャットにテキストを使用する場合は、最大 3,000 の課金対象文字 (合計 6,000 文字) を使用できます。問い合わせ属性を使用して、フロー内のテキストを指定することもできます。
### このブロックで生成されるデータ
このブロックではデータは生成されません。
## エラーシナリオ
コンタクトは、次の状況で **[エラー]** ブランチへルーティングされます。
+ エージェントまたは顧客のないコンタクトのコールバックがこのブロックにルーティングされた場合、コンタクトは **[エラー]** ブランチにルーティングされます。
+ Amazon Connect が S3 からプロンプトをダウンロードできません。これは、ファイルパスが正しくないか、S3 バケットポリシーが正しく設定されておらず、Amazon Connect がアクセスできないことが原因である可能性があります。ポリシーを適用する方法と使用できるテンプレートについては、「[Amazon Connect で S3 バケットから再生するプロンプトを設定する](setup-prompts-s3.md)」を参照してください。
+ オーディオファイル形式が正しくありません。.wav ファイルのみがサポートされています。
+ オーディオファイルが 50 MB より大きいか 5 分を超えています。
+ SSML が正しくありません。
+ テキスト読み上げの長さが 6,000 文字を超えています。
+ プロンプトの Amazon リソースネーム (ARN) が正しくありません。
## サンプルフロー
すべてのサンプルフローでは、[**Play prompt (プロンプトの再生)**] ブロックが使用されます。「[Amazon Connect に含まれる最初のコンタクトエクスペリエンスの着信フローのサンプル](sample-inbound-flow.md)」を参照して、チャットと音声用の [**Play prompt (プロンプトの再生)**] を確認します。
## その他のリソース
プロンプトの詳細については、以下のトピックを参照してください。
+ [Amazon Connect でプロンプトを作成する](prompts.md)
+ Amazon Connect API リファレンスガイドの[プロンプトアクション](https://docs.aws.amazon.com/connect/latest/APIReference/prompts-api.html)。
# Amazon Connect のフローブロック: コンタクトを再開
このトピックでは、一時停止状態からタスクコンタクトを再開するためのフローブロックを定義します。
## 説明
+ 一時停止状態からコンタクトを再開します。これにより、エージェントはアクティブなスロットを解放できるため、例えば承認されなかったり、外部からの入力を待機中であるなどの理由で現在のタスクが一時停止した場合に、より重要なタスクを受けられるようになります。
+ Amazon Connect でのタスクの一時停止と再開の仕組みの詳細については、「[Amazon Connect タスクでのタスクの一時停止と再開](concepts-pause-and-resume-tasks.md)」を参照してください。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | いいえ - [エラー] ブランチ |
| Chat | いいえ - エラーブランチ |
| タスク | はい |
| E メール | いいえ - [エラー] ブランチ |
## フロータイプ
このブロックは、すべてのフロータイプで使用できます。
## プロパティ
次の画像は、**[コンタクトを再開]** ブロックの **[プロパティ]** ページを示しています。
![\[[コンタクトを再開] タグのプロパティページ\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/resume-contact.png)
## 設定のヒント
キューから取り除かれた未割り当ての一時停止タスクを再開するフローを設計する場合は、再開後にタスクをキューに入れる [キューへの転送](transfer-to-queue.md) ブロックを必ずフローに追加します。追加しない場合、タスクはキューから取り除かれた状態のままになります。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。設定されているのは、**[エラーイベント]** 分岐のみです。
![\[設定済みの [コンタクトを再開] ブロック\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/resume-contact-configured.png)
# Amazon Connect のフローブロック: 戻る (モジュールから）
このトピックでは、一時停止状態からタスクコンタクトを再開するためのフローブロックを定義します。
## 説明
+ **[戻る]** ブロックを使用して、[フローモジュール](contact-flow-modules.md)のターミナルアクションまたはターミナルステップをマークします。
+ このブロックを使用して、フローモジュールが正常に実行された後で、そのモジュールを終了します。引き続き、そのモジュールが参照されているフローが実行されます。
## サポートされているフローのタイプ
このブロックは[フローモジュール](contact-flow-modules.md)でのみ使用できます。他のタイプのフローでは使用できません。
| フロータイプ | サポート対象? |
| --- | --- |
| インバウンドフロー (contactFlow) | いいえ |
| 顧客キューフロー (customerQueue) | いいえ |
| 顧客保留フロー (customerHold) | いいえ |
| 顧客ウィスパーフロー (customerWhisper) | いいえ |
| 発信ウィスパーフロー (outboundWhisper) | いいえ |
| エージェント保留フロー (agentHold) | いいえ |
| エージェントウィスパーフロー (agentWhisper) | いいえ |
| エージェントへの転送フロー (agentTransfer) | いいえ |
| キューへの転送フロー (queueTransfer) | いいえ |
## サポートされているコンタクトのタイプ
次の表に、このブロックでの、指定されたチャネルを使用しているコンタクトのルーティング先を示します。
| コンタクトのタイプ | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フローブロックの設定
**[戻る] ブロックを使用するには**
1. Amazon Connect 管理ウェブサイトで、**ルーティング**、**フロー**を選択します。
1. **[フロー]** ページで **[モジュール]** タブを選択します (下図を参照)。
![\[[フロー] ページの [モジュール] タブ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/return-block-flow-module.png)
1. **[フローモジュールを作成]** を選択するか、編集対象のモジュールを選択します。
1. ブロックドックから **[戻る]** ブロックを選択し、フローキャンバスにドラッグします。
### Amazon Connect 管理者ウェブサイトでブロックを返す (タグアクション用)
次の図は、フローエディタのキャンバスに **[戻る]** ブロックが表示されている様子を示しています。
![\[[コンタクトを再開] タグのプロパティページ\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/return-block-configured.png)
### Flow 言語での [戻る] ブロック
フローエディタの **[戻る]** フローブロックは、Amazon Connect Flow 言語では `EndFlowModuleExecution` アクションとして保存されます。
詳細については、「Amazon Connect API リファレンス**」の「EndFlowModuleExecution」を参照してください。
### [戻る] ブロックのプロパティを設定する方法
次の図は、**[戻る]** ブロックの **[プロパティ]** ペインを示しています。
![\[[戻る] ブロックのプロパティペイン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/return-block-properties.png)
1. このブロックはフローモジュールのターミナルブロックであるため、設定は不要です。
1. **[保存]** を選択して、準備ができたら公開してください。
次のコードは、上記と同じ設定が、Amazon Connect Flow 言語の EndFlowModuleExecution アクションではどのように表現されるかを示しています。
```
{
"Parameters": {},
"Identifier": "the identifier of the Return block",
"Type": "EndFlowModuleExecution",
"Transitions": {}
},
```
#### フローブロックの結果の説明
なし。サポートされる条件はありません。
## このブロックで生成されるデータ
このブロックではデータは生成されません。
### フローの各部でこのデータを使用する方法
このブロックでは、フローで使用できるデータは生成されません。
### フラグメント化されたアクションの表現 (該当する場合)
このブロックは、フラグメント化されたアクションをサポートしていません。
## 既知のエラーシナリオ
これはターミナルブロックであるため、このブロックの実行時にフローでエラーが起きるというシナリオは考えられません。
## フローログにおけるこのブロックの表示例
```
{
"ContactId": "string",
"ContactFlowId": "string",
"ContactFlowName": "string",
"ContactFlowModuleType": "Return",
"Identifier": "string",
"Timestamp": "2024-01-19T20:23:24.633Z",
"Parameters": {}
}
```
# Amazon Connect のフローブロック: メッセージを送信
このトピックでは、顧客にメッセージを送信するためのフローブロックを定義します。
**重要**
このブロックを使用してテキストメッセージを送信する前に、SMS メッセージングまたは WhatsApp Business メッセージングを有効にします。手順については、「[SNS メッセージングをセットアップする](setup-sms-messaging.md)」または「[WhatsApp ビジネスメッセージングを設定する](whatsapp-integration.md)」を参照してください。
## 説明
+ このフローブロックを使用して、指定したテンプレートまたはカスタムメッセージに基づいて顧客にメッセージを送信します。
## このブロックのユースケース
このフローブロックは、以下のシナリオでの使用を想定して設計されています。
+ 新しい E メール、SMS、または WhatsApp の連絡先を受け取ったら、自動確認を送信します。例えば、「メッセージをありがとうございます。24 時間以内に折り返しご連絡いたします。」
+ 問い合わせを解決する自動 E メール、SMS、または WhatsApp レスポンスを送信します。例えば、顧客が「パスワードをリセットするにはどうすればよいですか?」というテキストメッセージを送信してきた場合、手順を示すテンプレートまたは自動生成された応答を E メールで送信できます。
+ アンケート E メール、SMS、または WhatsApp メッセージを送信します。例:「本日はご利用いただき、ありがとうございました。当社の対応はいかがでしたか?」 このユースケースでは、[切断] フロータイプを使用します。
## コンタクトのタイプ
| コンタクトのタイプ | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## アウトバウンドフローでの [メッセージを送信] ブロックの使用に関する重要な情報
**重要**
Amazon Connect でアウトバウンドフロー (特に[デフォルトのアウトバウンドフロー](default-outbound.md)) を設定する場合、**[メッセージを送信]** ブロックで EMAIL メッセージタイプを使用するときに、意図しない E メールループを防ぐために安全策を実装することが重要です。
アウトバウンド E メールコンタクトを **[メッセージを送信フロー]** ブロックで作成すると、E メールの送信に**デフォルトのアウトバウンドフロー**がデフォルトで使用されます。これにより、**[メッセージを送信]** ブロックが設定されている同じフローに安全策が実装されていない場合、意図しない E メールループが発生する可能性があります。
次のガイドラインに従って、アウトバウンドフロー設定が意図したとおりに動作することを確認してください。
+ 可能であれば、**デフォルトのアウトバウンドフロー**または任意のアウトバウンドフロータイプで、EMAIL メッセージタイプを含む **[メッセージを送信]** ブロックを使用しません。
+ 任意のアウトバウンドフロータイプで、EMAIL メッセージタイプを含む **[メッセージを送信]** ブロックを使用する必要がある場合は、フローロジックにより、E メールループが発生しないことを確認します。
いずれのアウトバウンドフロータイプでも、**[メッセージを送信]** ブロックを使用するときは、以下の安全策を実装することをお勧めします。
+ アウトバウンドフローの **[メッセージを送信]** ブロックの直前に [[コンタクト属性を確認する](check-contact-attributes.md)] ブロックを追加します。
+ **[コンタクト属性を確認する]** ブロックを設定して、チャネルシステム属性 (`$.Channel`) が EMAIL で分岐するように設定されていることを確認します。
+ **[コンタクト属性を確認する]** ブロックの [EMAIL] ブランチを、**[メッセージ送信]** ブロックを使用しないように設定し、アウトバウンド E メールコンタクトがアウトバウンドフローを使用した場合の E メールループを防止します。
+ **[属性を確認]** ブロックの **[一致なし]** ブランチを、**[メッセージを送信]** ブロックを使用するように設定します。**No Match** ブランチは、VOICE、CHAT (SMS や WhatsApp などのサブタイプを含む）、または TASK コンタクトをフローの一部として **Send メッセージ**ブロックにルーティングする必要があります。
これらの安全策を実装すると、アウトバウンドフロータイプを使用するアウトバウンド E メールコンタクトによって、同じアウトバウンドフローを使用して意図しないアウトバウンド E メールコンタクトがさらに作成されるという、無限ループにつながるようなシナリオを回避できます。
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
| フロータイプ | サポート対象? |
| --- | --- |
| 着信フロー | はい |
| 顧客キューフロー | はい |
| 顧客保留フロー | はい |
| 顧客ウィスパーフロー | はい |
| アウトバウンドウィスパーフロー | はい |
| エージェント保留フロー | はい |
| エージェントウィスパーフロー | はい |
| エージェントへの転送フロー | はい |
| キューへの転送フロー | はい |
| 切断フロー | はい |
## 必要なアクセス許可
SMS、WhatsApp、または E メールメッセージを送信するようにこのブロックを設定するには、セキュリティプロファイルに次のアクセス許可が必要です。
+ **[チャネルとフロー] > [電話番号] > [表示]**: 電話番号のドロップダウンメニューを表示します。
+ **E メールアドレス** - **表示**: 送信元 E メールアドレスのドロップダウンメニューを表示します。
+ **コンテンツ管理** - **メッセージテンプレート** - **表示**: SMS メッセージ、WhatsApp メッセージ、E メールで使用できるメッセージテンプレートのドロップダウンメニューを表示します。
これらのアクセス許可がない場合でも、プロパティを動的に設定することは可能です。例えば、ブロックで電話番号が既に手動で設定されていて、**[表示]** アクセス許可なしでブロックを表示する場合、そのリソースを表示できます。ただし、ドロップダウンメニューのリソースのリストは表示できません。
## このブロックの設定方法
メッセージ**送信**ブロックを設定するには、 Amazon Connect 管理者ウェブサイトを使用するか、Amazon Connect フロー言語で [StartOutboundChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/contact-actions-startoutboundchatcontact.html) アクションを使用します。
**Topics**
+ [SMS を送信する (テキストメッセージ)](#sendmessage-block-sms)
+ [WhatsApp メッセージの送信](#sendmessage-block-whatsapp)
+ [E メールを送信する](#sendmessage-block-email)
+ [テンプレートの使用について](#sendmessage-block-email)
+ [テキストメッセージの作成について](#sendmessage-block-text)
### SMS を送信する (テキストメッセージ)
次の画像は、SMS メッセージを送信するように設定されている場合の **[メッセージを送信]** のプロパティページを示しています。
![\[[メッセージを送信] ブロックのプロパティページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/send-message-block-properties-sms.png)
SMS メッセージを送信するには、このページで次のプロパティを設定します。
+ **送信元**: メッセージの送信元の電話番号。ドロップダウンメニューには、Amazon Connect インスタンスに関連付けられた電話番号のリストが表示されます。
+ **手動で設定**: ドロップダウンメニューを使用して、Amazon Connect インスタンスに関連付けられた電話番号を検索します。
テンプレートのドロップダウンリストを表示するには、セキュリティプロファイルに必要な[アクセス許可](#sendmessage-block-perms)が必要です。
+ **動的に設定**: **名前空間**と**キー**に基づいて属性を受け入れます。この属性は、 Amazon Connect インスタンスに関連付けられた電話番号の ARN を指します。
+ **送信先**: メッセージの送信先の電話番号。
+ **手動で設定**: お客様の電話番号を入力します。これは SMS メッセージの送信先です。電話番号は 1 つだけ入力できます。これはブロックのテストで便利です。
+ **動的に設定**: **名前空間**と**キー**に基づいて属性を受け入れます。この属性は SMS の送信先の電話番号文字列です。これは E.164 形式である必要があります。
+ **メッセージ**: 顧客に送信されるメッセージ。
+ **テンプレートの使用**: ドロップダウンメニューを使用して、SMS テンプレートのリストから選択します。顧客に送信するテンプレートを 1 つ選択できます。
SMS テンプレートは、プレーンテキストのみを含む完全な SMS メッセージ構造になっています。応答全体または通知を顧客に提供します。
テンプレートのドロップダウンリストを表示するには、セキュリティプロファイルに必要な[アクセス許可](#sendmessage-block-perms)が必要です。
+ **テキストを使用**: メッセージを入力して **[手動で設定]** するか、**名前空間**と**キー**に基づく属性を追加して **[動的に設定]** し、プレーンテキストメッセージを送信します。
**注記**
**メッセージ**では、スペースを含む最大 1024 文字のプレーンテキスト (リンクや絵文字を含む) を使用できます。
+ **フロー**: 作成されたアウトバウンド問い合わせを処理する Amazon Connect フロー。このフローを使用して、アウトバウンドコンタクトをエージェントに割り当て、顧客に応答できます。
+ **手動で設定**: ドロップダウンメニューを使用して、公開されたフローのリストから選択します。
+ **動的に設定**: **名前空間**と**キー**に基づいて属性を受け入れます。この属性はフロー ARN を指します。
+ **コンタクトへのリンク**: このプロパティでは、作成されたアウトバウンドコンタクトを、フローを開始したインバウンドコンタクトにリンクできます。場合によっては、反復的なコンタクトの関連付けを避けるため、作成されたアウトバウンドコンタクトをリンクすべきではない場合があります。
+ このプロパティでは、アウトバウンド SMS コンタクトをフローを開始したインバウンドコンタクトにリンクできます。
場合によっては、繰り返しアウトバウンド SMS メッセージを送信しないように、コンタクトをリンクすべきではない場合があります。例えば、コンタクトを受信するたびに顧客に次のようなメッセージを送信するようにフローが設定されている場合です。「*メッセージをいただき、誠にありがとうございます。24 時間以内に折り返しご連絡いたします。*」
### WhatsApp メッセージの送信
次の図は、WhatsApp **メッセージを送信**するように設定されている場合のメッセージプロパティの送信ページを示しています。
![\[[メッセージを送信] ブロックのプロパティページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/send-message-block-properties-whatsapp.png)
ページで次のプロパティを設定して、WhatsApp メッセージを送信します。
+ **送信元**: メッセージの送信元の電話番号。ドロップダウンメニューには、Amazon Connect インスタンスにインポートされた WhatsApp 番号のリストが表示されます。
+ **手動で設定**する: ドロップダウンメニューを使用して、Amazon Connect インスタンスにインポートされた WhatsApp 番号を検索します。
テンプレートのドロップダウンリストを表示するには、セキュリティプロファイルに必要な[アクセス許可](#sendmessage-block-perms)が必要です。
+ **動的に設定する**: インスタンスにインポートされた WhatsApp 番号の ARN を指す**名前空間**と**キー**に基づいて属性を受け入れます Amazon Connect 。
+ **宛先**: メッセージの送信先の WhatsApp 番号。
+ **手動で設定**: 顧客の WhatsApp 番号を入力します。ここで WhatsApp メッセージが送信されます。WhatsApp 番号は 1 つだけ入力できます。これはブロックのテストで便利です。
+ **動的に設定する**: メッセージが送信される WhatsApp 番号文字列である**名前空間**と**キー**に基づいて属性を受け入れます。これは E.164 形式である必要があります。
+ **メッセージテンプレート**: お客様に送信されるメッセージを含むテンプレート。
+ ドロップダウンメニューを使用して、WhatsApp テンプレートのリストから選択します。WhatsApp メッセージを顧客に送信するには、テンプレートを選択する必要があります。
WhatsApp テンプレートは、プレーンテキスト、インタラクティブコンポーネント、メディアコンテンツを含むことができる完全な WhatsApp メッセージ構造です。応答全体または通知を顧客に提供します。
**注記**
WhatsApp ユーザーがビジネスをメッセージまたは呼び出すたびに、[カスタマーサービスウィンドウ](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/send-messages#customer-service-windows)と呼ばれる 24 時間のタイマーが開始されます (または、すでに開始されている場合は更新されます）。企業は、このウィンドウ外のお客様にのみテンプレートメッセージを送信できます。
顧客が過去 24 時間以内にビジネスにメッセージを送信していない場合、顧客はカスタマーサービスウィンドウ外にあります。この場合、このメッセージ送信フローブロックからメッセージを送信することはできますが、Play Prompt フローブロックからの後続のメッセージはテンプレート化されたメッセージではないため配信に失敗します。
テンプレートのドロップダウンリストを表示するには、セキュリティプロファイルに必要な[アクセス許可](#sendmessage-block-perms)が必要です。
+ **フロー**: 作成されたアウトバウンド問い合わせを処理する Amazon Connect フロー。このフローを使用して、アウトバウンドコンタクトをエージェントに割り当て、顧客に応答できます。
+ **手動で設定**: ドロップダウンメニューを使用して、公開されたフローのリストから選択します。
+ **動的に設定**: **名前空間**と**キー**に基づいて属性を受け入れます。この属性はフロー ARN を指します。
+ **コンタクトへのリンク**: このプロパティでは、作成されたアウトバウンドコンタクトを、フローを開始したインバウンドコンタクトにリンクできます。場合によっては、反復的なコンタクトの関連付けを避けるため、作成されたアウトバウンドコンタクトをリンクすべきではない場合があります。
+ このプロパティを使用すると、アウトバウンド WhatsApp コンタクトを、フローを開始したインバウンドコンタクトにリンクできます。
状況によっては、繰り返しのアウトバウンド WhatsApp メッセージを送信しないように、問い合わせをリンクしたくない場合があります。例えば、コンタクトを受信するたびに顧客に次のようなメッセージを送信するようにフローが設定されている場合です。「*メッセージをいただき、誠にありがとうございます。24 時間以内に折り返しご連絡いたします。*」
### E メールを送信する
次の画像は、E メールを送信するように設定されている場合の **[メッセージを送信]** のプロパティページを示しています。
![\[[メッセージを送信] ブロックのプロパティページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/send-message-block-properties-email.png)
E メールメッセージを送信するには、[**メッセージを送信**] のプロパティページで以下のプロパティを設定します。
+ **送信元**: ドロップダウンメニューを使用して、メッセージの送信元の E メールアドレスを選択します。メニューには、Amazon Connect インスタンス用に設定された E メールアドレスのリストが表示されます。
E メールのドロップダウンリストを表示するには、セキュリティプロファイルに[必須のアクセス許可](#sendmessage-block-perms)が必要です。
+ **手動で設定**: ドロップダウンメニューを使用して、Amazon Connect インスタンス用に設定されている E メールアドレスを検索します。
+ **動的に設定**: ドロップダウンメニューから名前空間とキーを選択します。例えば、送信元の E メールアドレスを、顧客が E メールを送信した先の E メールアドレスと同じにする場合は、**[名前空間]** = **[システム]**、**[キー]** = **[システムの E メールアドレス]** を選択します。
+ **送信先**: E メールメッセージを送信する先の E メールアドレス。
+ **手動で設定**: 1 つの E メールアドレスを *customer@example.com* の形式で入力します。
+ **動的に設定**: ドロップダウンメニューから名前空間とキーを選択します。例えば、顧客の E メールアドレスに E メールで返信するには、**[名前空間]** = **[システム]**、**[キー]** = **[顧客のエンドポイントアドレス]** を選択します。
+ **CC**: E メールの CC 行に入力する E メールアドレス。
**重要**
CC 行に入力できる E メールアドレスは 1 つだけです。
+ **手動で設定**: このテキストボックスを使用して、複数の E メールアドレスのリストをセミコロン (;) で区切って入力します。これらの E メールアドレスにメッセージが送信されます。
+ **動的に設定**: **名前空間**と**キー**に基づいて属性を入力します。例えば、顧客から受信した元の E メールの CC に含まれていた同じ E メールアドレスを、返信する E メールの CC に含めるには、**[名前空間]** = **[システム]**、**[キー]** = **[CC の E メールアドレスリスト]** を選択します。
+ **メッセージ**:
+ **テンプレートの使用**: ドロップダウンメニューを使用して、コンタクトセンター用に作成された E メールテンプレートのリストから選択します。顧客に送信するテンプレートを 1 つ選択できます。
+ **テキストの使用**: プレーンテキストメッセージを入力します。
+ **件名**: 例えば、顧客の元の E メールと同じ件名をするなど、件名を動的に入力するには、**[名前空間]** = **[セグメント属性]**、**[キー]** = **[E メールの件名]** を選択します。
+ **メッセージ**: メッセージを動的に入力するには、**[ユーザー定義]** 属性を選択します。
+ **コンタクトへのリンク**:
+ このプロパティでは、アウトバウンド E メールコンタクトを、フローを開始したインバウンドコンタクトにリンクできます。
場合によっては、アウトバウンド E メールメッセージを繰り返し送信しないように、コンタクトをリンクしたくない場合もあります。例えば、コンタクトを受信するたびに顧客に次のようなメッセージを送信するようにフローが設定されている場合です。「*メッセージをいただき、誠にありがとうございます。X 時間以内に折り返しご連絡いたします。*」
### ブロックでのテンプレートの使用について
E メールテンプレートは、プレーンテキストまたはリッチテキストコンテンツを含む完全な E メールメッセージです。これは、E メールメッセージの一部または全部のパターンとして機能します。E メールテンプレートは、以下の目的に使用できます。
+ エージェントの関与なしに、エンドユーザーに確認応答または自動応答を送信するフロー。
+ コンタクトセンターのマネージャーは、すべてのエージェントのレスポンスの構造または概要を定義し、署名、ヘッダー/フッターのブランド、免責事項などの詳細が常に顧客への応答に含まれるようにします。
次の画像は、使用可能な E メールテンプレートのリストを示すドロップダウンメニューの例です。
![\[[メッセージを送信] ブロックのプロパティページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/send-message-block-template.png)
E メールテンプレートには、顧客に送信する E メールメッセージの件名と本文が表示されます。
**注記**
テンプレートの件名は、**[メッセージを送信]** ブロックがインバウンド E メールコンタクトへの返信または全員に返信に使用されている場合は表示されません。
### ブロック内での E メールとテキストメッセージの作成について
E メールの場合、**[メッセージを送信]** ブロックで作成したメッセージを使用するときは、E メールの **[件名]** と **[メッセージ]** を入力する必要があります。
+ **件名**: スペースも含めて最大 998 文字を入力できます。
+ **メッセージ**: スペースも含めて、最大 5,000 文字のプレーンテキストを入力します。メッセージは、メッセージを入力して手動で設定するか、フロー内で設定した**ユーザー定義**属性を使用して動的に設定できます。次の画像は、E メールメッセージの文字数を示しています。
![\[E メールメッセージの文字数。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/send-message-block-email-characters.png)
SMS の場合、**[メッセージを送信]** ブロックで作成したメッセージを使用するときは、件名を入力せずに **[メッセージ]** のみを入力する必要があります。
+ **メッセージ**: スペースも含めて、最大 1,024 文字のプレーンテキストを入力します。または、フロー内で設定したユーザー定義属性を使用してメッセージを動的に設定します。
## エラーシナリオ
コンタクトは、次の状況で **[エラー]** ブランチへルーティングされます。
+ **[送信元]** フィールドにシステム E メールアドレスが存在しないなど、ブロックに渡された情報が正しくありません。
+ E メール送信サービスの障害。
+ E メールテンプレートの一部の属性を送信前に入力できませんでした。
# Amazon Connect のフローブロック: コールバック番号の設定
このトピックでは、顧客にコールバックする番号を設定するためのフローブロックを定義します。
## 説明
+ コールバック番号を設定する属性を指定します。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | いいえ - 無効な数値ブランチ |
| タスク | いいえ - 無効な数値ブランチ |
| E メール | いいえ - 無効な数値ブランチ |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer Queue flow (顧客キューフロー)]
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
次の画像は、**[コールバック番号の設定]** ブロックの **[プロパティ]** ページを示しています。
![\[[コールバック番号の設定] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-callback-number.png)
## 設定のヒント
+ [顧客の入力を保存する](store-customer-input.md) ブロックは、多くの場合、このブロックの前に来ます。顧客のコールバック番号が保存されます。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]**、**[無効な番号]**、および **[ダイヤル不可]** ブランチがあります。
![\[設定された [コールバック番号の設定] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-callback-number-configured.png)
1. **[無効な番号]**: 顧客は有効でない電話番号を入力しました。
1. **[ダイヤル不可]**: Amazon Connect はその番号にダイヤルできません。例えば、インスタンスで \$1447 プレフィックス電話番号へ発信が許可されておらず、顧客が \$1447 プレフィックス番号へのコールバックをリクエストした場合。番号は有効ですが、Amazon Connect は電話できません。
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
+ [Amazon Connect のキュー設定フローのサンプル](sample-queue-configurations.md)
+ [Amazon Connect のキューに入れられたコールバックフローのサンプル](sample-queued-callback.md): このサンプルは、Amazon Connect の以前のインスタンスにのみ適用されます。
## シナリオ
このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [Amazon Connect でフロー、キュー、およびルーティングプロファイルを作成して、キューに保存されたコールバックを設定する](setup-queued-cb.md)
+ [Amazon Connect のリアルタイムメトリクスでキューに入れられたコールバック](about-queued-callbacks.md)
# Amazon Connect のフローブロック: コンタクト属性の設定
このトピックでは、キーと値のペアをコンタクト属性として保存し、後でフローで参照される値を設定するためのフローブロックを定義します。
## 説明
キーと値のペアをコンタクト属性として保存します。後からフローで参照する値を設定します。
例えば、顧客アカウントのタイプに基づいてキューにルーティングされる顧客にパーソナライズした挨拶を作成します。会社名または基幹業務の属性を定義して、顧客に発話されるテキスト読み上げの文字列に含めることもできます。
**[問い合わせ属性の設定]** ブロックは、例えば、外部ソースから取得した属性をユーザー定義属性にコピーするのに役立ちます。
問い合わせ属性の詳細については、「[Amazon Connect で問い合わせ属性を使用する](connect-contact-attributes.md)」を参照してください。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ すべてのフロー
## プロパティ
次の画像は、**[コンタクト属性の設定]** ブロックの **[プロパティ]** ページを示しています。**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 ログに表示されます。
## 属性を参照する方法
+ 各属性の JSON 構文については、「[Amazon Connect で使用可能なコンタクト属性とその JSONPath 参照のリスト](connect-attrib-list.md)」を参照してください。。
+ スペースなど、名前に特殊文字を含む属性を参照するには、属性名を角カッコと一重引用符で囲みます。例: ` $.Attributes.['user attribute name']`。
+ システム属性など、同じ名前空間の属性を参照するには、属性名、または [**宛先キー**] として指定した名前を使用します。
+ 外部属性の参照など、別の名前空間の値を参照するには、属性に JSONPath 構文を指定します。
+ 問い合わせ属性を使用して、その他のリソースにアクセスするには、フローでユーザー定義属性を設定し、属性の値としてアクセスするリソースの Amazon リソースネーム (ARN) を使用します。
### Lambda での例
+ Lambda 関数ルックアップから顧客名を参照する場合は、\$1.External.AttributeKey を使用します。この際、AttributeKey を Lambda 関数から返された属性のキー (または名前) に置き換えます。
+ Amazon Connect プロンプトを Lambda 関数で使用するには、ユーザー定義の属性をプロンプトの ARN に設定した上で、Lambda 関数からその属性にアクセスします。
### Amazon Lex での例
+ Amazon Lex ボットから属性を参照するには、参照する Amazon Lex ボットの一部を形式 \$1.Lex. に含めて (\$1.Lex.IntentName などとして) 使用します。
+ 顧客からの Amazon Lex ボットスロットへの入力を参照するには、\$1.Lex.Slots.*slotName* を使用します。この際、*slotName* はボットのスロット名と置き換えます。
## 属性が 32 KB を上回る場合に起きること
属性のサイズ上限は 32 KB (コンタクトレコード属性セクションの最大サイズ) です。コンタクトの属性が 32 KB を上回ると、そのコンタクトは **[エラー]** ブランチにルーティングされます。対策として、次の選択肢を検討してください。
+ 不要な属性は値を空にして削除する。
+ 属性が 1 つのフローでのみ使用されていて、そのフローの外部 (例えば、Lambda や別のフロー) から参照する必要がない場合は、フロー属性を使用する。この方法なら、複数のフロー間で 32 KB 分の情報を無駄に保持する事態を避けられます。
## 設定のヒント
+ ユーザー定義の宛先キーを使用する場合は、任意の名前を付けることができますが、**\$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)」を参照してください。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** の 2 つのブランチがあります。
![\[設定された [コンタクト属性の設定] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-contact-attributes-configured.png)
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
+ [Amazon Connect に含まれる最初のコンタクトエクスペリエンスの着信フローのサンプル](sample-inbound-flow.md)
## シナリオ
このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [Amazon Connect で問い合わせ属性を参照する方法](how-to-reference-attributes.md)
# Amazon Connect のフローブロック: 顧客キューフローの設定
このトピックでは、顧客がキューに転送されたときに呼び出すフローを指定するためのフローブロックを定義します。
## 説明
+ 顧客がキューに転送されると、呼び出すフローを指定します。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
次の画像は、**[顧客キューフローの設定]** ブロックの **[プロパティ]** ページを示しています。
![\[[顧客キューフローの設定] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-customer-queue-properties.png)
属性の使用については、「[Amazon Connect で問い合わせ属性を使用する](connect-contact-attributes.md)」を参照してください。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** のブランチがあります。
![\[設定された [顧客キューフローの設定] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-customer-queue-configured.png)
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
+ [Amazon Connect のキューに入れられたコールバックフローのサンプル](sample-queued-callback.md)
# Amazon Connect のフローブロック: 切断フローの設定
このトピックでは、コンタクト中に通話が切断された場合に実行するフローを指定するためのフローブロックを定義します。
## 説明
+ 問い合わせ中の切断イベントの後で実行するフローを指定します。
切断イベントとは、次の場合です。
+ チャット、またはタスクが切断された。
+ フローアクションの結果として、タスクが切断された。
+ タスクの有効期限切れ。タスクは、有効期限タイマーが完了すると、自動的に切断されます。デフォルトは 7 日間で、タスクの有効期限は最大 90 日に設定できます。
切断イベントが発生すると、対応するフローが実行されます。
+ このブロックを使用する場合の例を次に示します。
+ 問い合わせ後調査を実施します。例えば、エージェントは、通話後調査のために電話を切らないでおくよう顧客に依頼します。エージェントが電話を切り、切断フローが実行されます。切断フローでは、[顧客の入力を取得する](get-customer-input.md) ブロックを使用して顧客に一連の質問をします。回答は、[AWS Lambda 関数](invoke-lambda-function-block.md) ブロックを使用して外部の顧客フィードバックデータベースにアップロードされます。顧客にお礼を伝え、顧客との通話が終了します。
問い合わせ後のアンケートの作成の詳細については、以下のブログを参照してください。[Amazon Connect と Amazon Lex を使用して、チャット後のアンケートを簡単に作成して視覚化する](https://aws.amazon.com/blogs/contact-center/easily-create-and-visualize-post-chat-surveys-with-amazon-connect-and-amazon-lex/)。また、「[Amazon Connect の問い合わせ調査ソリューションの構築](https://catalog.workshops.aws/amazon-connect-contact-survey/en-US)」というワークショップもぜひご覧くださ。
+ チャットシナリオでは、顧客がチャットに応答しなくなった場合は、このブロックを使用して、切断フローを実行して [待機](wait.md) ブロックを呼び出すか、会話を終了するかを決定します。
+ タスクが 7 日以内に完了しない可能性があるタスクシナリオでは、このブロックを使用して切断フローを実行し、タスクを再びキューに入れるか、フローアクションによって完了/[切断](disconnect-hang-up.md)するか決定します。
**ヒント**
顧客が切断すると、エージェントに音声プロンプトを再生したり、フローを呼び出したりすることはできません。顧客が切断すると、フローは終了し、エージェントはそのコンタクトのアフターコールワーク (ACW) を開始します。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ すべてのフロー
## プロパティ
次の画像は、**[切断フローの設定]** ブロックの **[プロパティ]** ページを示しています。
![\[[切断フローの設定] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-disconnect-flow-properties.png)
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** のブランチがあります。
![\[設定された [切断フローの設定] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-disconnect-flow-configured.png)
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
+ [Amazon Connect に含まれる最初のコンタクトエクスペリエンスの着信フローのサンプル](sample-inbound-flow.md)
## シナリオ
このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [チャットシナリオの例](web-and-mobile-chat.md#example-chat-scenario)
+ [Amazon Connect と Amazon Lex を使用して、チャット後のアンケートを簡単に作成して視覚化する](https://aws.amazon.com/blogs/contact-center/easily-create-and-visualize-post-chat-surveys-with-amazon-connect-and-amazon-lex/)
+ [Amazon Connect の問い合わせ調査ソリューションの構築](https://catalog.workshops.aws/amazon-connect-contact-survey/en-US)
# Amazon Connect のフローブロック: イベントフローの設定
このトピックでは、コンタクトとのやり取り中に実行するフローを指定するためのフローブロックを定義します。
## 説明
+ 問い合わせイベントの中に実行するフローを指定します。
+ 次のイベントがサポートされています。
+ **エージェント UI のデフォルトフロー**: 問い合わせがエージェントワークスペースに入ったときに呼び出されるフローを指定します。このイベントを使用して、このシナリオでエージェントに再生される[ステップバイステップ](step-by-step-guided-experiences.md)のガイドを設定できます。
+ **エージェント UI の接続解除フロー**:エージェントワークスペースで開いている問い合わせが終了したときに呼び出されるフローを指定します。このイベントを使用して、このシナリオでエージェントに再生される[ステップバイステップ](step-by-step-guided-experiences.md)のガイドを設定できます。
+ **コンタクト一時停止時フロー**: コンタクトが一時停止状態になった場合に呼び出されるフローを指定します。詳細については、「[Amazon Connect タスクでのタスクの一時停止と再開](concepts-pause-and-resume-tasks.md)」を参照してください。
+ **コンタクト再開時フロー**: コンタクトが一時停止状態から再開する場合に呼び出されるフローを指定します。詳細については、「[Amazon Connect タスクでのタスクの一時停止と再開](concepts-pause-and-resume-tasks.md)」を参照してください。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ すべてのフロー
## プロパティ
次の画像は、**[イベントフローの設定]** ブロックの **[プロパティ]** ページを示しています。
![\[[イベントフローの設定] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-event-flow-properties.png)
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** のブランチがあります。
![\[設定された [イベントフローの設定] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-event-flow-configured.png)
## シナリオ
このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [Amazon Connect でコンタクトの開始時にガイドを呼び出す](how-to-invoke-a-flow-sg.md)
# Amazon Connect のフローブロック: 保留フローの設定
このトピックでは、顧客またはエージェントが保留されたときに呼び出すフローを指定するためのフローブロックを定義します。
## 説明
+ あるフロータイプから別のフロータイプへのリンク。
+ 顧客またはエージェントとの通話を保留状態にしたときに呼び出すフローを指定します。
このブロックがチャット会話中にトリガーされた場合、コンタクトは **[エラー]** ブランチにルーティングされます。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | いいえ - エラーブランチ |
| タスク | いいえ - [エラー] ブランチ |
| E メール | いいえ - [エラー] ブランチ |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer Queue flow (顧客キューフロー)]
+ アウトバウンドウィスパーフロー
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
次の画像は、**[保留フローの設定]** ブロックの **[プロパティ]** ページを示しています。保留フローを動的に設定するために使用できる名前空間のドロップダウンリストを示しています。
![\[[保留フローの設定] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-hold-flow-properties.png)
属性の使用については、「[Amazon Connect で問い合わせ属性を使用する](connect-contact-attributes.md)」を参照してください。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** のブランチがあります。
![\[設定された [保留フローの設定] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-hold-flow-configured.png)
# Amazon Connect のフローブロック: ログ記録動作の設定
このトピックでは、コンタクトがフローとやり取りするときにフローログがイベントを追跡できるようにするフローブロックを定義します。
## 説明
+ フローのログを有効にして、コンタクトがフローとやり取りするときにイベントを追跡できるようにします。
+ フローログは に保存されます Amazon CloudWatch。詳細については、「[ロググループに保存されているフロー Amazon CloudWatch ログ](contact-flow-logs-stored-in-cloudwatch.md)」を参照してください。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ すべてのフロー
## プロパティ
次の画像は、**[ログ記録動作の設定]** ブロックの **[プロパティ]** ページを示しています。これには 2 つのオプションがあり、ロギング動作を有効にするか無効にするかです。
![\[[ログ記録動作の設定] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-logging-behavior-properties.png)
## シナリオ
フローログの詳細については、次のトピックを参照してください。
+ [フローログを使用して Amazon Connect フローのイベントを追跡する](about-contact-flow-logs.md)
# Amazon Connect のフローブロック: 記録と分析の動作の設定
**注記**
このブロックは、下位互換性のために既存のフローで引き続きサポートされていますが、新しいフローまたは変更[記録、分析、処理の動作を設定する](set-recording-analytics-processing-behavior.md)のために に置き換えられます。
このトピックでは、エージェントと顧客の音声の録音またはモニタリング、自動インタラクションの有効化、画面録画の有効化、コンタクトの分析動作の設定に関するオプションを設定するためのフローブロックを定義します。
## 説明
このブロックには多くの機能があります。
+ エージェント、顧客、またはその両方について、通話のどの部分を記録できるかを設定します。追加料金はかかりません。
+ 自動インタラクション通話録音を有効にして、顧客が IVR または会話型 AI ボットとどのようにやり取りしているかを聞くことができます。追加料金はかかりません。
+ 「[画面録画を有効にする](enable-sr.md)」で説明しているようにエージェント画面録画を設定している場合は、エージェントの画面録画を有効にすることができます。料金の詳細については、「[Amazon Connect の料金](https://aws.amazon.com/connect/pricing/)」を参照してください。
+ チャットおよび音声コンタクトの Contact Lens 分析設定を構成できます。料金の詳細については、「[Amazon Connect の料金](https://aws.amazon.com/connect/pricing/)」を参照してください。これには、以下が含まれます。
+ 顧客とエージェントがやり取りする言語 (音声テキストトランスクリプト生成を改善するため)
+ 機密データの秘匿化
+ 追加の Contact Lens 生成 AI 機能
+ コンタクトに対する Contact Lens 会話分析を有効にします。詳細については、「[会話分析を使用して会話を分析する](analyze-conversations.md)」を参照してください。
## コンタクトのタイプ
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | いいえ - [エラー] ブランチ |
| E メール | いいえ - [エラー] ブランチ |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
| フロータイプ | サポート対象? |
| --- | --- |
| 着信フロー | はい |
| 顧客保留フロー | いいえ |
| 顧客キューフロー | はい |
| 顧客ウィスパーフロー | いいえ |
| アウトバウンドウィスパーフロー | はい |
| エージェント保留フロー | いいえ |
| エージェントウィスパーフロー | いいえ |
| エージェントへの転送フロー | はい |
| キューへの転送フロー | はい |
**ヒント**
最も正確な動作を得るには、インバウンドまたはアウトバウンドのウィスパーフローで **[記録動作の設定]** ブロックを使用することをお勧めします。
このブロックをキューフローで使用した場合、通話が録音されるとは限りません。コンタクトがエージェントにつながった後で、このブロックが実行される可能性があるためです。
## このブロックの設定方法
**記録と分析の動作の設定**ブロックを設定するには、 Amazon Connect 管理者ウェブサイトを使用するか、Amazon Connect フロー言語で [UpdateContactRecordingBehavior](https://docs.aws.amazon.com/connect/latest/APIReference/contact-actions-updatecontactrecordingbehavior.html) アクションを使用します。
次の図は、 Amazon Connect 管理ウェブサイトの**「記録と分析の動作プロパティの設定**」ページを示しています。ページは、[記録と分析を有効にする] と [分析設定を構成する] の 2 つのセクションに分かれています。各セクションはサブセクションに分かれています。各サブセクションは展開と折りたたみが可能であり、概要がヘッダーに表示されます。
![\[[記録と分析の動作の設定] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-recording-behavior-properties.png)
### 記録と分析を有効にする
プロパティページのこのセクションでは、記録および関連する分析設定を構成します。
+ **音声**:
+ **エージェントとお客様の音声録音**: 録音する相手を選択します。
+ **Contact Lens 音声分析**: エージェントと顧客の録音で音声分析を使用するかどうかを選択します。
+ **自動インタラクション通話録音**: 顧客がボットやその他のオートメーションとやり取りしているときに音声録音を有効にするかどうかを選択します。
**注記**
**[コンタクトの詳細]** ページと Amazon Connect 分析ダッシュボードの一部として Lex ボットのトランスクリプトと分析を含めるには:
Amazon Connect コンソールで、インスタンスの名前を選択します。手順については、「[Amazon Connect インスタンス名の検索](find-instance-name.md)」を参照してください。
ナビゲーションペインで **[フロー]** を選択し、さらに **[Amazon Connect でボット分析とトランスクリプトを有効にする]** を選択します。
+ **画面**: エージェントの画面録画を有効または無効にします。詳細については、「[Amazon Connect Contact Lens でエージェントの画面録画を設定および確認する](agent-screen-recording.md)」を参照してください。
+ **チャット**: このオプションを使用して、Contact Lens の機能であるチャット分析を有効にします。詳細については、「[Amazon Connect Contact Lens 会話分析を有効にする](enable-analytics.md)」を参照してください。
### 分析設定を構成する
プロパティページのこのセクションは、Contact Lens 会話分析に適用されます。サポートされている言語、秘匿化、生成 AI 機能を指定します。特に指定がない限り、分析設定は音声とチャットの両方の Contact Lens 会話分析に適用されます。
+ **言語**: 顧客の言語に基づいて、出力ファイルの秘匿化を動的に有効にすることができます。手順については、「[顧客の言語に基づいた秘匿化を動的に有効にする](enable-analytics.md#dynamically-enable-analytics-contact-flow)」を参照してください。
+ **秘匿化**: 機密データを秘匿化するかどうかを選択します。詳細については、「[機密データの秘匿化を有効にする](enable-analytics.md#enable-redaction)」を参照してください。
+ **感情**: 感情分析を有効にするかどうかを選択します。
+ **Contact Lens 生成 AI 機能**: 詳細については、「[生成 AI を活用したコンタクト後の要約を表示する](view-generative-ai-contact-summaries.md)」を参照してください。
## 設定のヒント
+ フロー内の通話録音動作を変更できます。たとえば、「エージェントと顧客」から「エージェントのみ」に変更できます。以下のステップを実行します。
1. フローに 2 つ目の **[記録と分析の動作の設定]** ブロックを追加します。
1. エージェントと顧客の音声録音を **[オフ]** に設定するように、2 つ目のブロックを構成します。
1. **[記録と分析の動作の設定]** ブロックをもう 1 つ追加します。
1. 3 つ目のブロックを、**[エージェントのみ]** など、希望する新しい記録動作に設定します。
**注記**
**[分析]** セクションの設定は、フローの次の **[記録と分析の動作の設定]** ブロックによって上書きされます。
+ **通話の場合**: **[エージェントと顧客の音声録音に対する音声分析を有効にする]** を選択解除すると、Contact Lens 会話分析が無効になります。
たとえば、フローに **[記録と分析の動作の設定]** ブロックが 2 つあるとします。
+ 最初のブロックでは、選択したエージェントと顧客の音声録音に対するリアルタイムの音声分析を有効にしています。
+ フロー内の後続の 2 番目のブロックでは、それを選択解除しています。
この場合、分析が有効になっている間のみ分析が表示されます。
別の例: フロー内に **[記録と分析の動作を設定]** ブロックが 2 つあるとします。
+ 最初のブロックでは、**エージェントと顧客の音声録音に対する通話後音声分析を有効**にしています。
+ フロー内の後続の 2 番目のブロックでは、それを選択解除しています。
この場合、通話後分析は通話の終了時に行われ、最新の設定では分析が有効になっていないため、通話後分析は使用できません。
+ **自動インタラクション通話録音の場合**: 録音は、[オン] に設定されるとすぐに開始されます。フロー内の後半において 2 番目のブロックでオフに設定した場合、録音は一時停止されますが。後でオンにすることで録音を再開できます。
**注記**
[[電話番号への転送](transfer-to-phone-number.md)] ブロックを使用して通話を転送すると、録音は続行されます。
+ **チャットの場合**: フロー内のいずれかのブロックでリアルタイムチャットが有効になるとすぐに分析が開始されます。フローの後半でブロックを指定しないと、リアルタイムチャット設定が無効になります。
+ エージェントが顧客を保留状態にする場合、エージェントは記録されますが、その顧客は記録されません。
+ コンタクトを別のエージェントまたはキューに転送し、Contact Lens 会話分析を使用してデータを収集し続ける場合は、フローに別の **[記録動作の設定]** ブロックを追加し、**[分析の有効化]** をオンにする必要があります。これは、転送によって 2 番目のコンタクト ID とコンタクトレコードが生成されるためです。Contact Lens 会話分析は、そのコンタクトレコードでも実行する必要があります。
+ 会話分析を有効にすると、ブロックが含まれるフローのタイプ、ブロックが配置されているフロー内の場所によって、エージェントが主なハイライトのトランスクリプトを受け取る**かどうか**、また**そのタイミング**が決まります。
ブロックが主なハイライトでのエージェントのエクスペリエンスにどのような影響を与えるかについての詳細とユースケースについては、「[主なハイライトのフローを設計する](enable-analytics.md#call-summarization-agent)」を参照してください。
## 設定されているブロック
このブロックは、**[成功]** という 1 つの出力ブランチをサポートします。
次の画像は、音声および自動インタラクション録音の両方に対して **[記録と分析の動作を設定]** ブロックを設定し、音声分析と画面録画を有効にした場合の表示例を示しています。
![\[設定された [記録と分析の動作の設定] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-recording-and-analytics-behavior-configured.png)
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
+ [Amazon Connect に含まれる最初のコンタクトエクスペリエンスの着信フローのサンプル](sample-inbound-flow.md)
## シナリオ
このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [Amazon Connect でのコンタクトの記録のタイミング、内容、場所](about-recording-behavior.md)
+ [コンタクトの記録を有効にする](set-up-recordings.md)
+ [Amazon Connect で拡張マルチパーティーコンタクト モニタリングを有効にする](monitor-conversations.md)
+ [Amazon Connect を使用して、エージェントとお客様の間で録音された会話をレビューする](review-recorded-conversations.md)
+ [Amazon Connect でコンタクトセンターの過去の会話の確認に必要なアクセス許可を割り当てる](assign-permissions-to-review-recordings.md)
+ [Amazon Connect Contact Lens 会話分析を使用して会話を分析する](analyze-conversations.md)
# Amazon Connect のフローブロック: 記録、分析、処理の動作を設定する
このトピックでは、エージェントと顧客の記録動作の設定、自動インタラクションの有効化、画面記録の有効化、問い合わせの分析動作の設定、カスタム処理動作の設定のオプションを設定するためのフローブロックを定義します。
## 説明
このブロックの一部としてサポートされるアクションは 2 つあります。
+ **メッセージプロセッサの設定**\$1 - これにより、お客様は独自の Lambda プロセッサを設定できます。このプロセッサは、処理中のメッセージに適用されます。
+ **録音と分析の動作を設定する** - これにより、顧客は音声、チャット、E メールの問い合わせの録音と分析の動作と、画面録画の動作を設定できます。
\$1PDT では使用できません
![\[ブロックの Select アクションドロップダウンにある 2 つのアクションを示すアクションドロップダウン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-recording-analytics-processing-behavior-action-dropdown.png)
上記のスクリーンショットは、ブロックの「アクションの選択」ドロップダウンにある 2 つのアクションを示しています。
アクションを選択すると、それらの設定を構成するチャネルを選択できます。各アクションでサポートされているチャネルは次のとおりです。
| | チャットはサポートされていますか? | E メールがサポートされていますか? | サポートされているタスク | 音声はサポートされていますか? |
| --- | --- | --- | --- | --- |
| メッセージ処理の設定 | はい | なし | なし | いいえ |
| 記録と分析の動作の設定 | はい | はい | はい (画面録画動作のみ) | はい |
## フロータイプ
このブロックは、ジャーニーフローを除くすべてのフロータイプでサポートされています。
**ヒント**
最も正確な動作を得るには、このブロック**の記録設定**部分をインバウンドまたはアウトバウンドのウィスパーフローで使用することをお勧めします。
このブロックを他のフロータイプで使用すると、呼び出しが記録されるとは限りません。コンタクトがエージェントにつながった後で、このブロックが実行される可能性があるためです。
## このブロックの設定方法
**記録、分析、処理動作の設定**ブロックは、 Amazon Connect 管理ウェブサイトを使用して設定できます。このガイドでは、このブロックで各アクションを設定する方法について説明します。
### メッセージ処理の設定
次の図は、 ブロックに設定された**メッセージプロセッサの設定**アクションを示しています。このアクションは現在、次のドロップダウンで選択されているチャットチャネルタイプのみをサポートしています。ドロップダウンの後に、カスタム Lambda プロセッサを設定するためのいくつかの設定が続きます。
1. **処理を有効にする** - チャットメッセージ処理を開始するか停止するかを制御します。
1. **関数 ARN** - メッセージ処理を実行する Lambda 関数を定義します。この関数は、カスタムメッセージ処理と統合する必要があります。これを行うには、**CreateIntegrationAssociation** パブリック API を使用して、MESSAGE\$1PROCESSOR IntegrationType を使用します。ドキュメントは[こちらをご覧ください](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateIntegrationAssociation.html)。
1. **処理の失敗処理** - 処理が失敗した場合に元の未処理のメッセージを配信するかどうかを選択します。
![\[処理を有効にしてメッセージプロセッサアクション設定を設定する。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-recording-analytics-processing-behavior-message-processor-enabled.png)
次のスクリーンショットは、処理が無効になっている場合のブロック設定を示しています。
![\[処理が無効になっているメッセージプロセッサアクション設定を設定します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-recording-analytics-processing-behavior-message-processor-disabled.png)
### 記録と分析の動作の設定
次のガイドでは、 ブロックで**記録と分析の設定**アクションについて説明します。ブロックのこの部分には複数の設定があります。
+ エージェント、顧客、またはその両方について、通話のどの部分を記録できるかを設定します。追加料金はかかりません。
+ 自動インタラクション通話録音を有効にして、顧客が IVR または会話型 AI ボットとどのようにやり取りしているかを聞くことができます。追加料金はかかりません。
+ 「画面録画を有効にする」の説明に従ってエージェントの画面録画が設定されている場合、エージェントの[画面録画](https://docs.aws.amazon.com/connect/latest/adminguide/enable-sr.html)を有効にできます。料金の詳細については、「[Amazon Connect の料金](https://aws.amazon.com/connect/pricing/)」を参照してください。
+ 音声、チャット、E メールの連絡先Contact Lensの分析設定を構成できます。料金の詳細については、「[Amazon Connect の料金](https://aws.amazon.com/connect/pricing/)」を参照してください。これには、以下が含まれます。
+ 顧客とエージェントがやり取りする言語 (音声からテキストへの文字起こしの生成を改善）。
+ 機密データの秘匿化。
+ 追加のContact Lens生成 AI 機能。
このアクションにより、問い合わせのContact Lens会話分析が有効になります。詳細については、「[会話分析を使用して会話を分析する](analyze-conversations.md)」を参照してください。このアクションは現在、チャット、E メール、音声、タスクのメディアチャネルタイプをサポートしています。ただし、タスクでは、画面録画の動作のみを設定できます。したがって、このアクションのチャネルドロップダウンには、次のオプションが表示されます。
![\[チャット、E メール、画面録画、音声オプションを示すチャネルドロップダウン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-recording-analytics-processing-behavior-channel-dropdown.png)
**注記**
画面録画とチャネル録画または分析の両方を設定するには、録画、分析、および処理動作ブロックを 2 つの異なる順序で設定します。1 つは画面録画用、もう 1 つは音声録音用です。予期しない動作を避けるため、各ブロックは 1 つの記録タイプのみに設定する必要があります。
各チャネルの設定がどのようになっているかを説明します。
#### Chat
次の図に示すように、チャット設定は会話分析**の有効化**と**設定**の 2 つのセクションに分かれています。
![\[会話分析設定を示すチャットチャネル設定。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-recording-analytics-processing-behavior-chat-config.png)
会話分析を有効にすると、言語、秘匿化、AI 機能 (感情分析、インタラクションの概要) などの設定を行うことができます。
+ **言語**: 顧客の言語に基づいて、出力ファイルの秘匿化を動的に有効にすることができます。手順については、[「お客様の言語に基づいて編集を動的に有効にする](https://docs.aws.amazon.com/connect/latest/adminguide/enable-analytics.html#dynamically-enable-analytics-contact-flow)」を参照してください。
+ **会話分析の秘匿**化: 機密データを編集するかどうかを選択します。詳細については、「[機密データのリダクションを有効にする](https://docs.aws.amazon.com/connect/latest/adminguide/enable-analytics.html#enable-redaction)」を参照してください。
+ **処理中のリダクション**: 処理中のメッセージから機密データを編集するかどうかを選択します。詳細については、[「処理中の機密データの秘匿化とメッセージ処理を有効にする](https://docs.aws.amazon.com/connect/latest/adminguide/redaction-message-processing.html)」を参照してください。
+ **感情**: 感情分析を有効にするかどうかを選択します。
+ **Contact Lens 生成 AI 機能: 詳細については、**[「生成 AI を活用したコンタクト後の概要を表示する」を参照してください。](https://docs.aws.amazon.com/connect/latest/adminguide/view-generative-ai-contact-summaries.html)
#### E メール
次の図に示すように、E メールチャネルを選択すると、E メールコンタクトの会話分析を有効にして設定できます。E メールコンタクトは非同期であるため、音声とチャットに使用されるリアルタイムおよびコンタクト後のモデルに従うのではなく、E メールコンタクトを受信したときに分析が開始されます。
![\[会話分析設定を示す E メールチャネル設定。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-recording-analytics-processing-behavior-email-config.png)
E メール分析設定には以下が含まれます。
+ **言語**: E メールコンテンツの言語を選択します。問い合わせ属性を使用して言語を動的に設定できます。手順については、[「お客様の言語に基づいて編集を動的に有効にする](https://docs.aws.amazon.com/connect/latest/adminguide/enable-analytics.html#dynamically-enable-analytics-contact-flow)」を参照してください。
+ **会話分析の秘匿**化: E メールのトランスクリプトから、名前、住所、クレジットカード情報などの機密データを編集するかどうかを選択します。詳細については、「[機密データのリダクションを有効にする](https://docs.aws.amazon.com/connect/latest/adminguide/enable-analytics.html#enable-redaction)」を参照してください。
+ **Contact Lens Generative AI 機能**: E メールコンタクトのコンタクト概要を有効にします。詳細については、「[生成 AI を活用したコンタクト後の要約を表示する](https://docs.aws.amazon.com/connect/latest/adminguide/view-generative-ai-contact-summaries.html)」を参照してください。
**注記**
現時点では、感情分析は E メールコンタクトでは使用できません。
#### 音声
次の図に示すように、音声設定は録音**の有効化**、会話分析の**有効化**と**設定**の 3 つのセクションに分かれています。
![\[録音と分析の設定を示す音声チャネル設定。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-recording-analytics-processing-behavior-voice-config.png)
**記録設定:**
+ **エージェントとお客様の音声録音**: 録音する相手を選択します。
+ **Contact Lens 音声分析**: エージェントと顧客の録音で音声分析を使用するかどうかを選択します。
+ **自動インタラクション通話録音**: 顧客がボットやその他のオートメーションとやり取りしているときに音声録音を有効にするかどうかを選択します。
**設定:**
+ **言語**: 顧客の言語に基づいて、出力ファイルの秘匿化を動的に有効にすることができます。手順については、[「お客様の言語に基づいて編集を動的に有効にする](https://docs.aws.amazon.com/connect/latest/adminguide/enable-analytics.html#dynamically-enable-analytics-contact-flow)」を参照してください。
+ **会話分析の秘匿**化: 機密データを編集するかどうかを選択します。詳細については、「[機密データのリダクションを有効にする](https://docs.aws.amazon.com/connect/latest/adminguide/enable-analytics.html#enable-redaction)」を参照してください。
+ **感情**: 感情分析を有効にするかどうかを選択します。
+ **Contact Lens 生成 AI 機能: 詳細については、**[「生成 AI を活用したコンタクト後の概要を表示する」を参照してください。](https://docs.aws.amazon.com/connect/latest/adminguide/view-generative-ai-contact-summaries.html)
**注記**
**連絡先の詳細**ページと Amazon Connect 分析ダッシュボードの一部として Lex ボットのトランスクリプトと分析を含めるには:
Amazon Connect コンソールで、インスタンスの名前を選択します。手順については、[Amazon Connect インスタンス名の検索](https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-name.html)」を参照してください。
ナビゲーションペインで **[フロー]** を選択し、さらに **[Amazon Connect でボット分析とトランスクリプトを有効にする]** を選択します。
#### 画面録画
メディアチャネルではありませんが、これは ブロックのメディアチャネルドロップダウンにあります。エージェントの画面の録画を有効または無効にするように設定できます。詳細については、[Amazon Connect Contact Lens でのエージェントの画面録画の設定と確認](https://docs.aws.amazon.com/connect/latest/adminguide/agent-screen-recording.html)」を参照してください。
## 設定のヒント
**注記**
**[分析]** セクションの設定は、フローの次の **[記録と分析の動作の設定]** ブロックによって上書きされます。
+ **通話の場合**: **[エージェントと顧客の音声録音に対する音声分析を有効にする]** を選択解除すると、Contact Lens 会話分析が無効になります。
例えば、フローに**記録、分析、処理動作ブロックを 2 **つ設定するとします。
+ 最初のブロックでは、選択したエージェントと顧客の音声録音に対するリアルタイムの音声分析を有効にしています。
+ フロー内の後続の 2 番目のブロックでは、それを選択解除しています。
この場合、分析が有効になっている間のみ分析が表示されます。
もう 1 つの例: フローに**記録、分析、処理動作ブロックを 2 **つ設定するとします。
+ 最初のブロックでは、**エージェントと顧客の音声録音に対する通話後音声分析を有効**にしています。
+ フロー内の後続の 2 番目のブロックでは、それを選択解除しています。
この場合、通話後分析は通話の終了時に行われ、最新の設定では分析が有効になっていないため、通話後分析は使用できません。
+ **自動インタラクション通話録音**の場合: 録音は、**On **に設定されるとすぐに開始されます。フローの後半で、2 番目のブロックで**オフ**に設定されている場合、記録は一時停止され、後でオンにして記録を再開できます。
**注記**
[電話番号への転送](https://docs.aws.amazon.com/connect/latest/adminguide/transfer-to-phone-number.html)ブロックを使用して通話が転送されると、録音は続行されます。
+ **チャットの場合**: フロー内のいずれかのブロックでリアルタイムチャットが有効になるとすぐに分析が開始されます。フローの後半でブロックを指定しないと、リアルタイムチャット設定が無効になります。
+ エージェントが顧客を保留状態にする場合、エージェントは記録されますが、その顧客は記録されません。
+ 問い合わせを別のエージェントまたはキューに転送し、Contact Lens会話分析を使用してデータを収集し続ける場合は、**分析を有効に**して**記録、分析、処理動作の設定**ブロックをフローに追加する必要があります。これは、転送によって 2 番目のコンタクト ID とコンタクトレコードが生成されるためです。Contact Lens 会話分析は、そのコンタクトレコードでも実行する必要があります。
+ 会話分析****を有効にすると、ブロックが置かれているフローのタイプとフロー内の配置先によって、エージェントが主要なハイライトトランスクリプトを受け取る**かどうか**、いつ受け取る****かが決まります。
ブロックが主なハイライトに関するエージェントのエクスペリエンスにどのように影響するかを説明する詳細とユースケースの例については、[「主なハイライトのフローを設計](https://docs.aws.amazon.com/connect/latest/adminguide/enable-analytics.html#call-summarization-agent)する」を参照してください。
## 設定されているブロック
このブロックには、**成功**、**エラー**、**チャネルの不一致**の 3 つのブランチがあります。
問い合わせを開始するメディアチャネルが ブロックで選択されたメディアチャネルと同じでない場合、チャネル不一致ブランチが作成されます。画面録画の場合、このブランチは問い合わせが音声問い合わせでない場合に作成されます。
![\[4 つのブランチで記録および分析動作の設定アクションを示す、設定済みの記録、分析、処理動作の設定ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-recording-analytics-processing-behavior-configured-recording-action.png)
**記録と分析の動作の設定**がアクションとして選択され、**チャット**がメディアチャネルとして選択されている場合、**処理中の秘匿化設定と呼ばれる追加のブランチが失敗**します。このブランチは、処理中の秘匿化が停止または開始に失敗しても、他のすべての設定が正しく更新された場合に取得されます。
**メッセージプロセッサの設定**アクションを選択すると、ブロックには**成功**、**エラー**、**チャネルの不一致**の 3 つのブランチが表示されます。
![\[3 つのブランチを持つメッセージプロセッサの設定アクションを示す、設定済みの記録、分析、処理動作の設定ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-recording-analytics-processing-behavior-configured-message-processor.png)
# Amazon Connect のフローブロック: ルーティング条件の設定
このトピックでは、任意のチャネルのコンタクトを適切なキューにルーティングするためのフローブロックを定義します。
## 説明
コンタクトにルーティング条件を設定します。
+ ルーティング条件は、音声、チャット、タスク、E メールなど、任意のチャネルのコンタクトに対して設定できます。これにより、キュー内でコンタクトをどのようにルーティングするかを定義します。ルーティング条件とは、単一または複数のルーティングステップのシーケンスです。
+ ルーティングステップとは、このコンタクトをエージェントにルーティングするために満たす必要がある 1 つ以上の要件の組み合わせです。ルーティングステップごとにオプションの有効期間を設定できます。例えば、特定の有効期間中、ユーザー ID に基づいて特定のエージェントにのみこのコンタクトを提供するという要件でルーティングステップを作成できます。別の例として、**Language:English >= 4** および **Technology:AWS Kinesis >= 2** という要件で、有効期限のないルーティングステップを作成することもできます。
+ 要件とは、事前定義された属性名、その値、比較演算子、習熟度レベルを使用して作成された条件です。例えば、**Technology:AWS Kinesis >= 2** などです。
+ **[ルーティング条件の設定]** ブロックは **[キューへ転送]** ブロックと併用します。後者がコンタクトを Amazon Connect キューに転送し、コンタクトに指定されているルーティング条件を有効にするためです。
+ コンタクトに設定されたルーティング条件は、コンタクトがエージェントキューに転送された場合は有効になりません。詳細については、「[エージェントの習熟度に基づいて Amazon Connect でルーティングを設定する](proficiency-routing.md)」を参照してください。
+ 有効期限 (DurationInSeconds) の設定が短すぎると、最初のエージェントが通話を見逃したときに、Amazon Connect が次に熟練度の高いエージェントにコンタクトを適切にルーティングできなくなる可能性があります。デフォルトのキューベースのルーティングは、熟練度ベースのルーティングと競合するため、これら 2 つの方法間ではルーティング動作に一貫性がなくなる場合があります。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer queue flow (顧客キューフロー)]
+ エージェントへの転送フロー
+ キューへの転送フロー
## 事前定義された属性を使用してルーティング条件を設定するための前提条件
コンタクトにルーティング条件を設定する前に、以下のステップを完了しておく必要があります。
1. [コンタクトをエージェントにルーティングするための事前定義された属性を作成する](predefined-attributes.md) を作成します。
1. 以前に作成した事前定義された属性を使用した [Amazon Connect インスタンスのエージェントに習熟度を割り当てる](assign-proficiencies-to-agents.md)
## [ルーティング条件の設定] ブロックを使用するタイミング
コンタクトをエージェントに直接ルーティングする方法は 2 つあります。
+ **オプション 1: **[ルーティング条件の設定]** ブロックを使用して、エージェントを優先するルーティング条件を指定します**。このオプションは、以下の場合に適しています。
+ 複数のエージェントを同時にターゲットにしたい場合。例えば、主に顧客をサポートしている 4 人体制のサポートチームなどです。
+ 優先エージェントが対応できないときに、キュー内のより広範なエージェントのプールにフォールバックするオプションが必要な場合。
+ 標準キューのメトリクス内でコンタクトをレポートしたい場合。
このオプションを選択する利点は、エージェントの userID (janedoe など) を使用するため、ARN を使用するオプション 2 よりも設定が簡単であることです。
ルーティング条件の主な欠点は、キューメトリクス (SLA、キュー時間など) に影響を及ぼすことです。QueueA のコンタクトが Agent12 を特に待っている場合、他のエージェントが対応可能でも、コンタクトは対応されません。これは、定義された SLA に違反する可能性があります。この状況は、リアルタイムメトリクスレポートで確認できます。「[ワンクリックドリルダウンの使用](one-click-drill-downs.md)」を参照してください。
**注記**
ルーティングを設定し、タイムアウト設定を指定するときは、これらの影響に対応するために以上のシナリオに留意してください。
+ **オプション 2: エージェントのキューを使用します**。このオプションは通常、以下の場合に適しています。
+ コンタクトが、特定のエージェント**のみ**を対象としており、他は対象外である場合。
+ コンタクトを標準キューにレポートしたくない場合。標準キューとエージェントキューの詳細については、「[キュー: 標準およびエージェント](concepts-queues-standard-and-agent.md)」を参照してください。
これをセットアップする手順については、「[問い合わせをエージェントキューに転送する](transfer-to-agent.md)」を参照してください。
## ルーティング条件の仕組み
コンタクトを標準キューに転送すると、Amazon Connect は、コンタクトのルーティング条件で指定された最初のステップを有効にします。
1. エージェントは、コンタクトのアクティブなルーティングステップで指定された要件を満たしている場合にのみ、コンタクトに参加します。
1. ステップの有効期限が切れるまで該当するエージェントが見つからない場合、Amazon Connect はルーティング条件のいずれかが満たされるまで、ルーティング条件で指定された次のステップに進みます。
1. すべてのステップの有効期限が切れると、コンタクトは、ルーティングプロファイルにキューを持つ、最も長く対応可能なエージェントを提示されます。
**注記**
ルーティングステップで有効期限が指定されていない場合、ルーティングステップは期限切れになりません。
**ルーティング条件に使用できる項目:**
+ 以下から選択します。
+ ユーザー ID またはユーザー名に基づく 1 人以上の優先エージェント。
+ `AND` 条件を使用した最大 8 個の属性。
+ ルーティングステップでの最大 3 つの OR 条件。OR で区切られた要件ごとに、最大 8 つの属性を含めることができます。
+ 属性を動的に設定する場合にのみ OR を使用できます。詳細については、「[ルーティング条件を設定する方法](#set-routing-criteria-using-the-flow-block)」を参照してください。
+ NOT 演算子により、選択したレベルで熟練度を除外します。属性を動的に設定する場合にのみ NOT を使用できます。詳細については、「[ルーティング条件を設定する方法](#set-routing-criteria-using-the-flow-block)」を参照してください。
**注記**
ネストされた式はサポートされていますが、OR 式は最上位レベルに配置する必要があります。AND は OR 内に配置できますが、その逆はできません。
また、属性とルーティング条件では、次のことが前提となります。
+ 各属性に習熟度が割り当てられている必要があります。
+ 各熟練度レベルでは、「>=」比較演算子を使用するか、1～5 の範囲の熟練度レベルを使用する必要があります。
+ 条件の各ステップには、時間指定の期限タイマーが必要です。
+ 条件の最終ステップには、時間指定の期限タイマー、または無期限の期限タイマーを設定できます。
## ルーティング条件を設定する方法
必要なルーティング条件は、フローブロックの UI で手動で設定することも、[[AWS Lambda 関数](invoke-lambda-function-block.md)] ブロックの出力に基づいて動的に設定することもできます。
![\[[ルーティング条件の設定] のプロパティページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-routing-criteria-using-the-flow-block.png)
### ルーティング条件の手動設定
このオプションを使用して、**[ルーティング条件の設定]** ブロックで指定したコンタクトのルーティング条件を手動で設定できます。ドロップダウンリストから属性と値を選択して、事前定義された属性をルーティングステップに手動で追加している次のフローの例を参照してください。
![\[ルーティング条件フローブロックを手動で設定します。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-routing-criteria-set-manually.png)
このオプションでも、必要に応じて JSONPath 参照を使用して事前定義された属性を動的に設定できます。例えば、すべてのコンタクトの ``Technology`` 要件に基づいて `AWS DynamoDB` 値をハードコーディングする代わりに、``$.External.language`` JSONPath 参照を指定できます。JSONPath 参照の詳細については、「[Amazon Connect で使用可能なコンタクト属性とその JSONPath 参照のリスト](connect-attrib-list.md)」を参照してください。
### ルーティング条件を動的に設定する
**[AWS Lambda 関数を呼び出す]** ブロックからの出力に基づいて、コンタクトのルーティング条件を動的に設定できます。
+ [[AWS Lambda 関数](invoke-lambda-function-block.md)] ブロックで、ルーティング条件を JSON 形式で返し、レスポンスの検証を JSON として設定するように Lambda 関数を構成します。**[AWS Lambda 関数を呼び出す]** の使用方法の詳細については、「[AWS Lambda 関数へのアクセスを Amazon Connect に許可する](connect-lambda-functions.md)」ドキュメントを参照してください。
+ [`Set routing criteria`] ブロックで、**[動的に設定]** オプションを選択し、上記の Lambda 属性 (**[名前空間]** として `External`、**[キー]** として上記の Lambda の応答で指定したもの) を使用します。このキーは例えば、`MyRoutingCriteria` となります。これは、次のセクションの Lambda 応答のサンプルにあるルーティング条件を指しているためです。
### ルーティング条件を設定するサンプル Lambda 関数
次の Lambda の例では、`AndExpression` を使用してルーティング条件を返しています。
```
export const handler = async(event) => {
return {
"MyRoutingCriteria": {
"Steps": [
{
"Expression": {
"AndExpression": [
{
"AttributeCondition": {
"Name": "Language",
"Value": "English",
"ProficiencyLevel": 4,
"ComparisonOperator": "NumberGreaterOrEqualTo"
}
},
{
"AttributeCondition": {
"Name": "Technology",
"Value": "AWS Kinesis",
"ProficiencyLevel": 2,
"ComparisonOperator": "NumberGreaterOrEqualTo"
}
}
]
},
"Expiry": {
"DurationInSeconds": 30
}
},
{
"Expression": {
"AttributeCondition": {
"Name": "Language",
"Value": "English",
"ProficiencyLevel": 1,
"ComparisonOperator": "NumberGreaterOrEqualTo"
}
}
}
]
}
}
};
```
次の Lambda の例では、`OrExpression` を使用してルーティング条件を返しています。
```
export const handler = async(event) => {
return {
"MyRoutingCriteria": {
"Steps": [
{
"Expression": {
"OrExpression": [
{
"AttributeCondition": {
"Name": "Technology",
"Value": "AWS Kinesis Firehose",
"ProficiencyLevel": 2,
"ComparisonOperator": "NumberGreaterOrEqualTo"
}
},
{
"AttributeCondition": {
"Name": "Technology",
"Value": "AWS Kinesis",
"ProficiencyLevel": 2,
"ComparisonOperator": "NumberGreaterOrEqualTo"
}
}
]
},
"Expiry": {
"DurationInSeconds": 30
}
}
]
}
}
};
```
次の Lambda の例では、`NOTAttributeCondidtion` と熟練度レベルの範囲を使用してルーティング条件を返します。
```
export const handler = async(event) => {
const response = {
"MyRoutingCriteria": {
"Steps": [
{
"Expression": {
"NotAttributeCondition": {
"Name" : "Language",
"Value" : "English",
"ComparisonOperator": "Range",
"Range" : {
"MinProficiencyLevel": 4.0,
"MaxProficiencyLevel": 5.0
}
}
},
"Expiry" : {
"DurationInSeconds": 30
}
}
]
}
}
return response;
};
```
## ルーティングステップの各ステータスと必要である理由
1. **非アクティブ:** ルーティング条件が有効になると、最初のステップは直ちに非アクティブとなります。ルーティングエンジンは、有効期限タイマーに従って条件を一度に 1 ステップずつ実行します。
1. 前のステップが期限切れになるまで、すべてのステップは*非アクティブ*として開始されます。
1. **アクティブ:** 一致に対してステップがアクティブに実行されている場合、ステータスは [アクティブ] に設定されます。
1. **期限切れ:** Amazon Connect がステップの実行中にエージェントを検出せず、タイマーの期限が切れると、ルーティングエンジンは次のステップに進みます。前のステップは*期限切れ*とみなされます。
1. **参加しました:** 特定のステップでエージェントがコンタクトと一致すると、ステップのステータスは *[参加しました]* に設定されます。
1. **中断:** コンタクトが長時間待機している場合、またはオペレーションリーダーがフローを中断してルーティング条件を変更することを決定する可能性がある場合です。これは、例えば、タスクが 24 時間待機していて、マネージャーが条件を変更する場合など、特定のステップがアクティブな場合です。この場合、ステップのステータスは*中断*に設定されます。
1. **非アクティブ化:** 顧客が電話を切ったり、接続が切断されたりすると、ルーティングは停止します。
## ルーティング条件を使用して特定の優先エージェントをターゲットにする
ルーティング条件を使用して、事前定義された属性ではなくユーザー ID に基づいて、キュー内のコンタクトを 1 人の特定の優先エージェントまたは優先エージェントのセットに制限することもできます。
例えば、特定の顧客が最近コンタクトセンターに同じトピックについて問い合わせたことを確認した場合は、問題に最後に対応した同じエージェントに、この顧客をルーティングすることができます。これを行うには、ルーティングステップの有効期限が切れるまでの一定期間、その特定のエージェントをターゲットにするようにルーティングステップを設定することができます。
この機能の仕組みに関するよくある質問は、以下のとおりです。
**この機能を Customer Profiles の前回のエージェント識別子と組み合わせて使用して、問題に最後に対応したエージェントに顧客をルーティングすることはできますか?**
Amazon Connect Customer Profiles には、顧客が最後に接続したエージェントを識別する最後のエージェント識別子属性など、コンタクトレコードに基づいた 7 つの事前定義済みのデフォルト属性が用意されています。このデータを使用して、特定の顧客からの新しいコンタクトを、以前コンタクトに対応した同じエージェントにルーティングできます。これを行うには、まず Customer Profiles フローブロックを使用して、`Phone = $.CustomerEndpoint.Address` などの少なくとも 1 つの検索識別子を使用して顧客プロファイルを取得します。詳細については、「[プロパティ: プロファイルを取得](customer-profiles-block.md#customer-profiles-block-properties-get-profile)」を参照してください。
次に、**[ルーティング条件の設定]** ブロックの **[手動で設定]** オプションを使用して、特定のユーザー ID をハードコーディングする代わりに、各コンタクトを [`$.Customer.CalculatedAttributes._last_agent_id`] (JSONPath リファレンス) にルーティングするように指定し、最後のエージェントに各コンタクトをルーティングする期間を制限する有効期限タイマーを設定できます。JSONPath 参照の詳細については、「[Amazon Connect で使用可能なコンタクト属性とその JSONPath 参照のリスト](connect-attrib-list.md)」を参照してください。Amazon Connect Customer Profiles で利用可能なデフォルト属性の詳細については、「[Amazon Connect Customer Profiles のデフォルトの計算属性](customerprofiles-default-calculated-attributes.md)」を参照してください。
**優先エージェントが対応可能ではない場合、どうなりますか?**
特定の優先エージェントをターゲットにするルーティングステップが設定されている場合、ルーティングステップの有効期限が切れるまで、コンタクトはそのエージェントに制限されます。これは、以下とは関係ありません。
1. エージェントがオンラインかどうか
1. エージェントはオンラインだが、他のコンタクトに対応中で、現在追加のコンタクトをルーティングできない
1. エージェントはオンラインだが、カスタムの非稼働ステータスにある
1. エージェントはインスタンスから削除されている (userID は引き続き有効とみなされる）
例えば、特定のコンタクトをターゲットエージェントである Jane Doe に制限し、有効期限は 30 秒に設定されていて、Jane Doe が現在オフラインであるとします。その場合でも、コンタクトは 30 秒間 Jane Doe に制限され、その後、ルーティングステップの期限が切れると、キュー内の別の対応可能なエージェントにコンタクトをルーティングできます。
**1 つの優先エージェントステップ内でターゲットにできるエージェントの最大数を教えてください。**
最大 10 人のエージェントをターゲットにできます。
**優先エージェントに基づくルーティングステップと、事前定義された属性に基づくルーティングステップの両方を含むルーティング条件を作成できますか?**
はい。例えば、ステップ 1 で、特定の有効期限を持つカスタムのマッチング学習モデルによって最適なエージェントとして予測されたエージェントに基づいて、ユーザー ID で特定の優先エージェントにコンタクトをターゲットにし、ステップ 2 で、スペイン語の最低習熟度を要件とするなど、事前定義された属性に基づいてコンタクトをターゲットにする、2 ステップのルーティング条件を作成できます。
## シナリオ
このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [Amazon Connect で問い合わせ属性を参照する方法](how-to-reference-attributes.md)
# Amazon Connect のフローブロック: 音声 ID の設定
**注記**
サポート終了通知: 2026 年 5 月 20 日、 AWS は Amazon Connect Voice ID のサポートを終了します。2026 年 5 月 20 日以降、Amazon Connect コンソールの Voice ID にアクセスしたり、管理者ウェブサイトまたは問い合わせコントロールパネルの Voice ID Amazon Connect 機能にアクセスしたり、Voice ID リソースにアクセスしたりできなくなります。詳細については、「[Amazon Connect Voice ID のサポート終了](https://docs.aws.amazon.com/connect/latest/adminguide/amazonconnect-voiceid-end-of-support.html)」を参照してください。
このトピックでは、音声ストリーミングを有効にし、音声認証と不正検出のしきい値を設定するフローブロックを定義します。
## 説明
+ 音声ストリーミングを有効にし、ウォッチリスト内の音声認証と不正通話検出のためのしきい値を設定します。この機能の詳細については、「[Voice ID](voice-id.md)」を参照してください。
+ 通話がフローに接続されるとすぐに、その音声を Amazon Connect Voice ID に送信して通話者のを本人確認を行い、ウォッチリスト内の不正行為者と照合します。
+ 音声を適切にストリーミングするためには、**[Set Voice ID]** (Voice ID の設定) の前に [プロンプトの再生](play.md) ブロックを使用します。これを編集して、「ようこそ」などの簡単なメッセージを含めることができます。
+ **[Set Voice ID]** (Voice ID の設定) の後に [コンタクト属性の設定](set-contact-attributes.md) ブロックを使用して、通話者の顧客 ID を設定します。
`CustomerId` は、CRM からの顧客番号などです。CRM システムから発信者の一意の顧客 ID を取得するための Lambda 関数を作成できます。Voice ID は、この属性を発信者の `CustomerSpeakerId` として使用します。
`CustomerId` では、英数字値を使用できます。\$1 と - (アンダースコアとハイフン) の特殊文字のみがサポートされます。これは UUID にする必要はありません。詳細については、[Speaker](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_Speaker.html) データ型で「`CustomerSpeakerId`」を参照してください。
+ **[Set Voice ID]** (Voice ID の設定) の後に [Voice ID を確認する](check-voice-id.md) ブロックを使用して、登録チェック、認証、または不正検出の結果に基づいた分岐を行います。
+ フロー内での **[Set Voice ID]** (Voice ID の設定)、ならびに [Voice ID を確認する](check-voice-id.md) および [コンタクト属性の設定](set-contact-attributes.md) の使用方法については、[Amazon Connect での Voice ID の有効化の基本](enable-voiceid.md) の「[ステップ 2: 新しい Voice ID ドメインと暗号化キーを作成する](enable-voiceid.md#enable-voiceid-step2)」を参照してください。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | いいえ - エラーブランチ |
| タスク | いいえ - [エラー] ブランチ |
| E メール | いいえ - [エラー] ブランチ |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer queue flow (顧客キューフロー)]
+ [Customer whisper flow (顧客ウィスパーフロー)]
+ アウトバウンドウィスパーフロー
+ エージェントウィスパーフロー
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
次の画像は、**[音声 ID の設定]** ブロックの **[プロパティ]** ページを示しています。**[音声認証]** セクションを示しています。この例では、**[認証しきい値]** は 90 に設定されています。これは、推奨されるしきい値です。
![\[[音声 ID の設定] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-voice-id-properties.png)
### Voice ID のための音声ストリーミングを開始する
このオプションを選択すると、Amazon Connect は、顧客のチャンネルから Voice ID に対する音声のストリーミングを開始します。
このブロックは、フロー内の複数の場所に追加できます。ただし、**[Start streaming audio]** (音声ストリーミングの開始) が選択された後は、フローの後半にこの機能が無効な **[Set Voice ID]** (Voice ID の設定) ブロックが存在したとしても、これを無効にすることはできません。
### 音声認証
**認証しきい値**: Voice ID で、発信者の声紋と入力された ID に登録された声紋が比較されて、0～100 の認証スコアが生成されます。このスコアは、一致の信頼度を示します。発信者が認証されているかどうかを示すスコアのしきい値を設定できます。デフォルトのしきい値 90 で、ほとんどの場合、高いセキュリティが確保できます。
+ 認証スコアが設定されたしきい値を下回っている場合、Voice ID はコールを認証されていないものとして処理します。
+ 認証スコアが設定されたしきい値を超えている場合、Voice ID はコールを認証済みとして扱います。
例えば、体調不良の人が車内からモバイルデバイスで電話をかけた場合、認証スコアは、その人が健康で、静かな部屋から電話をかけたときよりもわずかに低くなります。偽者が呼び出しを行っている場合、認証スコアははるかに低くなります。
### 認証の応答時間
認証の応答時間を 5 ～ 10 秒に設定できます。これにより、Voice ID での認証分析の完了にかかる時間を調整できます。この値を下げると、精度は低くなりますが応答時間は速くなります。通話者があまり話さないケースで、セルフサービス IVR のオプションを使用している場合は、この時間を短縮できる場合があります。その後、通話をエージェントに転送する必要が生じた場合には、この時間を増やすことができます。
次の画像は、ブロックの [認証応答時間] セクションを示しています。応答時間は手動で 10 秒に設定されています。
![\[[音声 ID の設定] ブロックの [認証応答時間] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-voice-id-properties2.png)
**[Set dynamically]** (動的に設定) を選択し、特定の基準に基づいて認証のしきい値を設定します。例えば、顧客のメンバーシップレベル、または顧客が求めている取引の種類や情報に基づいて、しきい値を引き上げることができます。
### 不正検出
不正検出に設定したしきい値は、リスクの測定に使用されます。スコアがしきい値より高い場合は、高リスクとして報告されます。しきい値より低いスコアは、低リスクとして報告されます。しきい値を上げることで、誤って低リスクを判定する率が下がり (結果がより確実になり) ますが、逆に誤って高リスクを判定する率は増加します。
**[動的に設定]** を選択し、特定の基準に基づいて不正のしきい値を設定します。例えば、富裕層の顧客や、その顧客が求めている取引や情報の種類について、しきい値を下げることなどが考えられます。
![\[[音声 ID の設定] ブロックの [不正検出] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-voice-id-properties3a.png)
選択したウォッチリストは、音声セッションの評価時に使用されます。ドメインのデフォルトのウォッチリストを使用するには、**[デフォルトの監視リストを使用]** を選択します。**[手動で設定]** を選択する場合、ウォッチリストの ID は 22 文字の英数字にする必要があります。
ウォッチリストについても同様に、指定された基準に基づいてウォッチリストを設定するには、**[動的に設定]** を選択します。例えば、通話目的の取引のタイプや情報に基づいて、より厳密なウォッチリストを使用することができます。
## 設定のヒント
+ **認証しきい値**では、デフォルトの 90 から開始し、ビジネスに適切なバランスが得られるまで調整することをお勧めします。
デフォルトの90を超えて**認証しきい値**の値を増やすたびに、次のようなトレードオフがあります。
+ しきい値が高いほど、偽拒否率 (FRR) が高くなります。つまり、エージェントが顧客のアイデンティティを確認する必要がある可能性が高くなります。
例えば、95を超えるなど、設定値が高すぎると、エージェントはすべての顧客のアイデンティティを確認する必要があるようになります。
+ しきい値が低いほど、誤認率 (FAR) が高くなります。つまり、不正な通話者が試みるアクセスを、Voice ID が誤って受け付ける可能性が高くなります。
+ Voice ID は、その音声が登録済みの顧客に属していることを確認すると、[**認証済み**] のステータスを返します。返されたステータスに基づいて [Voice ID を確認する](check-voice-id.md) ブロックをフローのブランチに追加ます。
+ **[Fraud threshold]** (不正しきい値) は、デフォルトの 50 から開始し、ビジネスに適切なバランスが得られるまで調整することをお勧めします。
通話者のスコアがしきい値を上回っている場合は、その通話に高い不正のリスクがあることを示します。
+ **[不正ウォッチリスト]** については、フローの公開時に形式が検証されます。
+ ウォッチリストが動的に設定され、その形式が有効でない場合、コンタクトは **[音声 ID の設定]** ブロックの **[エラー]** ブランチにルーティングされます。
+ ウォッチリスト ID が手動または動的に設定され、有効な形式だが、そのウォッチリストをインスタンスの音声 ID ドメインで使用できない場合は、フローの後半で **[音声 ID を確認]** ブロックが使用された時点で、コンタクトが [Voice ID を確認する](check-voice-id.md) ブロックの **[エラー]** ブランチにルーティングされます。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** のブランチがあります。
![\[設定された [音声 ID の設定] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-voice-id-configured.png)
## 詳細情報
このブロックについては、次のトピックを参照してください。
+ [Amazon Connect で Voice ID によるリアルタイムの発信者認証を使用する](voice-id.md)
+ [Amazon Connect のフローブロック: 音声 ID を確認](check-voice-id.md)
+ [コンタクトコントロールパネル (CCP) の音声 ID に発信者を登録する](use-voiceid.md)
# Amazon Connect のフローブロック: 音声の設定
このトピックでは、コンタクトフローに使用するテキスト読み上げ (TTS) 言語と音声を設定するためのフローブロックを定義します。
## 説明
+ コンタクトフローで使用するテキスト読み上げ機能 (TTS) の言語と音声を設定します。
+ デフォルトの音声は、Joanna (会話的な発話スタイル) に設定されています。
+ **[発話スタイルを上書き]** を選択して、デフォルトの音声と他の音声を[ニューラル音声](https://docs.aws.amazon.com/polly/latest/dg/neural-voices.html)または[生成音声](https://docs.aws.amazon.com/polly/latest/dg/generative-voices.html)にすることができます。
+ ニューラル音声は、ピッチ、抑揚、イントネーション、テンポを改善することで、自動化された会話をよりリアルに聞こえるようにします。
+ サポートされているニューラル音声の一覧については、*Amazon Polly デベロッパーガイド*の「[Neural Voices](https://docs.aws.amazon.com/polly/latest/dg/neural-voices.html#neural-voicelist)」を参照してください。
+ 生成音声は、Amazon Polly を介して使用できる最も人間らしく、感情があり、適応性の高い会話音声です。
+ サポートされている生成音声の一覧については、「*Amazon Polly デベロッパーガイド*」の「[生成音声](https://docs.aws.amazon.com/polly/latest/dg/generative-voices.html#generative-voicelist)」を参照してください。
+ このブロックを実行すると、TTS 呼び出しは、選択したニューラル音声、標準音声、または生成音声に解決されます。
+ チャット会話中にこのブロックがトリガーされた場合、問い合わせは [**成功**] ブランチに移動します。チャット操作の感覚には影響しません。
+ 生成音声を使用すると、料金がかかります。料金の詳細については、「[Amazon Polly の料金詳細](https://aws.amazon.com/polly/pricing/)」を参照してください。
+ [次世代 Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/enable-nextgeneration-amazonconnect.html) にオンボーディングしている場合、生成音声は次世代 Amazon Connect の料金に含まれています。
**注記**
インスタンスを 2018 年 10 月より前に作成し、その後サービスリンクロール (SLR) に移行している場合、生成エンジンにアクセスするには、以下のカスタムアクセス許可をサービスロール (SR) に追加する必要があります。
```
{
"Sid": "AllowPollyActions",
"Effect": "Allow",
"Action": [
"polly:SynthesizeSpeech"
],
"Resource": [
"*"
]
}
```
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | いいえ - 成功ブランチ |
| タスク | いいえ - 成功ブランチ |
| E メール | いいえ - 成功ブランチ |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ すべてのフロー
## プロパティ
次の画像は、**[音声の設定]** ブロックの **[プロパティ]** ページを示しています。英語に設定され、音声はジョアンナ、スピーチスタイルは会話形式です。
![\[[音声の設定] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-voice-config-neural.png)
**ヒント**
ニューラル型の発話スタイルのみに対応し、標準型の発話スタイルには対応していない音声については、**[Override speaking style]** (発話スタイルの上書き) を自動的に選択します。選択を解除するオプションはありません。
言語、音声、エンジン、スタイルを動的に設定することもできます。ブロックを変更するときに従う必要がある設定がいくつかあります。
言語を動的に選択している場合は、音声も動的に選択する必要があります。
音声を動的に選択し、発話スタイルを上書きする場合は、エンジンとスタイルを動的に選択する必要があります。
音声またはエンジンが無効であるか、選択した音声が、選択したエンジンをサポートしていない場合は、[エラー] ブランチにルーティングされます。
言語コードは、**[言語属性を設定]** を選択した場合にのみ、フローアクションに渡されます。したがって、無効な言語コードはこのブロックの [エラー] ブランチにルーティングされませんが、Lex V2 ボットで使用すると、誤った動作が発生する可能性があります。
[エラー] ブランチの後に再生プロンプトを追加すると、音声として Joanna/標準がデフォルトで使用されます。
定義した発話スタイルが、定義した音声でサポートされていない場合は、**[なし]** 発話スタイルが使用されます。
## 設定
有効な言語コード、音声、サポートされているエンジンのリストについては、「Amazon Polly デベロッパーガイド」の「[利用可能な音声](https://docs.aws.amazon.com/polly/latest/dg/available-voices.html)」を参照してください。
**注記**
Amazon Connect は標準、ニューラル、生成エンジンをサポートしているため、標準、ニューラル、または生成のいずれかを値としてエンジンパラメータに渡すことができます。
言語属性を設定するには、特定の言語コード (en-US や ar-AE など) をパラメータに渡します。音声の場合は、音声の名前 (Joanna や Hala など) を渡すだけです。
Amazon Connect は、なし、会話型、またはニュースキャスターとして定義できる話し方もサポートしています。[ニュースキャスター] と [会話型] の両スタイルは、ニューラルエンジンの以下の音声で使用できます。
+ Matthew (en-US)
+ Joanna (en-US)
+ Lupe (es-US)
+ Amy (en-GB)
**注記**
エンジンを指定しない場合は、標準エンジンがデフォルトで使用されます。ただし、Ruth (en-US) などの一部の音声は標準エンジンをサポートしていません。これらの音声の場合は、サポートされているエンジンを指定する必要があります。指定しないと、Ruth は標準エンジンをサポートしていないため、オペレーションは失敗します。
次の表に、設定とその結果の例をいくつか示します。
**設定例**
| 言語コード | 音声 | エンジン | 発話スタイル | 結果 \$1 推論 |
| --- | --- | --- | --- | --- |
| en-US | Ruth | 該当なし | 該当なし | [エラー] ブランチ: エンジンが指定されていないため、デフォルトで標準になります。Ruth は標準エンジンをサポートしていないため、[エラー] ブランチにルーティングされます。 |
| en-US | Ruth | ニューラル | なし | [成功] ブランチ: Ruth はニューラルエンジンをサポートしています。 |
| en-US | Ruth | ニューラル | 会話型 | [成功] ブランチ: Ruth は会話型発話スタイルをサポートしていませんが、ブロックは [エラー] ブランチにルーティングされません。代わりに、音声が合成されている場合は、どの発話スタイルも使用されません。 |
| ar-AE | Ruth | ニューラル | なし | [成功] ブランチ: このブロックは言語コードの検証を行いません。音声のみが音声合成に使用されます。ただし、言語コードが正しくないと、Lex V2 ボットで使用したときに誤動作が発生する可能性があります。 |
## Amazon Lex V2 ボットを Amazon Connect で使用する
Amazon Lex V2 ボットを使用している場合、Amazon Connect の言語属性は、Lex ボットの構築に使用した言語モデルと一致している必要があります。これは Amazon Lex (クラシック) とは異なります。
+ [**音声**] で異なる言語モデル (en\$1AU、fr\$1FR、es\$1ES など) を使用して Amazon Lex V2 ボットを構築する場合は、次の図に示すように、その言語に対応する音声を選択し、[**言語属性を設定する**] チェックボックスを必ずオンにします。
+ Amazon Lex V2 ボットで en-US 音声を使用せず、かつ [**Set language attribute**] (言語属性を設定する) チェックボックスをオンにしない場合には、[顧客の入力を取得する](get-customer-input.md) ブロックでエラーが発生します。
+ 複数の言語を持つボット (例えば、en\$1AU や en\$1GB) の場合は、次の画像に示すように、いずれかの言語に対して **[言語属性の設定]** チェックボックスをオンにします。
![\[英語 (オーストラリア) に設定された [音声の設定] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-voice-config-neural-arrows.png)
## 設定のヒント
+ アメリカ英語 (en-US) の **Joanna** と **Matthew** のニューラル音声では、[ニュースキャスターの話し方](https://docs.aws.amazon.com/polly/latest/dg/ntts-speakingstyles.html)を指定することもできます。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** のブランチがあります。
![\[設定された [音声の設定] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-voice-configured.png)
## シナリオ
このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [Amazon Polly でフローブロックのプロンプトにテキスト読み上げを追加する](text-to-speech.md)
# Amazon Connect のフローブロック: ウィスパーフローの設定
このトピックでは、会話の開始時にチャットに表示される、または通話で指示されるメッセージまたはウィスパーのフローブロックを定義します。ウィスパーは、エージェントに顧客の名前を知らせたり、通話がトレーニング目的で記録されていることを顧客に知らせたりするなど、通話の参加者に関連情報を提供します。
## 説明
*ウィスパーフロー*は、顧客やエージェントが音声やチャットの会話に参加したときに体験する内容です。例:
+ エージェントと顧客が、**チャット**しているとします。エージェント向けのウィスパーでは、顧客の名前、顧客が入っているキューや、エージェントが話している相手がクラブメンバーであることなどを、テキスト表示でエージェントに知らせる場合があります。
+ エージェントと顧客が、**通話**しているとします。顧客ウィスパーでは、トレーニングの目的で通話が録音されていることを顧客に伝える場合や、クラブメンバーであることに感謝する場合があります。
+ エージェントと顧客が、**チャット**しているとします。問い合わせ属性を使用して、エージェントウィスパーフローは、会話に接続されているエージェントを記録します。この属性は、切断フローで使用され、エージェントと切断された後に顧客がフォローアップの質問をする場合、問い合わせを同じエージェントにルーティングします。
ウィスパーフローには、次の特徴があります。
+ これは、顧客かエージェントのどちらかが見聞きするだけの一方的な通話となります。
**ヒント**
チャットコンタクトの場合、アウトバウンドフローが実行されると、[[プロンプトの再生](play.md)] ブロックを使用できます。チャット会話でエージェントと顧客の両方にメッセージが表示されます。
+ パーソナライズされ、自動化されたインタラクションを作成するために使用できます。
+ これは、顧客とエージェントが接続されているときに実行されます。
音声会話の場合、**[ウィスパーフローの設定]** ブロックは、[デフォルトのエージェントウィスパーフロー](default-agent-whisper.md)や[顧客ウィスパーフロー](default-customer-whisper.md)より優先されます。これは、次の方法で行います。
+ 作成する別のウィスパーフローにリンクする。
-または-
+ ウィスパーフローの実行を無効にする。アウトバウンドキャンペーンの一環として、顧客が接続レイテンシーを感じないように、デフォルトのウィスパーフローを無効にすることができます。
**重要**
チャット会話にはデフォルトのウィスパーは含まれません。デフォルトのエージェントウィスパーまたは顧客ウィスパーを再生するためには、**[ウィスパーフローの設定]** ブロックを含める必要があります。手順については、「[チャット会話向けの Amazon Connect デフォルトのウィスパーフローを設定する](set-default-whisper-flow-for-chat.md)」を参照してください。
### ウィスパーフローの設定ブロックの仕組み
+ 着信会話 (音声またはチャット) の場合、**[ウィスパーフローの設定]** ブロックは、顧客またはエージェントが参加したときに再生されるウィスパーを指定します。
+ 発信音声通話の場合、顧客に再生されるウィスパーを指定します。
+ ウィスパーは一方向で、選択したウィスパーの種類に応じて、エージェントまたは顧客のどちらかだけに聞こえたり見えたりします。例えば、顧客ウィスパーが「この通話は録音されています」と話した場合、エージェントには聞こえません。
+ エージェントが問い合わせを受け付けた後 (自動受付または手動受付のいずれか)、ウィスパーフローがトリガーされます。エージェントウィスパーフローは最初に実行されます。それは、顧客がキューから取り出される前です。これが完了すると、顧客がキューから取り出され、顧客ウィスパーフローが実行されます。両方のフローは、エージェントと顧客が相互に話したりチャットしたりする前に、実行され完了します。
+ エージェント向けウィスパーの実行中にエージェントが切断された場合、顧客は別のエージェントに再ルーティングされるようにキューに残ります。
+ 顧客ウィスパーの実行中に顧客が切断された場合、問い合わせは終了します。
+ エージェント向けのウィスパーフローまたは顧客ウィスパーフローに、チャットがサポートしていないブロック (メディアストリーミングの[起動](start-media-streaming.md)/[停止](stop-media-streaming.md) や [音声の設定](set-voice.md) など) が含まれている場合、チャットはこれらのブロックをスキップし、エラーブランチをトリガーします。ただし、フローの進行を妨げることはありません。
+ ウィスパーフローは記録には現れません。
+ ウィスパーの長さは最大で 2 分までです。その後、その問い合わせないしエージェントは切断されます。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer Queue flow (顧客キューフロー)]
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
次の画像は、**[ウィスパーフローの設定]** ブロックの **[プロパティ]** ページを示しています。エージェントへのウィスパーが手動で **[デフォルトのエージェントウィスパー]** に設定されていることを示しています。ドロップダウンボックスを使用して、別のウィスパーフローを選択します。
![\[[ウィスパーフローの設定] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-whisper-flow-properties4.png)
フローの手動設定を選択した場合、**[フローを選択]** ボックスでは、**[エージェントウィスパー]** または **[顧客ウィスパー]** のタイプのフローのみを選択できます。
属性の使用については、「[Amazon Connect で問い合わせ属性を使用する](connect-contact-attributes.md)」を参照してください。
以前に設定したエージェントまたは顧客ウィスパーを無効にするには、**[エージェントウィスパーを無効化]** または **[顧客ウィスパーを無効化]** オプションを選択します。
## 設定のヒント
+ 単一のブロックでは、顧客ウィスパーまたはエージェントウィスパーのいずれかを設定できますが、両方を設定することはできません。その代わりに、複数の **[Set whisper flow]** (ウィスパーフローの設定) ブロックをフロー内で使用します。
+ 最大 1 つのエージェントウィスパーと顧客ウィスパーを再生できます。複数の **[ウィスパーフローの設定]** ブロックを使用する場合、タイプ (エージェントと顧客) ごとに最後に指定されたブロックが再生されます。
+ ウィスパーは、2 分以内に完了する必要があります。完了できない場合、その通話は確立される前に切断されます。
+ エージェントが、通話から強制的に切断される前に「接続中...」状態で固まっているように見える場合は、設定されたウィスパーフローが最大時間の 2 分に達していることを確認してください。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** のブランチがあります。
![\[設定された [ウィスパーフローの設定] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-whisper-flow-configured.png)
# Amazon Connect のフローブロック: 作業キューの設定
このトピックでは、**[キューへ転送]** が呼び出されたときにコンタクトを転送するキューを指定するためのフローブロックを定義します。
## 説明
+ このブロックは、[**キューへの転送**] を呼び出すときに使用されるキューを指定します。
+ 顧客キューフローで使用する場合を除いて、[**キューへ転送**] を呼び出す前にキューを指定する必要があります。これは、人員、キューの状態、稼働時間などの属性を確認するためのデフォルトのキューでもあります。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
次の画像は、**[作業キューの設定]** ブロックの **[プロパティ]** ページを示しています。**[BasicQueue]** に設定されています。
![\[[作業キューの設定] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-working-queue-properties.png)
以下のプロパティに注意してください。
+ **[By queue] (キュー別) > [Set dynamically] (動的に設定)**。キューを動的に設定するには、キュー名ではなく、キュー ID を指定する必要があります。キュー ID を確認するには、キューエディタでキューを開きます。キュー ID は、ブラウザのアドレスバーで `/queue` の後に表示される URL の最後の部分です。例えば、`aaaaaaaa-bbbb-cccc-dddd-111111111111`。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** のブランチがあります。
![\[設定された [作業キューの設定] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/set-working-queue-configured.png)
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
+ [Amazon Connect のキューの顧客フローのサンプル](sample-queue-customer.md)
+ [Amazon Connect のキュー設定フローのサンプル](sample-queue-configurations.md)
## シナリオ
このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [Amazon Connect でエージェント間転送を設定する](setup-agent-to-agent-transfers.md)
+ [Amazon Connect で問い合わせを特定のエージェントに転送する](transfer-to-agent.md)
# Amazon Connect のフローブロック: ビューを表示
このトピックでは、エージェントが一貫したカスタマーエクスペリエンスを提供するために役立つステップバイステップのワークフローガイドと、インタラクティブなカスタマーエクスペリエンスを実現するためのガイドを作成するフローブロックを定義します。
## 説明
+ このフローブロックを使用して、以下を行います。
+ Amazon Connect エージェントワークスペースを使用しているエージェント向けの[ステップバイステップガイド](step-by-step-guided-experiences.md)を作成します。これらのガイドは、一貫した方法でお客様と対話するための手順をワークフロー形式でエージェントに案内します。
+ チャットエクスペリエンス内で顧客から情報を収集するフォームを作成します。
+ **[ビューを表示]** ブロックを含むフローにコンタクトがルーティングされると、[[ビュー]](view-resources-sg.md) という UI ページがエージェントワークスペースまたは顧客のチャット UI 内にレンダリングされます。
## このブロックのユースケース
このフローブロックは、エージェントに次の手順を案内するように設計されています。
+ 予約、支払い管理、新規発注など、一般的なタスクをお客様のために実行する。
+ テンプレートに基づいてメールを送信し、返金リクエストが送信されたことをお客様に知らせる。メールの構造は常に同じですが、注文番号、返金額、支払い口座など、具体的な値は変更できます。これらの情報をエージェントが提供できるように、[ビューを表示] ブロックを設定できます。
+ 既存のエージェントワークスペースに新しい CRM エントリを作成する。コンタクト属性を使用して、顧客の名前や電話番号などの関連情報をフォームにあらかじめ入力します。
また、チャット会話内のステップを通じて顧客をガイドし、以下のための支援を行います。
+ クレジットカード情報を提供して支払いを行います。
+ ホームアドレスなどの PII 情報を指定してプロファイルを更新します。
+ 顧客アカウント ID を指定してアカウント情報を受け取ります。
## コンタクトのタイプ
**[ビューを表示]** ブロックは、音声、チャット、E メール、タスクなど、任意のコンタクトタイプから ([[イベントフローの設定](set-event-flow.md)] ブロックで) 開始されるガイドフローで使用できます。顧客にガイドを示す場合は、メインチャットフローで **[ビューを表示]** ブロックを直接使用できます。
| コンタクトのタイプ | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
| フロータイプ | サポート対象? |
| --- | --- |
| 着信フロー | はい |
| 顧客保留フロー | いいえ |
| 顧客ウィスパーフロー | いいえ |
| アウトバウンドウィスパーフロー | いいえ |
| エージェント保留フロー | いいえ |
| エージェントウィスパーフロー | いいえ |
| エージェントへの転送フロー | いいえ |
| キューへの転送フロー | いいえ |
## このブロックの設定方法
**Show view** ブロックを設定するには、 Amazon Connect 管理ウェブサイトを使用するか、Amazon Connect Flow 言語の [ShowView](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-showview.html) アクションを使用します。
**Topics**
+ [ビューリソースを選択する](#choose-viewresource)
+ [[手動で設定] オプションの使用方法](#view-setmanually)
+ [[動的に設定] オプションの使用方法](#view-setdynamically)
+ [[JSON を設定] オプションの使用方法](#show-view-block-example-json)
+ [このビューには機密データがあります](#showview-sensitive-data)
+ [フローブロックのブランチ](#showview-branches)
+ [追加の設定のヒント](#showview-tips)
+ [このブロックで生成されるデータ](#showview-data)
### ビューリソースを選択する
Amazon Connect には、エージェントのワークスペースを追加できる一連のビューが用意されています。**[表示]** ボックスでビューを指定します (下図を参照)。
![\[[ビューを表示] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/show-view-block-form.png)
これらの AWS マネージドビューの簡単な説明を次に示します。各ビューの詳細については、「[Amazon Connect でエージェントのワークスペースの AWS マネージドビューを設定する](view-resources-managed-view.md)」を参照してください。カスタマーマネージドビューもサポートされています。詳細については、「[Customer-managed views](https://d3irlmavjxd3d8.cloudfront.net/?path=/docs/customer-managed-views-customer-managed-views--page)」ドキュメントを参照してください。
+ **詳細ビュー**: エージェントに情報を表示し、実行できるアクションのリストを示します。[Detail] ビューの一般的なユースケースは、通話の開始時にエージェントにポップアップを表示することです。
+ **リストビュー**: 項目 (タイトルと説明) を並べたリスト形式で情報を表示します。項目は、アクションを割り当てられたリンクとして機能する場合もあります。オプションで、標準のバックナビゲーションと永続的なコンテキストヘッダーもサポートしています。
+ **フォームビュー**: 必要なデータを収集してバックエンドシステムに送信するための入力フィールドを顧客とエージェントに提示します。このビューは、ヘッダー付きの定義済みのセクションスタイルを持つ複数のセクションで構成されます。本体は、列またはグリッドレイアウト形式で配置されたさまざまな入力フィールドで構成されています。
+ **確認ビュー**: フォームの送信後やアクションの完了後に顧客とエージェントに表示するページです。この事前構築されたテンプレートでは、何が起こったかの概要、次のステップ、およびプロンプトを提供できます。[Confirmation] ビューでは、固定属性バー、アイコン/画像、見出し、小見出し、ホームに戻るナビゲーションボタンがサポートされています。
+ **カードビュー**: エージェントにコンタクトが表示されたときに、選択できるトピックのリストを提示して、顧客とエージェントをガイドできます。
**[ビューを表示]** ブロックのプロパティは、選択した**ビュー**リソースに応じて動的に読み込まれます。例えば、**[Form]** を選択した場合は、**[Next]** アクションと **[Previous]** アクションを設定するため、これらが表示されます。これらはビューのアクションのほんの一部です。
![\[[表示] が [Form] に設定され、[バージョン] は 1 に設定されています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/show-view-block-version2.png)
以降のセクションでは、**[Form]** アクションを手動で、動的に、または JSON オプションを使用して設定する方法について説明します。
### [手動で設定] オプションの使用方法
1. **[プロパティ]** ページの **[表示]** セクションで、ドロップダウンメニューから **[フォーム]** を選択し、**[バージョンを使う]** をデフォルトの [1] に設定します。次の図では、**[プロパティ]** ページでこれらのオプションが設定されています。
![\[[表示] が [Form] に設定され、[バージョン] は 1 に設定されています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/show-view-block-version1.png)
1. **[プロパティ]** ページには、[Form] ビューに基づいて一連のフィールドが表示されます。**[手動で設定]** を選択し、ビュー UI コンポーネントにレンダリングするテキストを入力します。次の図には、**[Next]** と **[Previous]** の UI コンポーネントが表示されています。コンポーネントの表示名は手動で **[Next]** と **[Previous]** に設定されています。この名前が、ステップバイステップガイドのレンダリング時にエージェントワークスペースに表示されます。
![\[[Next] と [Previous] の UI コンポーネントが手動で設定されています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/show-view-block-version2.png)
### [動的に設定] オプションの使用方法
1. **[プロパティ]** ページの **[表示]** セクションで、ドロップダウンメニューから **[フォーム]** を選択し、**[バージョンを使う]** をデフォルトの [1] に設定します。次の図では、**[プロパティ]** ページでこれらのオプションが設定されています。
![\[[表示] が [Form] に設定され、[バージョン] は 1 に設定されています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/show-view-block-version1.png)
1. **[プロパティ]** ページには、[Form] ビューに基づいて一連のフィールドが表示されます。**[Set dynamically]** (動的に設定) を選択します。**[名前空間]** ドロップダウンメニューで、コンタクト属性を選択し、キーを選択します。次の図の **[見出し]** は、ステップバイステップガイドに動的にレンダリングされ、顧客の姓を表示します。
![\[ビュー UI テンプレートの見出し。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/show-view-block-dynamic.png)
### [JSON を設定] オプションの使用方法
このセクションでは、**[JSON を設定]** オプションの使用方法の例を説明します。
1. [ビューを表示] ブロックの **[プロパティ]** ページの **[ビュー]** セクションで、ドロップダウンメニューから **[フォーム]** を選択し、**[バージョン]** をデフォルトの **[1]** に設定します。これらのオプションは、次の画像に示されています。
![\[[表示] が [Form] に設定され、[バージョン] は 1 に設定されています。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/show-view-block-version1.png)
1. **[Form]** ビューを選択した場合、ビューの入力スキーマが **[プロパティ]** ページに表示されます。スキーマには、**[Sections]**、**[AttributeBar]**、**[Back]**、**[Cancel]**、**[Edit]**、**[ErrorText]** の各セクションがあり、情報を追加できます。
1. 次の図には、**[AttributeBar]** パラメータと **[JSON を設定]** オプションが表示されています。貼り付けた JSON をすべて表示するには、ボックスの隅をクリックして下にプルダウンします。
![\[入力パラメータ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/show-view-block-json.png)
**ヒント**
JSON が無効な場合は、エラーをすべて修正してください。以下の画像は、カンマが余分にあるため発生したエラーメッセージの例を示しています。
![\[JSON が無効であるというエラーメッセージ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/show-view-block-json-invalid.png)
1. カスタムビューを選択するときは、**[JSON を設定]** オプションを使用して動的入力の値を設定することもできます。これを行う場合は、**[サンプルデータを適用]** を選択して、サンプルデータを含む JSON スキーマを入力として事前に設定できます。
実行時に入力される UI ビルダーの動的データ (\$1.Channel など) の動的[参照を設定](no-code-ui-builder-properties-dynamic-fields.md)してください。
次の画像は、**[サンプルデータを適用]** オプションを示しています。
![\[[ビューを表示] ブロックの [サンプルデータを適用] オプション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/apply-sample-data.png)
1. **[保存]** を選択して、準備ができたら公開してください。
次のコード例は、上記と同じ設定が、Flow 言語の [ShowView](https://docs.aws.amazon.com/connect/latest/APIReference/participant-actions-showview.html) アクションではどのように表現されるかを示しています。
```
{
"Parameters": {
"ViewResource": {
"Id": "arn:aws:connect:us-west-2:aws:view/form:1"
},
"InvocationTimeLimitSeconds": "2",
"ViewData": {
"Sections": "Sections",
"AttributeBar": [
{
"Label": "Example",
"Value": "Attribute"
},
{
"Label": "Example 2",
"Value": "Attribute 2"
},
{
"Label": "Example 3",
"Value": "Case 123456",
"LinkType": "case",
"ResourceId": "123456",
"Copyable":true
},
{
"Label": "Example 3",
"Value": "Case 123456",
"LinkType": "case",
"ResourceId": "https:example.com"
}
],
"Back": {
"Label": "Back"
},
"Cancel": {
"Label": "Cancel"
},
"Edit": "Edit",
"ErrorText": "ErrotText",
"Heading": "$.Customer.LastName",
"Next": "Next",
"Previous": "Previous",
"SubHeading": "$.Customer.FirstName",
"Wizard": {
"Heading": "Progress tracker",
"Selected": "Step Selected"
}
}
},
"Identifier": "53c6be8a-d01f-4dd4-97a5-a001174f7f66",
"Type": "ShowView",
"Transitions": {
"NextAction": "7c5ef809-544e-4b5f-894f-52f214d8d412",
"Conditions": [
{
"NextAction": "7c5ef809-544e-4b5f-894f-52f214d8d412",
"Condition": {
"Operator": "Equals",
"Operands": [
"Back"
]
}
},
{
"NextAction": "7c5ef809-544e-4b5f-894f-52f214d8d412",
"Condition": {
"Operator": "Equals",
"Operands": [
"Next"
]
}
},
{
"NextAction": "7c5ef809-544e-4b5f-894f-52f214d8d412",
"Condition": {
"Operator": "Equals",
"Operands": [
"Step"
]
}
}
],
"Errors": [
{
"NextAction": "b88349e3-3c54-4915-8ea0-818601cd2d03",
"ErrorType": "NoMatchingCondition"
},
{
"NextAction": "7c5ef809-544e-4b5f-894f-52f214d8d412",
"ErrorType": "NoMatchingError"
},
{
"NextAction": "b88349e3-3c54-4915-8ea0-818601cd2d03",
"ErrorType": "TimeLimitExceeded"
}
]
}
}
```
### このビューには機密データがあります
クレジットカードデータ、自宅の住所、その他のタイプの機密データを顧客から収集するときは、**[このビューには機密データがあります]** を有効にすることをお勧めします。このオプションを有効にすると、顧客から送信されたデータはトランスクリプトやコンタクトレコードに記録されず、エージェントに表示されることもありません (デフォルトの場合)。**[ログ記録動作の設定]** がコンタクトフローでオンになっている場合は、ログ記録をオフにして、顧客の機密データがフローログに含まれないようにします。
![\[機密データビューのチェックボックス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/show-view-block-form-sensitive-data.png)
**ヒント**
**[このビューには機密データがあります]** が有効になっている [ビューを表示] ブロック、Lambda 関数、およびプロンプトを使用して[フローモジュール](contact-flow-modules.md)を構築し、既存のインバウンドコンタクトフローに配置できる再利用可能な支払いエクスペリエンスモジュールを作成します。
### フローブロックのブランチ
次の図は、設定済みの **[ビューを表示]** ブロックの例を示しています。このブロックは条件分岐に対応しています。つまり、選択したビューによってブランチは異なります。また、**[エラー]** ブランチと **[タイムアウト]** ブランチにも対応しています。
![\[設定された [ビューを表示] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/show-view-block-sq-config.png)
+ 条件分岐: これらのブランチは、**[ビューを表示]** ブロックで選択されているビューによって決まります。上図では、ブロックが **[Form]** ビュー用に設定され、**[戻る]**、**[次へ]**、**[一致なし]** というアクションが表示されています。
+ この特定の設定では、チャットのコンタクトは、ランタイムにエージェントがビューでクリックした対象に応じて、**[戻る]** または **[次へ]** のブランチにルーティングされます。**[一致なし]** は、ユーザーがカスタムアクション値のあるアクションコンポーネントを持っている場合のみ可能です。
+ **エラー**: 実行に失敗した (エージェントワークスペースでビューをレンダリングできない、またはビューの出力アクションを取得できない) 場合は、**[エラー]** ブランチに分岐します。
+ **タイムアウト**: ステップバイステップガイドのこのステップをエージェントが完了するまでの所要時間を指定します。[タイムアウト] の指定値よりもステップの完了に時間がかかった場合 (例えば、指定された時間内にエージェントが必要な情報を提供しなかった場合)、そのステップは [タイムアウト] ブランチに分岐します。
ステップがタイムアウトすると、ステップバイステップガイドはフローで定義されたロジックに従って次のステップを判定します。例えば、次のステップとして、あらためて情報の提示を求める、ガイドエクスペリエンスを停止するなどが考えられます。
この時点でお客様はエージェントとつながっているため、タイムアウトによるカスタマーエクスペリエンスの変化はありません。
### 追加の設定のヒント
このログ記録設定、このブロック、および Lambda を使用してフローモジュールを構築し、ログ記録をオフにしたままで、既存のインバウンドフローに配置できる再利用可能な支払いエクスペリエンスモジュールを作成します。
次のセキュリティプロファイル権限をエージェントに割り当ててください。エージェントがステップバイステップガイドを使用できるようになります。
+ **エージェントアプリケーション - カスタムビュー - すべて**: この権限を割り当てられたエージェントは、各自のエージェントワークスペースでステップバイステップガイドを見ることができます。
次のセキュリティプロファイル権限をマネージャーとビジネスアナリストに割り当ててください。これらの担当者がステップバイステップガイドを作成できるようになります。
+ **チャネルとフロー - ビュー**: この権限を割り当てられたマネージャーは、ステップバイステップガイドを作成できます。
既存のセキュリティプロファイルにアクセス許可を追加する方法については、「[Amazon Connect でセキュリティプロファイルを更新する](update-security-profiles.md)」を参照してください。
### このブロックで生成されるデータ
ランタイムに、**[ビューを表示]** ブロックは、ビューリソースの実行時に出力されるデータを生成します。ビューは主に次の 2 つのデータを生成します。
+ レンダリングされたビュー UI (エージェントワークスペース上) で実行された `Action` と、`Output` データである `ViewResultData`。
**[ビューを表示]** ブロックを使用する場合、**[アクション]** はブランチを表し、Views 名前空間の下位の `$.Views.Action` コンタクト属性に設定されます。
+ `Output` データは Views 名前空間の下位の `$.Views.ViewResultData` コンタクト属性に設定されます。
`Action` の値と `Output` データは、エージェントがビューリソースの使用中にやり取りしたコンポーネントによって決まります。
#### フローの各部でこのデータを使用する方法
+ ブロックはライアントアプリケーションからレスポンスを受け取ると、出力データをフローで参照するため、` `$.Views.Action` と `$.Views.ViewResultData` を使用します。
+ **[ビューを表示]** ブロックでビューを使用する場合、`Action` は Views 名前空間の下位のコンタクト属性 `$.Views.Action` で取得されたブランチを表し、ビューの出力データは `$.Views.ViewResultData` コンタクト属性に設定されます。
+ **[ビューを表示]** ブロックで生成されたデータを参照するには、コンタクト属性で JSON パスを使用するか ([手動で設定] または [JSON を設定] オプションでコンタクト属性を指定可能)、**[動的に設定]** を選択した場合は属性セレクターのドロップダウンを使用します。
## エラーシナリオ
**注記**
`ShowView` ブロックがエラーブランチ (一致なし、タイムアウト、エラー) に進んだ場合、フローをフロー内の前のポイントにルーティングできます。このようなループをフローに作成した場合、チャットコンタクトがタイムアウトするまで、コンタクトフローは無限に実行できます。`Loop` コンタクトフローブロックを使用して、特定の `ShowView` ブロックの再試行回数を制限することをお勧めします。
コンタクトは、次の状況で **[エラー]** ブランチへルーティングされます。
+ Amazon Connect は、エージェントワークスペースの View UI コンポーネントでユーザーアクションをキャプチャできません。この場合、断続的なネットワークの問題か、メディアサービス側の問題が原因として考えられます。
## フローログのエントリ
Amazon Connect フローログには、お客様との対話中にフローのイベントに関する詳細がリアルタイムで記録されます。詳細については、「[フローログを使用して Amazon Connect フローのイベントを追跡する](about-contact-flow-logs.md)」を参照してください。
ShowView の入力例 (入力ログ)
```
{
"ContactId": "string",
"ContactFlowId": "string",
"ContactFlowName": "string",
"ContactFlowModuleType": "ShowView",
"Timestamp": "2023-06-06T16:08:26.945Z",
"Parameters": {
"Parameters": {
"Cards": [
{
"Summary": {
"Id": "See",
"Heading": "See cancel options"
}
},
{
"Summary": {
"Id": "Change",
"Heading": "Change Booking"
}
},
{
"Summary": {
"Id": "Get",
"Heading": "Get Refund Status"
}
},
{
"Summary": {
"Id": "Manage",
"Heading": "Manage rewards"
}
}
],
"NoMatchFound": {
"Label": "Do Something Else",
"type": "bubble"
}
},
"TimeLimit": "300",
"ViewResourceId": "cards"
}
}
```
ShowView の出力例 (出力ログ)
```
{
"Results": "string",
"ContactId": "string",
"ContactFlowId": "string",
"ContactFlowName": "string",
"ContactFlowModuleType": "ShowView",
"Timestamp": "2023-06-06T16:08:35.201Z"
}
```
## サンプルフロー
ブログ「[Getting started with step-by-step guides](https://aws.amazon.com/blogs/contact-center/getting-started-with-step-by-step-guides-for-the-amazon-connect-agent-workspace/)」のステップ 2 からサンプルフローをダウンロードできます。このブログの手順を実行して、 AWSマネージドビューが設定されたフローの作成方法や、インバウンドのメディアコンタクトに対してこれらのフローを実行する方法を学ぶことをお勧めします。
## その他のリソース
ステップバイステップガイドとビューの詳細については、以下のトピックを参照してください。
+ [Amazon Connect エージェントワークスペースを設定するためのステップバイステップガイド](step-by-step-guided-experiences.md)
+ [Amazon Connect チャットで機密データ収集を実装する方法について説明します](https://aws.amazon.com/blogs/contact-center/collecting-sensitive-information-with-amazon-connect-chat/)。
+ 顧客管理ビューを設定するステップバイステップの手順については、「[Customer-managed Views](https://d3irlmavjxd3d8.cloudfront.net/?path=/docs/customer-managed-views-customer-managed-views--page)」を参照してください。
+ インスタンスにプラグアンドプレイのステップバイステップガイドエクスペリエンスを設定する方法については、「[Getting started with step-by-step guides](https://aws.amazon.com/blogs/contact-center/getting-started-with-step-by-step-guides-for-the-amazon-connect-agent-workspace/)」を参照してください。
+ [AWS-managed Views - Common Configuration](https://d3irlmavjxd3d8.cloudfront.net/?path=/story/aws-managed-views-common-configuration--page)
+ [Views - UI Components](https://d3irlmavjxd3d8.cloudfront.net/?path=/story/ui-component-ui-components--page)
+ 「Amazon Connect API リファレンス**」の「[View actions](https://docs.aws.amazon.com/connect/latest/APIReference/view-api.html)」
# Amazon Connect のフローブロック: メディアストリーミングの開始
このトピックでは、問い合わせ中に顧客が聞き、発言した内容を取得するためのフローブロックを定義します。その後、この情報を分析して、顧客の感情をトレーニングまたは判断できます。
## 説明
問い合わせ中に顧客が聞き、発言した内容を取得します。その後、音声ストリームの解析を実行して、次の操作を実行できます。
+ 顧客の感情を決定します。
+ トレーニングの目的で音声を使用します。
+ 不正な発信者を特定し、フラグを付けます。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | いいえ - エラーブランチ |
| タスク | いいえ - [エラー] ブランチ |
| E メール | いいえ - [エラー] ブランチ |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ 顧客キューフロー
+ エージェントウィスパーフロー
+ [Customer Whisper flow (顧客ウィスパーフロー)]
+ アウトバウンドウィスパーフロー
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
次の画像は、**[メディアストリーミングの開始]** ブロックの **[プロパティ]** ページを示しています。これには、顧客からストリームを開始するか、顧客へのストリームを開始するかの 2 つのオプションがあります。
![\[[メディアストリーミングの開始] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/start-media-streaming.png)
## 設定のヒント
+ 顧客の音声を正しく取得するには、インスタンスのライブメディアストリーミングを有効にする必要があります。手順については、「[Amazon Connect で顧客音声のライブメディアストリーミングを設定する](customer-voice-streams.md)」を参照してください。
+ 顧客の音声は、コンタクトが別のフローに渡された場合でも、**[メディアストリーミングの停止]** ブロックが呼び出されるまでキャプチャされます。
+ メディアストリーミングを停止するには、**[メディアストリーミングの停止]** ブロックを使用する必要があります。
+ このブロックがチャット会話中にトリガーされた場合、コンタクトは **[エラー]** ブランチにルーティングされます。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** のブランチがあります。
![\[設定された [メディアストリーミングの開始] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/start-media-streaming-configured.png)
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
[Amazon Connect でライブメディアストリーミングをテストするためのフローの例](use-media-streams-blocks.md)
# Amazon Connect のフローブロック: メディアストリーミングの停止
このトピックでは、顧客の音声のキャプチャを停止するフローブロックを定義します。
## 説明
+ **[メディアストリーミングの開始]** ブロックで開始されたら、顧客の音声のキャプチャは停止されます。
+ メディアストリーミングを停止するには、**[メディアストリーミングの停止]** ブロックを使用する必要があります。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | いいえ - エラーブランチ |
| タスク | いいえ - [エラー] ブランチ |
| E メール | いいえ - [エラー] ブランチ |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer Queue flow (顧客キューフロー)]
+ [Customer Whisper flow (顧客ウィスパーフロー)]
+ アウトバウンドウィスパーフロー
+ エージェントウィスパーフロー
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
このブロックにはプロパティがありません。
## 設定のヒント
+ 顧客の音声を正しく取得するには、インスタンスのライブメディアストリーミングを有効にする必要があります。手順については、「[Amazon Connect で顧客音声のライブメディアストリーミングを設定する](customer-voice-streams.md)」を参照してください。
+ 顧客の音声は、問い合わせが別のフローに渡された場合でも、**[Stop media streaming]** (メディアストリーミングの停止) ブロックが呼び出されるまでキャプチャされます。
+ このブロックがチャット会話中にトリガーされた場合、コンタクトは **[エラー]** ブランチにルーティングされます。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[成功]** と **[エラー]** のブランチがあります。
![\[設定された [メディアストリーミングの停止] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/stop-media-streaming-configured.png)
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
[Amazon Connect でライブメディアストリーミングをテストするためのフローの例](use-media-streams-blocks.md)
# Amazon Connect のフローブロック: 顧客の入力の保存
このトピックでは、入力をコンタクト属性として保存し、暗号化するフローブロックを定義します。
## 説明
このブロックは [**顧客の入力を取得する**] に似ていますが、このブロックは入力を ([[保存された顧客の入力](connect-attrib-list.md#attribs-system-table)] システム属性の中の) 問い合わせ属性として保存し、暗号化できます。この方法で、クレジットカード番号などの機密性の高い入力を暗号化できます。このブロック:
+ 顧客からの応答を得るためのプロンプトを再生します。例えば、「クレジットカード番号を入力してください」または「コールバックする際に使用する電話番号を入力してください」です。
+ 顧客が応答する、interruptible オプションを設定したオーディオプロンプト、またはテキスト読み上げを再生します。
+ [[保存された顧客の入力](connect-attrib-list.md#attribs-system-table)] システム属性に従って、数値入力を保存します。
+ 終了のカスタムキー設定を指定できます。
+ 通話中に顧客が何も入力しなかった場合、問い合わせは [**成功ブランチ**] というブランチに Timeout 値とともにルーティングされます。[**問い合わせ属性を確認する**] ブロックを追加して、タイムアウトをチェックします。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | いいえ - エラーブランチ |
| タスク | いいえ - [エラー] ブランチ |
| E メール | いいえ - [エラー] ブランチ |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer Queue flow (顧客キューフロー)]
+ アウトバウンドウィスパーフロー
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
次の画像は、**[顧客の入力の保存]** ブロックの **[プロパティ]** ページを示しています。**[プロンプト]** セクションが **[音声プロンプト]** を再生するように設定されていることを示しています。
Amazon Connect ライブラリまたは S3 バケットからのプロンプトの選択については、[プロンプトの再生](play.md) ブロックを参照してください。
![\[[顧客の入力の保存] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/store-customer-input-properties1.png)
次の画像は、ページの **[お客様の入力]** セクションを示しています。最大 20 桁まで入力できるように設定されています。
![\[[プロパティ] ページの [顧客の入力] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/store-customer-input-properties1b.png)
以下のプロパティに注意してください。
+ [**最大桁数**]: 顧客が入力できる最大桁数を定義します。
+ [**Phone number (電話番号)**]: このオプションは、キューに追加済みのコールバックのシナリオに役立ちます。
+ [**ローカル形式**]: すべての顧客がインスタンスと同じ国から電話をかける場合は、ドロップダウンリストからその国を選択します。これにより、Amazon Connect により国コードが自動入力されるため、顧客が国コードを入力する必要はありません。
+ [**国際形式**]: 別の国から通話する顧客がいる場合は、[**国際形式**] を選択します。この場合、Amazon Connectで、顧客が国コードを入力する必要があります。
次の画像は、ページの **[入力の設定]** セクションを示しています。最初の入力までの時間が 15 秒を超えるとタイムアウトし、以降は入力間の時間が 3 秒を超えるとタイムアウトするように設定されています。
![\[[プロパティ] ページの [入力の設定] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/store-customer-input-properties2b.png)
以下のプロパティに注意してください。
+ **最初のエントリ前のタイムアウト**: お客様が音声または DTMF で応答の入力を開始するまでに待機する時間を指定します。例えば、顧客にクレジットカードを準備する時間を与えるための時間として 20 秒を入力できます。
+ **各エントリ間のタイムアウト**: 音声または DTMF による顧客からの次の入力桁を待機する時間を指定します。例えば、このフィールドを 10 秒に設定したとします。顧客のクレジットカード番号を収集する場合、顧客がカード番号の最初の桁を入力してから次の桁を入力するまで、Amazon Connect は最大 10 秒待ちます。次の桁を入力するまでの時間が 10 秒を超えると、Amazon Connect は入力が完了またはタイムアウトしたと見なします。デフォルトでは、Amazon Connect は桁ごとに 5 秒待機します。
+ 最小値: 1 秒
+ 最大値: 20 秒
+ [**エントリを暗号化する**]:クレジットカード情報などの顧客の入力を暗号化します。
+ [**Specify terminating keypress (終了のキー設定の指定)**]: 顧客が DTMF の入力を完了したときに使用する終了のカスタムキー設定を定義します。終了のキー設定は、\$1 だけではなく、\$1、\$1、0～9 の文字で最大 5 桁まで指定できます。
**注記**
終了のキー設定の一部として米印 (\$1) を使用するには、[**Disable cancel key (キャンセルキーの無効化)**] もオンにする必要があります。
+ [**Disable cancel key (キャンセルキーの無効化)**]: デフォルトでは、顧客が \$1 を入力すると、その前のすべての DTMF の入力が削除されます。ただし、[**キャンセルキーを無効にする**] チェックボックスをオンにすると、Amazon Connect は **\$1** を他のキーと同じように扱います。
DMTF の入力を [[AWS Lambda 関数](invoke-lambda-function-block.md)] ブロックに渡す場合、[**Disable cancel key (キャンセルキーの無効化)**] プロパティは次のように入力に影響します。
+ **[キャンセルキーを無効にする]** を選択すると、入力したすべての文字 (\$1 を含む) が **[AWS Lambda 関数**] ブロックに送信されます。
+ **[キャンセルキーを無効にする]** を選択しないと、\$1 のみが **[AWS Lambda 関数**] ブロックに送信されます。
例えば、[**Disable cancel key (キャンセルキーの無効化)**] をオンにして、顧客が「*1\$12\$13\$14\$1\$1\$1*」と入力し、「*\$1\$1*」が終了のキー設定であったとします。この場合、**[AWS Lambda 関数]** ブロックは *1\$12\$13\$14\$1* 全体を入力として受け取ります。Lambda 関数を、\$1 の前の文字を無視するようにプログラムすることもできます。そうすると、顧客の入力は「*1\$12\$14\$1*」と解釈されます。
## DTMF 入力に問題がある場合
例えば、顧客からの DTMF 入力をキャプチャする 2 つの問い合わせフローを含む次のシナリオがあるとします。
1. 1 つのコンタクトフローでは **[顧客の入力を取得する]** ブロックを使用して、顧客から DTMF 入力を要求します。
1. DTMF 入力を入力すると、DTMF 入力は [**フローへの転送**] ブロックを使用して、問い合わせを次の問い合わせフローに移動します。
1. 次のコンタクトフローでは、**[顧客の入力を保存する]** ブロックを使用して、顧客からより多くの DTMF 入力を取得します。
最初のフローと 2 番目のフローの間には設定時間があります。このため、顧客が 2 番目のフローに対して非常に速く DTMF 入力を入力すると、一部の DTMF の桁が削除される可能性があります。
例えば、顧客は 5 を押し、2 番目のフローからのプロンプトを待ってから「123」と入力する必要があります。この場合、123 は問題なくキャプチャされます。しかし、プロンプトを待たずに非常に速く「5123」と入力すると、[**顧客の入力を保存する**] ブロックは 23 または 3 しかキャプチャできない可能性があります。
2 番目の問い合わせフローで [**顧客の入力を保存する**] ブロックですべての桁が確実に取得されるようにするには、顧客はプロンプトが再生されるのを待ってから、DTMF を入力する必要があります。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。これには、**[成功]**、**[エラー]**、および **[無効な数値]** ブランチがあります。
![\[設定された [顧客の入力の保存] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/store-customer-input-configured.png)
1. **[Invalid number]** (無効な数値): 顧客が無効な数値を入力した場合の対処方法。
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
+ [コンタクトセンターエージェントとの通話でのセキュアな顧客データ入力のサンプル](sample-secure-input-with-agent.md)
+ [コンタクトセンターエージェントがいない通話でのセキュアな顧客データ入力のサンプル](sample-secure-input-with-noagent.md)
+ [Amazon Connect のキュー設定フローのサンプル](sample-queue-configurations.md)
+ [Amazon Connect のキューに入れられたコールバックフローのサンプル](sample-queued-callback.md)
# Amazon Connect のフローブロック: エージェントへの転送 (ベータ版）
## 説明
+ 現在のフローを終了し、エージェントに顧客を転送します。
**注記**
エージェントがすでに他のユーザーに対応している場合、問い合わせ先は切断されます。
エージェントが問い合わせ後作業 (ACW) 中の場合は、転送時に自動的に ACW から削除されます。
+ [**エージェントへの転送**] ブロックはベータ機能であり、音声でのやり取りに対してのみ機能します。
+ エージェントからエージェントへの転送には、このブロックを使用しないで、[作業キューの設定](set-working-queue.md) ブロックを使用することをお勧めします。**作業キューの設定**ブロックは、音声とチャットなどのオムニチャネル転送をサポートしています。手順については、「[Amazon Connect でエージェント間転送を設定する](setup-agent-to-agent-transfers.md)」を参照してください。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | いいえ - エラーブランチ |
| タスク | いいえ - [エラー] ブランチ |
| E メール | いいえ - [エラー] ブランチ |
チャットとタスクをエージェントに転送するには、[作業キューの設定](set-working-queue.md) ブロックを使用します。[作業キューの設定](set-working-queue.md) はすべてのチャンネルで動作するので、音声通話にも、[**エージェントへの転送 (ベータ)**] の代わりに使用することをお勧めします。手順については、「[Amazon Connect でエージェント間転送を設定する](setup-agent-to-agent-transfers.md)」を参照してください。
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
次の画像は、**[エージェントへの転送]** ブロックの **[プロパティ]** ページを示しています。オプションはありません。
![\[[エージェントへの転送] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/transfer-to-agent-properties.png)
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。ステータス **[転送済み]** が表示されます。ブランチはありません。
![\[設定された [エージェントへの転送] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/transfer-to-agent-configured.png)
## シナリオ
このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [Amazon Connect で問い合わせ転送を設定する](transfer.md)
# Amazon Connect のフローブロック: フローへの転送
このトピックでは、現在のフローを終了し、顧客を別のフローに転送するためのフローブロックを定義します。
## 説明
+ 現在のフローを終了し、別のフローに顧客を転送します。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
次の画像は、**[フローへの転送]** ブロックの **[プロパティ]** ページを示しています。ドロップダウンボックスからフローを選択します。
![\[[フローへの転送] ダイアログの [手動で設定] または [動的に設定] オプションと、選択されたサンプルキュー顧客。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/transfer-to-flow-properties.png)
公開されたフローのみがドロップダウンリストに表示されます。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。**[エラー]** ブランチがあります。
![\[設定された [フローへの転送] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/transfer-to-flow-configured.png)
1. 転送先として指定したフローが有効なフローでない場合、または有効なフロータイプ ([着信]、[エージェントへの転送]、または [キューへの転送]) でない場合、問い合わせは**エラー**ブランチにルーティングされます。
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
+ [Amazon Connect の A/B コンタクト分散テストのサンプルフロー](sample-ab-test.md)
## シナリオ
このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [Amazon Connect で問い合わせ転送を設定する](transfer.md)
# Amazon Connect のフローブロック: 電話番号への転送
このトピックでは、Amazon Connect インスタンス外の外部電話番号に顧客を転送するフローブロックを定義します。
**重要**
Amazon Connect がローカル発信者 ID (CLID) を使用して国内で発信通話を提供するかどうかなど、Amazon Connect が提供するテレフォニー機能のリストについては、「[Amazon Connect Telecoms Country Coverage Guide](https://d1v2gagwb6hfe1.cloudfront.net/Amazon_Connect_Telecoms_Coverage.pdf)」を参照してください。
## 説明
+ 顧客をインスタンスの外部の電話番号に転送します。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | いいえ - エラーブランチ |
| タスク | いいえ - [エラー] ブランチ |
| E メール | いいえ - [エラー] ブランチ |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer Queue flow (顧客キューフロー)]
+ エージェントへの転送フロー
+ キューへの転送フロー
## プロパティ
次の画像は、**[電話番号への転送]** ブロックの **[プロパティ]** ページを示しています。**[転送方法]** セクションを示しています。**[国コード]** は \$11 (米国) に設定されています。**[タイムアウトの設定]** = 30 秒。
![\[[電話番号への転送] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/transfer-to-phone-number-properties.png)
次の画像は、**[切断後にフローを再開]** セクションが **[はい]** に設定されていることを示しています。
![\[[切断後にフローを再開] セクション、[オプションのパラメータ] セクション。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/transfer-to-phone-number-properties2.png)
以下のプロパティに注意してください。
+ **[Resume contact flow after disconnect]** (切断後のフローの再開): これは、外部パーティーが切断され、顧客が切断しない場合にのみ機能します。(顧客が切断すると、コール全体が切断されます)
+ [**Send DTMF (DTMF の送信)**]: このプロパティは、外部パーティの DTMF の一部をバイパスする場合に便利です。例えば、外部パーティに到達するために 1、1、362 を押す必要があることがわかっている場合は、ここに入力できます。
**[DTMF を送信]** でカンマを指定すると、750 ミリ秒間一時停止します。
+ [**Caller ID number (発信者 ID 番号)**]: 発信者 ID として表示する番号をインスタンスから選択できます。これは、フローが実際にコールを発信するために使用している番号とは異なる番号を使用する場合に便利です。
**重要**
米国以外で Amazon Connect をお使いの場合は、[**発信者 ID 番号**] をクリックし、Amazon Connect 番号を選択することをお勧めします。そうしないと、現地の規制により、テレフォニープロバイダーが Amazon Connect 以外の電話番号をブロックまたはリダイレクトすることがあります。これにより、通話拒否、低音質、遅延、レイテンシー、誤った発信者 ID の表示など、サービス関連の事象が発生します。
**オーストラリア国内**: 発信者 ID は、Amazon Connect が提供する DID (ダイレクトインワードダイヤル) 電話番号である必要があります。発信者 ID に通話料無料番号または Amazon Connect によって提供されていない番号が使用されている場合、現地のテレフォニーサプライヤーは、現地の不正防止要件により、発信通話を拒否する場合があります。
**英国の場合**: 発信者 ID は有効な E164 電話番号である必要があります。発信者 ID で電話番号が提供されない場合、現地のテレフォニーサプライヤーは、現地の不正防止要件により、発信通話を拒否する場合があります。
+ [**Caller ID name (発信者 ID 名)**]: 発信者 ID 名を設定できますが、顧客に対して正しく表示される保証はありません。詳細については、「[アウトバウンド発信者 ID 番号](queues-callerid.md#using-call-number-block)」を参照してください。
**注記**
SIP プロトコル RFC3261 では、次の文字が予約されています: **; / ? : @ & = \$1 \$1 ,** 発信者 ID 名にこれらの文字を使用しないでください。これらの文字が含まれていると、発信に失敗したり、発信者 ID 名が不正確に表示されることがあります。
[電話番号への転送](#transfer-to-phone-number) ブロックがカスタム発信者 ID を指定せずに使用されると、コール元の発信者 ID が発信者 ID として渡されます。例えば、外部番号に転送し、カスタム発信者 ID を使用して組織からのコールが送信されることを指定しない場合、連絡先の発信者 ID が部外者に表示されます。
## 設定のヒント
+ [サービスクォータ引き上げリクエストを送信](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-connect)して、指定した国へのアウトバウンドコールをビジネスに許可することをリクエストします。ビジネスが電話をかけるための許可リストにない場合は、失敗します。詳細については、「[Amazon Connect を使用するコールセンターがデフォルトで呼び出すことができる国](country-code-allow-list.md)」を参照してください。
+ 選択したい国が表示されていない場合は、「[Amazon Connect サービスクォータ引き上げ申請書](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-connect)」を使用して、通話を転送したい国を追加するリクエストを送信できます。
+ 通話が転送されたときにフローを終了するか、**[Resume flow after disconnect]** (切断後にフローを再開) かを選択できます。この場合、発信者はインスタンスに戻り、転送された通話が終了するとフローが再開されます。
## 設定されているブロック
次の画像は、このブロックが設定されているときの表示例を示しています。転送先の番号を示しています。**[成功]**、**[呼び出し失敗]**、**[タイムアウト]**、**[エラー]** の各ブランチがあります。
![\[設定された [電話番号への転送] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/transfer-to-phone-number-configured.png)
## シナリオ
このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [Amazon Connect で問い合わせ転送を設定する](transfer.md)
+ [Amazon Connect にアウトバウンド発信者 ID を設定する](queues-callerid.md)
# Amazon Connect のフローブロック: キューへ転送
このトピックでは、現在のコンタクトを送信先キューに転送するためのフローブロックを定義します。
## 説明
このブロックを使用して、現在のコンタクトを送信先キューに転送します。
このブロックの機能は、どこで使用するかに応じて異なります。
+ 顧客キューフローで使用した場合は、すでにキューに入っているコンタクトを別のキューに転送します。
+ コールバックシナリオで使用すると、Amazon Connect は最初にエージェントを呼び出します。エージェントが CCP で通話を受け付けると、Amazon Connect は顧客を呼び出します。
+ 上記以外の場合は、現在のコンタクトをキューに入れ、現在のフローを終了します。
+ このブロックは、チャットチャネルを使用する際のコールバックシナリオでは使用できません。使おうとすると、エラーブランチに分岐します。さらに、CloudWatch ログにエラーが作成されます。
## このブロックのユースケース
このブロックは、以下のシナリオでの使用を想定して設計されています。
+ エージェントへの接続待ちのキューにコンタクトを入れる。
+ 現在のお客様を汎用キューから専用キューに移動する。例えば、お客様をキューに入れたまま長時間待たせた場合や、他のビジネス要件がある場合などは、この対応をした方がよいでしょう。
+ エージェントとつながるまで待たせる代わりに、お客様にコールバックの選択肢を提示する。
## コンタクトのタイプ
次の表に、このブロックでの、指定されたチャネルを使用しているコンタクトのルーティング先を示します。
| コンタクトのタイプ | サポート対象? |
| --- | --- |
| 音声 | はい |
| Chat | はい |
| タスク | はい |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
| フロータイプ | サポート対象? |
| --- | --- |
| 着信フロー | はい |
| 顧客キューフロー | はい |
| 顧客保留フロー | いいえ |
| 顧客ウィスパーフロー | いいえ |
| アウトバウンドウィスパーフロー | いいえ |
| エージェント保留フロー | いいえ |
| エージェントウィスパーフロー | いいえ |
| エージェントへの転送フロー | はい |
| キューへの転送フロー | はい |
## このブロックの設定方法
Amazon Connect 管理ウェブサイトを使用して、**[キューへ転送]** ブロックを設定できます。Amazon Connect Flow 言語を使用することもできます。ユースケースに応じて、次のいずれかのアクションを使用してください。
+ フローブロックが CustomerQueue フロータイプで使用されている場合、Flow 言語では [DequeueContactAndTransferToQueue](https://docs.aws.amazon.com/connect/latest/APIReference/contact-actions-dequeuecontactandtransfertoqueue.html) アクションとして表されます。
+ フローブロックを使用してコールバックを設定する場合は、[CreateCallbackContact](https://docs.aws.amazon.com/connect/latest/APIReference/interactions-createcallbackcontact.html) アクションとして表されます。
+ フローブロックを使用してコールバックを設定する場合、[TransferContactToQueue](https://docs.aws.amazon.com/connect/latest/APIReference/contact-actions-transfercontacttoqueue.html) アクションとして表されます。
**Topics**
+ [キューへの転送](#transfer-to-queue-tab)
+ [コールバックへ転送 (コールバックのスケジュール設定)](#transfer-to-queue-callback)
+ [フローブロックのブランチ](#transfer-to-queue-branches)
+ [追加の設定のヒント](#transfer-to-queue-tips)
+ [このブロックで生成されるデータ](#transfer-to-queue-data)
### キューへの転送
コンタクトをキューに転送するには、この設定タブを使用します。2 つのシナリオが考えられます。
+ **コンタクトがまだキューに入っていない**: コンタクトがまだキューに入っていない場合、この設定では単純に、指定した宛先キューにコンタクトを入れます。キューにまだ存在しないコンタクトの場合は、**[キューへ転送]** ブロックの前に [[作業キューの設定](set-working-queue.md)] ブロックを使用する必要があります。
次の図では、コンタクトをキューに転送するための、**[プロパティ]** ページの **[キューへ転送]** タブを示しています。オプションの選択は不要です。
![\[[キューへの転送] ブロックの [プロパティ] ページ、[キューへの転送] タブ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/transfer-to-queue-properties.png)
次のコード例は、上記と同じ設定が、Flow 言語の [TransferContactToQueue](https://docs.aws.amazon.com/connect/latest/APIReference/contact-actions-transfercontacttoqueue.html) アクションではどのように表現されるかを示しています。
```
{
"Parameters": {},
"Identifier": "a12c905c-84dd-45c1-8f53-4287d1752d59",
"Type": "TransferContactToQueue",
"Transitions": {
"NextAction": "",
"Errors": [
{
"NextAction": "0a1dc9a4-8657-4941-a980-772046b94f1e",
"ErrorType": "QueueAtCapacity"
},
{
"NextAction": "6e84a9b5-1ed0-40b1-815d-a3bdd4b2dc8a",
"ErrorType": "NoMatchingError"
}
]
}
}
```
この場合、次の 2 通りの結果が想定されます。
+ **フル稼働**: 宛先のキューが満杯で、それ以上のコンタクトは、キューで対応可能なコンタクトの最大数を上回るため受け入れることができない場合、コンタクトは **[フル稼働]** ブランチにルーティングされます。
+ **エラー**: 容量の制約以外の理由でキューに転送できない場合 (例えば、転送に指定されたキュー ARN が無効である、キューが現在のインスタンスに存在しない、キューをルーティングに使用できないなど)、コンタクトは **[エラー]** ブランチにルーティングされます。
+ **コンタクトがすでにキューに入っている**: コンタクトがすでにキュー内で待機中の場合は、**[キューへ転送]** ブロックを実行すると、コンタクトがキューから別のキューに移動します。次の図は、コンタクトをキューに転送するように、このブロックを設定する方法を示しています。この例では、**BasicQueue** を手動で設定しています。
![\[[キューへの転送] ブロックの [プロパティ] ページ、[コールバックキューへの転送] タブ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/transfer-to-queue-properties1.png)
以下のコード例は、上記と同じ設定が、Flow 言語の [DequeueContactAndTransferToQueue](https://docs.aws.amazon.com/connect/latest/APIReference/contact-actions-dequeuecontactandtransfertoqueue.html) アクションではどのように表現されるかを示しています。
```
{
"Parameters": {
"QueueId": "arn:aws:connect:us-west-2:1111111111:instance/aaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/queue/abcdef-abcd-abcd-abcd-abcdefghijkl"
},
"Identifier": "180c3ae1-3ae6-43ee-b293-546e5df0286a",
"Type": "DequeueContactAndTransferToQueue",
"Transitions": {
"NextAction": "",
"Errors": [
{
"NextAction": "0a1dc9a4-8657-4941-a980-772046b94f1e",
"ErrorType": "QueueAtCapacity"
},
{
"NextAction": "6e84a9b5-1ed0-40b1-815d-a3bdd4b2dc8a",
"ErrorType": "NoMatchingError"
}
]
}
}
```
この場合、次の 3 通りの結果が想定されます。
+ **成功**: コンタクトが宛先キューに正常に転送されたことを示します。
+ **フル稼働**: 宛先のキューが満杯で、それ以上のコンタクトは、キューで対応できるコンタクトの最大数を上回るため受け入れることができない場合、コンタクトは **[フル稼働]** ブランチにルーティングされます。コンタクトは現在の作業キューに残ります。
+ **エラー**: 容量の制約以外の理由でキューに転送できない場合 (例えば、転送に指定されたキュー ARN が無効である、キューが現在のインスタンスに存在しない、キューをルーティングに使用できないなど)、コンタクトは **[エラー]** ブランチにルーティングされます。コンタクトは現在の作業キューに残ります。
### コールバックへ転送 (コールバックのスケジュール設定)
この設定タブを使用して、コンタクトについて後で特定の時間にコールバックするスケジュールを設定します。次の図の **[プロパティ]** ページは、コールバックのスケジュールを調整するように設定されています。
![\[[キューへ転送] ブロックのプロパティページ、[コールバックへ転送] タブ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/transfer-to-queue-properties-callback.png)
**[コールバックへ転送]** タブでは、次のプロパティを使用できます。
+ **[初回遅延]**: フローでコンタクトのコールバックが開始されてから、顧客が次に対応可能なエージェントのキューに入れられるまでの経過時間を指定します。
+ [**最大再試行回数**]: これが 1 に設定されている場合、Amazon Connect は、最大で 2 回顧客へのコールバックを試みます。最初のコールバックと 1 回の再試行です。
**ヒント**
[**最大再試行回数**] に入力した回数を再確認することを強くお勧めします。誤って 20 などの大きな数字を入力すると、エージェントに不要な作業が発生し、顧客にとってコールが多すぎることになります。
+ [**Minimum time between attempts (試行間の最小時間)**]: 顧客がコールに応答しない場合に、再試行するまでの待機時間です。
+ [**Set working queue (作業キューの設定)**]: コールバックキューを別のキューに転送できます。これは、コールバック専用に特別なキューを設定する場合に便利です。その後、そのキューを表示して、コールバックを待っている顧客の数を確認できます。
**ヒント**
[**Set working queue (作業キューの設定)**] プロパティを指定する場合は、このブロックの前に [**Set customer callback number (顧客のコールバック番号の設定)**] ブロックを追加する必要があります。
作業キューを設定しなかった場合、Amazon Connect はフローで以前に設定されたキューを使用します。
+ **作成フローを設定**: ドロップダウンメニューを使用して、コンタクトのコールバック作成時に実行するフローを選択します。
選択するコールバック作成フローは、次の要件を満たしている必要があります。
+ フロータイプはデフォルトのフロータイプである **[コンタクトフロー (インバウンド)]** である必要があります。フロータイプについては、「[フロータイプを選択する](create-contact-flow.md#contact-flow-types)」を参照してください。
+ 選択したキューにコンタクトを入れるように、[キューへの転送](#transfer-to-queue) ブロックを設定する必要があります。
コールバック作成フローを設定する方法の追加オプションを以下に示します。
+ [コンタクト属性を確認する](check-contact-attributes.md) ブロックを使用してコンタクト属性 (顧客プロファイルを含む) を評価し、コールバックが重複している、または顧客の問題が解決済みのために終了する必要があるかどうかを確認できます。
+ [お客様キューフローの設定](set-customer-queue-flow.md) ブロックを追加し、これを使用して、顧客がキューに転送されたときに実行するフローを指定できます。このフローは、顧客キューフローと呼ばれます。
+ 顧客キューフローでは、[メトリクスの取得](get-queue-metrics.md) ブロックと [GetCurrentMetricData](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetCurrentMetricData.html) の組み合わせを使用して、コンタクトのキューでの待機時間を評価し、特定のコンタクトセンター番号から近い将来コールバックがあることを顧客に事前通知する SMS を送信します。
+ **表示する発信者 ID 番号**: コールバックを受信したときに表示される電話番号を指定します。**手動で設定**を選択して、Amazon Connect インスタンスで登録された電話番号のドロップダウンリストから選択するか、問い合わせ属性に基づいて**動的に設定できます**。属性値は、Amazon Connect インスタンスで取得した有効な電話番号である必要があります。この発信者 ID は、キューに設定されているアウトバウンド電話番号よりも優先されます。
### フローブロックのブランチ
このブロックが**キューに転送する**ように設定されている場合、次の図のようになります。**[容量]** と **[エラー]** の 2 つのブランチがあります。問い合わせが [**容量**] ブランチにルーティングされると、その問い合わせは現在の作業キューに残ります。
![\[設定された [キューへの転送] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/transfer-to-queue-configured.png)
このブロックが**コールバックキューに転送する**ように設定されている場合、次の図のようになります。**[成功]** と **[エラー]** の 2 つのブランチがあります。問い合わせが [**Success**] (成功) ブランチにルーティングされると、その問い合わせは指定したキューに転送されます。
![\[設定された [コールバックへの転送] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/transfer-to-queue-configured1.png)
### 追加の設定のヒント
+ 顧客キューフローでこのブロックを使用する場合は、このブロックの前に [**Loop prompts (ループプロンプト)**] ブロックを追加する必要があります。
+ ほとんどのフローでこのブロックを使用するには、最初に **[Set working queue]** (作業キューの設定) ブロックを追加する必要があります。2 つの例外があります。
+ このブロックを顧客キューフローで使用する場合。
+ コンタクト (インバウンド) フローを指すアウトバウンドキャンペーンを作成する場合。キューはキャンペーン設定を使用して設定済みであるため、**[作業キューの設定]** ブロックは必要ありません。キューに転送するだけで済みます。
+ コンタクトチェーン内のコンタクトの最大数は 12 件なので、キューからキューへの転送は 11 回しか実行できません。転送するたびに、チェーンに新しいコンタクトが追加されます。
### このブロックで生成されるデータ
このブロックではデータは生成されません。
## エラーシナリオ
コンタクトは、次の状況で **[エラー]** ブランチへルーティングされます。
[キューへ転送] ブロックが実行されると、キューが容量の制限 (満杯) に達しているかどうかがチェックされます。このキュー容量のチェックでは、キュー内の現在の問い合わせ数が [キュー内の最大問い合わせ数] の制限 (キューに設定されている場合) と比較されます。制限が設定されていない場合、キューはインスタンスのサービスクォータで設定された同時実行数によって制限されます。
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
+ [Amazon Connect のキュー設定フローのサンプル](sample-queue-configurations.md)
+ [Amazon Connect の顧客キュー優先度フローのサンプル](sample-customer-queue-priority.md)
+ [Amazon Connect のキューに入れられたコールバックフローのサンプル](sample-queued-callback.md)
## その他のリソース
コンタクトのキューへの転送、キューに入っているコールバックの詳細については、以下のトピックを参照してください。
+ [Amazon Connect でキュー内の問い合わせを管理するフローを設定する](queue-to-queue-transfer.md)
+ [Amazon Connect でフロー、キュー、およびルーティングプロファイルを作成して、キューに保存されたコールバックを設定する](setup-queued-cb.md)
+ [Amazon Connect のリアルタイムメトリクスでキューに入れられたコールバック](about-queued-callbacks.md)
# Amazon Connect のフローブロック: 待機
このトピックでは、指定した時間だけフローを一時停止するためのフローブロックを定義します。
## 説明
このブロックは、指定した待機時間または指定したイベントの間だけフローを一時停止します。
例えば、問い合わせがチャットに応答しなくなった場合、ブロックは指定された待機時間 (**[タイムアウト]** 時間) だけ問い合わせフローを一時停止し、その後、切断など適切なブランチに分岐します。
## サポートされるチャネル
次の表に、このブロックでの、指定されたチャネルを使用している問い合わせのルーティング先を示します。
| [チャネル] | サポート対象? |
| --- | --- |
| 音声 | はい - ただし、**[待機中、実行し続ける]** オプションまたは **[イベントベースの待機を設定]** オプションが選択されている場合のインバウンドフローに限ります (以下の画像を参照)。 |
| Chat | はい |
| タスク | はい - 常に **[期限切れ]** または **[エラー]** に分岐します。**[ボット参加者が切断されました]** または **[参加者が見つかりません]** に分岐することはありません。**[参加者のタイプ]** 設定はこの動作に影響しません。 |
| E メール | はい |
## フロータイプ
このブロックは、次の[フロータイプ](create-contact-flow.md#contact-flow-types)で使用できます。
+ 着信フロー
+ [Customer Queue flow (顧客キューフロー)]
## プロパティ
次の画像は、**[待機]** ブロックの **[Config]** タブを示しています。フローを 5 時間一時停止するように設定されています。
![\[[待機] ブロックの [Config] タブの設定。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/wait-properties.png)
以下のプロパティがあります。
+ **[参加者のタイプ]**: 指定された参加者タイプに **[待機]** ブロックを実行します。
+ **[デフォルト]** - 顧客の連絡先。
+ **[ボット]** - サードパーティーのボットなどのカスタム参加者。このオプションの使用の詳細については、「[カスタム参加者を統合して Amazon Connect でのチャットフローエクスペリエンスをカスタマイズする](chat-customize-flow.md)」を参照してください。
+ **タイムアウト**: 指定した時間が経過しても顧客がメッセージを送信していない場合は、このブランチを実行します。最大は 7 日間です。
+ タイムアウトの手動設定: **数値**と**単位**を指定できます。
+ タイムアウトの動的設定: 測定単位は秒単位です。
+ **[顧客が戻る]**: 顧客が戻ってメッセージを送信した場合は、連絡先をこのブランチにルーティングします。このブランチでは、顧客を前の (同じ) エージェント、前の (同じ) キューにルーティングすることも、上書きして新しい作業キューまたはエージェントを設定することもできます。このオプションブランチは、**[参加者のタイプ]** = **[デフォルト]** の場合にのみ使用できます。
+ **イベントベースの待機を設定**: 完了を待機する Lambda を指定し、指定した Lambda の実行の完了時に、コンタクトを [Lambda が戻った] ブランチにルーティングします。このオプションブランチは、**[参加者のタイプ]** = **[デフォルト]** の場合にのみ使用できます。
+ **待機中、実行し続ける**: ブロックで待機中に、コンタクトを **[続行]** ブランチに一時的にルーティングします。このオプションブランチは、**[参加者のタイプ]** = **[デフォルト]** の場合にのみ使用できます。
## 設定のヒント
+ **[非同期]** 実行モードの [[AWS Lambda 関数](invoke-lambda-function-block.md)] ブロックを使用して呼び出される Lambda を待機するように **[待機]** ブロックを設定できます。これを行うには、**[イベントベースの待機を設定]** オプションを選択し、Lambda 呼び出しの RequestId を指定します。詳細については、「[Lambda 結果をロード](invoke-lambda-function-block.md#properties-load-lamdba)」を参照してください。
**注記**
間違った呼び出し ID を **[待機]** ブロックに指定すると、**設定したタイムアウト** まで待機し続けます。
+ **[待機]** ブロックの **[続行]** ブランチ内で別の **[待機]** ブロックを使用するなど、**[待機]** ブロックをネストすることはできません。
例えば、最初の [待機] ブロックを **[続行]** と Lambda から返されたブランチで設定し、非同期 Lambda 呼び出しが戻るのを待つ間、特定の遅延 (**[続行]** ブランチの 2 番目の [待機] ブロックで設定) でメッセージを送信することはできません。この設定では、2 番目の **[待機]** ブロックで次のエラーが発生します。
+ **[待機] アクションの [続行] ブランチでサポートされていないアクション**
+ 他のブロックを実行するように **[待機]** ブロックを設定できます。例えば、Lambda の実行が完了するのを待っている間に音声を再生できます。これを行うには、**[続行]** ブランチに [[プロンプトの再生](play.md)] ブロックを追加します。
+ 複数の **[待機]** ブロックをフローに追加できます。例えば、次のようになります。
+ 顧客が 5 分後に戻ってきた場合は、同じエージェントに接続します。これは、そのエージェントがすべてのコンテキストを持っているためです。
+ 5 分経過しても顧客が戻らない場合は、「お話しできなくて残念でした」というテキストを送信します。
+ 顧客が 12 時間以内に戻った場合は、顧客を優先キューに入れるフローに接続します。ただし、同じエージェントにはルーティングされません。
## 設定されているブロック
次の画像は、このブロックが **[参加者のタイプ]** = **[デフォルト]** で設定されているときの表示例を示しています。次のブランチがあります。**[期限切れ]** および **[エラー]**。
![\[設定された [待機] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/wait-configured.png)
次の画像は、このブロックが **[参加者のタイプ]** = **[ボット]** で設定されているときの表示例を示しています。次のブランチがあります。**[ボット参加者が切断されました]**、**[参加者が見つかりません]**、**[期限切れ]**、および [**エラー**]。
![\[設定された [待機] ブロック。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/wait-configured2.png)
1. **[ボット参加者が切断されました]**: サードパーティーのボットなどのカスタム参加者が連絡先との接続を正常に切断しました。
1. **[参加者が見つかりません]**: 連絡先に関連付けられているカスタム参加者は見つかりませんでした。
1. **[期限切れ]**: カスタム参加者が接続を解除する前に、指定されたタイムアウトになりました。
## サンプルフロー
Amazon Connect には、サンプルフローのセットが含まれています。フローデザイナーでサンプルフローにアクセスする方法については、「[Amazon Connect のサンプルフロー](contact-flow-samples.md)」を参照してください。以下のトピックでは、このブロックを含むサンプルフローについて説明します。
+ [Amazon Connect の切断フローのサンプル](sample-disconnect.md)
## シナリオ
このブロックを使用するシナリオについては、次のトピックを参照してください。
+ [チャットシナリオの例](web-and-mobile-chat.md#example-chat-scenario)