説明このブロックのユースケースプロンプトの要件サポートされている連絡先のタイプサポートされているフローのタイプこのブロックを設定する方法エラーシナリオフローログエントリサンプルフローその他のリソース

フローブロック: プロンプトの再生

説明

これを使用して、音声プロンプトまたは text-to-speech メッセージを再生したり、チャットレスポンスを送信したりできます。

顧客 (発信者またはチャットを使用している顧客) とエージェントにプロンプトを再生できます。

通話には、次のオプションがあります。

事前録画されたプロンプトを使用する: Amazon Connect には、既製のオプションのライブラリが用意されています。
独自のプロンプトを記録します。次のオプションがあります。
- Amazon Connect ライブラリを使用する: Amazon Connect 管理ウェブサイトから直接録音をアップロードします。
- Amazon S3 を使用する: プロンプトを S3 に保存し、呼び出し中に動的にアクセスします。
Text-to-speech: プレーンテキストまたは SSML (音声合成マークアップ言語) を指定して、音声として発声させます。

チャットには、次のオプションがあります。

テキストプロンプトのみ: 顧客とエージェントの両方にプレーンテキストメッセージを送信します。事前録画されたプロンプトなどのオーディオオプションは、チャットでは使用できません。

このブロックのユースケース

このブロックは、次のシナリオで使用するように設計されています。

お客様に挨拶を再生します。例えば、「カスタマーサービスラインへようこそ」と入力します。
データベースから取得した情報を顧客またはエージェントに返します。例えば、「アカウント残高は 123.45 USD です。」
顧客がキューまたは保留中に、事前に録音された音声を再生します。
S3 バケットから独自の音声で、事前に録音された音声を再生します。

プロンプトの要件

サポートされている形式: Amazon Connect は、プロンプトに使用する .wav ファイルをサポートしています。8 KHz の .wav ファイルと U-Law エンコーディングのモノチャネルオーディオを使用する必要があります。そうしないと、プロンプトが正しく再生されません。公開されているサードパーティーツールを使用して、.wav ファイルを U-Law エンコーディングに変換できます。ファイルを変換した後、Amazon Connect にアップロードします。
サイズ: Amazon Connect は、50 MB 未満かつ 5 分未満のプロンプトをサポートします。
S3 バケットにプロンプトを保存する場合： アフリカ (ケープタウン) など、デフォルトで無効になっている AWS リージョン (オプトインリージョンとも呼ばれます) の場合、バケットは同じリージョンに存在する必要があります。

サポートされている連絡先のタイプ

連絡先のタイプ	サポート対象?
音声	はい
チャット	はいチャット問い合わせがこのブロックにルーティングされているが、ブロックが通話用に設定されている場合、問い合わせはエラーブランチにルーティングされます。
タスク	はいタスク問い合わせがこのブロックにルーティングされると、問い合わせは成功ブランチにルーティングされますが、プロンプトは再生されません。

連絡先のタイプ

サポート対象?

音声

はい

チャット

はい

チャット問い合わせがこのブロックにルーティングされているが、ブロックが通話用に設定されている場合、問い合わせはエラーブランチにルーティングされます。

タスク

はい

タスク問い合わせがこのブロックにルーティングされると、問い合わせは成功ブランチにルーティングされますが、プロンプトは再生されません。

サポートされているフローのタイプ

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

フロータイプ	サポート対象?
インバウンドフロー ( contactFlow)	はい
顧客キューフロー (customerQueue )	はい。オーディオプロンプトの Error ブランチを取得します。
顧客保留フロー (customerHold)	いいえ。代わりにプロンプトのループフローブロックを使用してください
お客様ウィスパーフロー (customerWhisper )	はい。Amazon Connect ライブラリからプロンプトを再生できますが、Amazon S3 に保存されているプロンプトは再生できません。
アウトバウンドウィスパーフロー (outboundWhisper)	はい。Amazon Connect ライブラリからプロンプトを再生できますが、Amazon S3 に保存されているプロンプトは再生できません。
エージェント保留フロー (agentHold )	いいえ。代わりにプロンプトのループフローブロックを使用してください
エージェントウィスパーフロー (agentWhisper )	はい。Amazon Connect ライブラリからプロンプトを再生できますが、Amazon S3 に保存されているプロンプトは再生できません。
エージェントフローへの転送 (agentTransfer )	はい
キューフローへの転送 (queueTransfer )	はい

このブロックを設定する方法

再生プロンプトブロックは、 Amazon Connect 管理者ウェブサイトまたは Amazon Connect Flow 言語の MessageParticipantアクションを使用して設定できます。次の 3 つの設定オプションがあります。

Amazon Connect プロンプトライブラリに保存されているプロンプト
Amazon S3 に保存されているプロンプト
T ext-to-speech またはチャットテキスト

Amazon Connect プロンプトライブラリに保存されているプロンプト

フローデザイナーで、プロンプトの再生ブロックの設定ペインを開きます。
プロンプトライブラリ (オーディオ) から選択。
Amazon Connect に含まれている事前録画されたプロンプトのいずれかを選択するか、 Amazon Connect 管理ウェブサイトを使用して独自のプロンプトを記録してアップロードします。プロンプトを一括アップロードする方法はありません。

次の画像は、プロンプトライブラリからの音声プロンプトを再生するように設定された [プロンプトの再生] ブロックの [プロパティ] ページを示しています。

次のコードサンプルは、フロー言語の MessageParticipantアクションでこの同じ設定がどのように表されるかを示しています。


{
         "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 バケットからオーディオファイルを指定するには

フローデザイナーで、プロンプトの再生ブロックの設定ペインを開きます。
S3 バケットからオーディオファイルを指定するを選択します。

手動で設定 を選択し、S3 のオーディオプロンプトを指す S3 ファイルパスを指定します。例えば https://u1.s3.amazonaws.com/en.lob1/welcome.wav です。

次の画像は、S3 ファイルパスを手動で設定するように設定された [プロンプトの再生] ブロックの [プロパティ] ページを示しています。

[プロンプトの再生] ブロックの [プロパティ] ページ、手動で指定された S3 ファイルパス。

次のコードサンプルは、フロー言語の MessageParticipantアクションでこの同じ設定がどのように表されるかを示しています。


{
      "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 パスに連結を指定することができます。これにより、例えば、基幹業務や言語別にプロンプトをパーソナライズできます。例：https://example.s3.amazon.aws.com/$['Attributes']['Language']/$['Attributes']['LOB']/1.wav

次のコードサンプルは、フロー言語の MessageParticipantアクションでこの同じ設定がどのように表されるかを示しています。


{
         "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 パスを動的に指定するには

次の図は、S3filepath という名前のユーザー定義属性を示しています。

次のコードサンプルは、フロー言語の MessageParticipantアクションでこの同じ設定がどのように表されるかを示しています。


{
   "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 つのブランチがあります。

T ext-to-speech またはチャットテキスト

プロンプトはプレーンテキストまたは SSML で入力できます。これらのテキストベースのプロンプトは、Amazon Polly を使用するお客様に音声プロンプトとして再生されます。

例えば、次の画像は、顧客に電話をかけるよう促すメッセージを再生するように設定された再生プロンプトブロックを示しています。

次のコードサンプルは、フロー言語の MessageParticipantアクションでこの同じ設定がどのように表されるかを示しています。


{
   "Parameters": {
       "Text": "<speak>Thank you for calling</speak>"
   },
   "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 タグ」を参照してください。

詳細については、「プロンプト text-to-speech に追加する」を参照してください。

次の図は、用に設定されている場合の再生プロンプトブロックの表示例を示しています text-to-speech。再生されるテキストと、[成功] と [エラー] の 2 つのブランチがあることを示しています。

フローブロックブランチ

このブロックは、次の出力ブランチをサポートします。

成功： 提供された音声またはテキストメッセージが正常に再生されたことを示します。
エラー： 提供された音声またはテキストメッセージの再生に失敗したことを示します。
問題: 一部の既存のフローには、エラーブランチがない再生プロンプトブロックのバージョンがあります。この場合は、実行時に常に [Okay] (オーケー) ブランチが取得されます。[エラー] ブランチを持っていない [プロンプトの再生] ブロックの設定を更新すると、[エラー] ブランチはエディタでブロックに自動的に追加されます。

その他の設定のヒント

問い合わせ属性を使用して動的プロンプトを設定する step-by-step 方法については、「」を参照してください再生するプロンプトを動的に選択。
S3 バケットからプロンプトを再生する場合、最高のパフォーマンスを得るには、Amazon Connect インスタンスと同じ AWS リージョンにバケットを作成することをお勧めします。
text-to-speech またはチャットでテキストを使用する場合、合計 6,000 文字の請求対象文字を最大 3,000 文字使用できます。問い合わせ属性を使用して、フロー内のテキストを指定することもできます。

このブロックによって生成されたデータ

このブロックはデータを生成しません。

エラーシナリオ

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

Amazon Connect が S3 からプロンプトをダウンロードできません。これは、ファイルパスが正しくないか、S3 バケットポリシーが正しく設定されておらず、Amazon Connect がアクセスできないことが原因である可能性があります。ポリシーを適用する方法と使用できるテンプレートについては、「S3 バケットから再生するプロンプトを設定する」を参照してください。
オーディオファイル形式が正しくありません。.wav ファイルのみがサポートされています。
オーディオファイルが 50 MB より大きいか 5 分を超えています。
SSML が正しくありません。
text-to-speech 長さが 6000 文字を超えている。
プロンプトの Amazon リソースネーム (ARN) が正しくありません。

フローログエントリ

Amazon Connect フローログは、顧客がやり取りするときに、フロー内のイベントに関するリアルタイムの詳細を提供します。以下は、再生プロンプトブロックのフローログエントリの例です。

詳細については、「お客様がフローとやり取りしている間にイベントを追跡する」を参照してください。

サンプルフロー

すべてのサンプルフローでは、[Play prompt (プロンプトの再生)] ブロックが使用されます。「サンプルインバウンドフロー (初回問い合わせエクスペリエンス)」を参照して、チャットと音声用の [Play prompt (プロンプトの再生)] を確認します。

その他のリソース

プロンプトの詳細については、以下のトピックを参照してください。

プロンプトの作成

Amazon Connect API リファレンスガイドのプロンプトアクション。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

プロンプトのループ

コンタクトを再開

フローブロック: プロンプトの再生

説明

このブロックのユースケース

プロンプトの要件

サポートされている連絡先のタイプ

サポートされているフローのタイプ

このブロックを設定する方法

Amazon Connect プロンプトライブラリに保存されているプロンプト

Amazon S3 に保存されているプロンプト

S3 バケットからオーディオファイルを指定するには

属性を使用して S3 バケットからのオーディオファイルパスを指定するには

ユーザー定義の問い合わせ属性を使用して S3 パスを動的に指定するには

T ext-to-speech またはチャットテキスト

フローブロックブランチ

その他の設定のヒント

このブロックによって生成されたデータ

エラー シナリオ

フローログエントリ

サンプルフロー

その他のリソース

エラーシナリオ