

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Connect でプロンプトを作成する
<a name="prompts"></a>

プロンプトは、通話フローで再生されるオーディオファイルです。例えば、保留時の音楽はプロンプトです。Amazon Connect には、フローに追加できる一連のプロンプトが付属しています。または、独自の録音を追加することもできます。

顧客へのスムーズな通話フローを確保するために、プロンプトとルーティングポリシーを相互に調整することをお勧めします。

このセクションのトピックで説明されているように Amazon Connect 、 管理サイトを使用してプロンプトを作成および管理できます。または、*Amazon Connect  API リファレンスガイド*に記載されている[プロンプトアクション](https://docs.aws.amazon.com/connect/latest/APIReference/prompts-api.html)を使用することができます。

**Topics**
+ [プロンプトの作成方法](#howto-prompts)
+ [サポートされているファイルの種類](#supported-file-types-for-prompts)
+ [プロンプトの最大長](#max-length-for-prompts)
+ [UI、API、または CLI でサポートされていないプロンプトの一括アップロード](#bulk-upload-prompts)
+ [Amazon Polly でフローブロックのプロンプトにテキスト読み上げを追加する](text-to-speech.md)
+ [再生プロンプトブロックで動的テキスト文字列を作成する](create-dynamic-text-strings.md)
+ [Amazon Connect で再生するプロンプトを動的に選択する](dynamically-select-prompts.md)
+ [Amazon Connect で S3 バケットから再生するプロンプトを設定する](setup-prompts-s3.md)
+ [Amazon Connect で音声プロンプトのテキスト読み上げ音声と言語を選択する](voice-for-audio-prompts.md)
+ [Amazon Polly で SSML タグを使用してテキスト読み上げ機能をパーソナライズする](ssml-prompt.md)
+ [Amazon Connect チャット会話の SSML タグ](chat-and-ssml-tags.md)
+ [Amazon Connect でサポートされている SSML タグ](supported-ssml-tags.md)

## プロンプトの作成方法
<a name="howto-prompts"></a>

このトピックでは、Amazon Connect 管理サイトを使用してプロンプトを作成する方法について説明します。プログラムでプロンプトを作成するには、*Amazon Connect  API リファレンスガイド*の 「[CreatePrompt](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreatePrompt.html)」を参照してください。

1. 次のセキュリティプロファイルのアクセス許可を持つアカウント Amazon Connect を使用して にログインします。
   + **[数値とフロー]**、**[プロンプト - 作成]**

1. ナビゲーションメニューで、**[Routing]** (ルーティング)、**[Prompts]** (プロンプト) の順に選択します。

1. **[プロンプト]** ページで、**[プロンプトを追加]** をクリックします。

1. **[プロンプトを追加]** ページで、プロンプトの名前を入力します。

1. **[説明]** ボックスに、メッセージの説明を入力します。このボックスを使用してプロンプトの詳細な説明を入力することをお勧めします。これにより、アクセスしやすくなります。

1. 次のアクションを選択します。
   + **アップロード** — **[ファイルを選択]** をクリックして、法的に使用許可がある .wav ファイルをアップロードします。
   + **録音**—**[録音を開始]** をクリックして、マイクに向かってメッセージを録音します。終了したら **[録音を停止]** をクリックします。録音したプロンプトのセクションをカットするには、**[クロップ]** をクリックします。新しいプロンプトを録音するには、**[録音をクリア]**] をクリックします。

1. **[プロンプトの設定]** セクションに、プロンプトの管理に使用するタグを入力します。

   例えば、挨拶のプロンプトを管理する部門がある場合、このようなプロンプトにタグを付けて、ユーザーが自身に関係のある録音のみに集中できるようにすることができます。

1. オプションで、タグを追加して、このプロンプトにアクセスできるユーザーを識別、整理、検索、フィルタリング、制御します。詳細については、「[Amazon Connect でリソースにタグを追加する](tagging.md)」を参照してください。

**[プロンプト]** ページのフィルターを使用して、**[名前]**、**[説明]**、**[タグ]** 別にプロンプトのリストにフィルターを適用できます。プロンプトの Amazon リソースネーム (ARN) をワンクリックでコピーするには、**[コピー]** アイコンをクリックします。[フローに動的プロンプトを設定する](dynamically-select-prompts.md)場合は、プロンプトの完全な ARN を入力する必要があります。

![\[プロンプトページ、フィルターオプション、ARN のコピーオプション\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/prompts-filter.png)


## サポートされているファイルの種類
<a name="supported-file-types-for-prompts"></a>

プロンプトに使用するために事前に記録された .wav ファイルをアップロードするか、ウェブアプリケーションに記録することができます。

50 MB 未満かつ 5 分未満の 8 KHz の .wav ファイルを使用することをお勧めします。16 KHz のファイルなど、より高いレートのオーディオライブラリを使用する場合、Amazon Connect では PSTN の制限によりサンプリングレートを 8 KHz に下げる必要があります。これにより、オーディオの品質が低下する可能性があります。詳細については、Wikipedia の記事、「[G.711](https://en.wikipedia.org/wiki/G.711)」を参照してください。

## プロンプトの最大長
<a name="max-length-for-prompts"></a>

Amazon Connect は、50 MB 未満かつ 5 分未満のプロンプトをサポートします。

## UI、API、または CLI でサポートされていないプロンプトの一括アップロード
<a name="bulk-upload-prompts"></a>

現在、プロンプトの一括アップロードは、Amazon Connect コンソールまたは API や CLI を使用したプログラムではサポートされていません。

# Amazon Polly でフローブロックのプロンプトにテキスト読み上げを追加する
<a name="text-to-speech"></a>

次のフローブロックにテキスト読み上げプロンプトを入力できます。
+ [顧客の入力を取得する](get-customer-input.md) 
+ [プロンプトのループ](loop-prompts.md)
+ [プロンプトの再生](play.md)
+ [顧客の入力を保存する](store-customer-input.md)

## Amazon Polly でテキストを音声に変換
<a name="amazon-polly-default-voice-free"></a>

テキストを音声に変換するには、Amazon Connect では Amazon Polly を使用します。これは SSML を使用してテキストを肉声に近い音声に変換するサービスです。
+ Amazon Polly Neural および Standard ボイスなどの Amazon Polly のデフォルトボイスは**無料**です。
+ Amazon Polly 生成音声の使用に対して課金されます。料金の詳細については、[Amazon Pollyの料金詳細](https://aws.amazon.com/polly/pricing/)」を参照してください。
+ [次世代の Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/enable-nextgeneration-amazonconnect.html) にオンボーディングしている場合、生成音声は次世代の Amazon Connect 料金の一部として含まれます。
+ アカウントに関連付けられている固有の[ブランドボイス](https://aws.amazon.com/blogs/machine-learning/build-a-unique-brand-voice-with-amazon-polly/)など、カスタム音声の使用には料金が発生します。

## Amazon Polly の最適な音声
<a name="amazon-polly-best-sounding-voice"></a>

Amazon Polly では、音声や話し方を改善して定期的にリリースしています。テキスト読み上げを、最も肉声に近く自然な音声に変えるように自動的に変換することができます。例えば、フローで Joanna が使用されている場合、Amazon Connect は自動的に Joanna の会話型の話し方に変換します。

**注記**  
ニューラルバージョンを使用できない場合、Amazon Connect はデフォルトで標準音声になります。

**最適な音声を自動的に使用する**

1. Amazon Connect コンソール ([https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)) を開きます。

1. ログインを求められたら、 AWS アカウントの認証情報を入力します。

1. **[インスタンスエイリアス]** 列からインスタンスの名前を選択します。  
![\[[Amazon Connect 仮想コンタクトセンターのインスタンス] ページ、インスタンスのエイリアス。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/instance.png)

1. ナビゲーションペインで、**[フロー]** を選択します。

1. [Amazon Polly] セクションで、[**利用可能な最高の音声を使用する**] を選択します。

## テキスト読み上げ機能を追加する方法
<a name="add-tts"></a>

1. フローで、プロンプトを再生するブロックを追加します。例えば、[プロンプトの再生](play.md) ブロックを追加します。

1. [**プロパティ**] で、[**テキスト読み上げ**] を選択します。

1. プレーンテキストを入力します。例えば、次の画像は、「*お電話ありがとうございます*」を示しています。  
![\[[テキスト読み上げ] ボックスのメッセージ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/play-prompt-sample-tts.png)

   または、次の画像に示すように、SSML を入力します。  
![\[[テキスト読み上げ] ボックスの、SSML でフォーマットされたメッセージ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/play-prompt-sample-ssml.png)

SSML 拡張された入力テキストを使用すると、Amazon Connect を使用して入力したテキストから音声を生成する方法を詳細に制御できます。発音、音量、ピッチ、話す速度など、音声のさまざまな要素をカスタマイズして制御できます。

Amazon Connect で使用できる SSML タグのリストについては、「[Amazon Connect でサポートされている SSML タグ](supported-ssml-tags.md)」を参照してください。

Amazon Polly の詳細については、Amazon Polly デベロッパーガイドの「[Using SSML](https://docs.aws.amazon.com/polly/latest/dg/ssml.html)」を参照してください。

# Amazon Connect の再生プロンプトブロックで動的テキスト文字列を作成する
<a name="create-dynamic-text-strings"></a>

[プロンプトの再生](play.md) ブロックを使用してオーディオファイルを使用し、挨拶またはメッセージを発信者に再生します。問い合わせ属性を使用して、発信者に配信する挨拶またはメッセージを指定します。問い合わせ属性の値を使用してメッセージをお客様に合わせてパーソナライズするためには、テキスト読み上げメッセージに保存された問い合わせ属性または外部問い合わせ属性への参照を含めます。

例えば、Lambda 関数からお客様の名前を取得して、FirstName と LastName についてお客様データベースから値が返される場合、次のようなテキストを含めることで、テキスト読み上げブロックでこれらの属性を使用して、お客様の名前を言うようにすることができます。
+ こんにちは \$1.External.FirstName\$1.External.LastName さん、ご連絡ありがとうございます。

このメッセージは、次の [プロンプトの再生](play.md) ブロックの [テキスト読み上げ] ボックスの画像に示されています。

![\[[テキスト読み上げ] ボックスの、属性を含むメッセージ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/play-prompt-attribute.png)


あるいは、Lambda 関数から返された属性を **[Set contact attributes]** (問い合わせ属性の設定) ブロックを使用して保存し、テキスト読み上げ文字列で作成したユーザー定義の属性を参照することもできます。

API を使用してフローで問い合わせ属性として以前に設定されたユーザー定義属性を参照する場合は、\$1.Attributes.nameOfAttribute 構文を使用して属性を参照できます。

例えば、該当の問い合わせに属性「FirstName」と「LastName」が以前に設定されている場合は、次のように参照します。
+ Hello \$1.Attributes.FirstName \$1.Attributes.LastName, thank you for calling。

## バックティックを使用した解決
<a name="w2aac18c29c21c23"></a>

バックティック (`) を使用してキーを動的に解決することもできます。たとえば、顧客データベースから FirstName 値と LastName 値を返す Lambda 関数から顧客名を取得するとします。使用する名前に対するお客様の設定が \$1.Attributes.NameToPlay に保存されている場合は、動的キーをバックティック (`) で囲むことで、適切な名前を動的に選択できます。
+ こんにちは \$1.External.['`\$1。Attributes.NameToPlay`']、お電話ありがとうございます。

# Amazon Connect で再生するプロンプトを動的に選択する
<a name="dynamically-select-prompts"></a>

属性を使用して、再生するプロンプトを動的に選択できます。

1. [コンタクト属性の設定](set-contact-attributes.md) ブロックをフローに追加します。それぞれを設定して、適切なオーディオプロンプトを再生します。例えば、最初のブロックは、コンタクトセンターが開いているときに .wav ファイルを再生します。2番目の属性で、センターが閉じているときに再生する .wav ファイル設定することがあります。

   次の図は、[コンタクト属性の設定](set-contact-attributes.md) ブロックを設定する例を示しています。この例では、ユーザー定義の属性の名前は、**CompanyWelcomeMessage** です。属性には任意の名前を付けることができます。  
![\[[コンタクト属性の設定] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/play-prompt-properties-2-a-new.png)

1. 次の画像に示すように、[プロンプトの再生](play.md) ブロックで **[ユーザー定義]** を選択し、ステップ 1 で作成した属性の名前を入力します。  
![\[[プロンプトの再生] ブロックの [プロパティ] ページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/play-prompt-properties2.png)

1. [コンタクト属性の設定](set-contact-attributes.md) ブロックを [**プロンプトの再生**] ブロックに接続します。次の例は、この動作をテストするために各ブロックの 1 つを追加したときにどのように表示されるかを示しています。  
![\[[コンタクト属性の設定] ブロックが [プロンプトの再生] に接続されたフロー。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/play-prompt-properties-2-b.png)

# Amazon Connect で S3 バケットから再生するプロンプトを設定する
<a name="setup-prompts-s3"></a>

[顧客の入力を取得する](get-customer-input.md)、[プロンプトのループ](loop-prompts.md)、[プロンプトの再生](play.md)、または [顧客の入力を保存する](store-customer-input.md) ブロックでプロンプトを設定する場合、S3 バケットをソースの場所として選択できます。S3 バケットには必要な数の音声プロンプトを保存でき、問い合わせ属性を使用してリアルタイムでアクセスできます。例については、[プロンプトの再生](play.md) ブロックを参照してください。

## 要件
<a name="format-prompts-s3"></a>
+ **サポートされている形式**: Amazon Connect は、プロンプトに使用する .wav ファイルをサポートしています。8 KHz の .wav ファイルと U-Law エンコーディングのモノチャネルオーディオを使用する必要があります。そうしないと、プロンプトが正しく再生されません。公開されているサードパーティーツールを使用して、.wav ファイルを U-Law エンコーディングに変換できます。ファイルを変換した後、Amazon Connect にアップロードします。
+ **サイズ**: Amazon Connect は、50 MB 未満かつ 5 分未満のプロンプトをサポートします。
+ アフリカ (ケープタウン) など、**デフォルトで無効になっているリージョン** ([オプトイン](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html)リージョンとも呼ばれます) の場合、バケットは同じリージョンに存在する必要があります。

## S3 バケットポリシーを更新する
<a name="bucket-policy-prompts-s3"></a>

Amazon Connect が S3 バケットのプロンプトを再生できるようにするには、S3 バケットを設定するときに、バケットポリシーを更新して、`s3:ListBucket` と `s3:GetObject` を呼び出す `connect.amazonaws.com` (Amazon Connect サービスプリンシパル) 許可を付与する必要があります。

**S3 バケットポリシーを更新するには、次の手順を実行します。**

1. Amazon S3 管理コンソールに移動します。

1. プロンプトがあるバケットを選択します。

1. **[Permissions]** (許可) タブを選択します。

1. **[Bucket policy]** (バケットポリシー) ボックスで、**[Edit]** (編集) を選択し、次のポリシーをテンプレートとして貼り付けます。バケット名、リージョン、 AWS アカウント ID、および [インスタンス ID](find-instance-arn.md) をユーザー自身の情報に置き換えて、**[Save changes]** (変更の保存) を選択します。

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Sid": "statement1",
               "Effect": "Allow",
               "Principal": {
                   "Service": "connect.amazonaws.com"
               },
               "Action": [
                   "s3:ListBucket",
                   "s3:GetObject"
               ],
               "Resource": [
                   "arn:aws:s3:::amzn-s3-demo-bucket1",
                   "arn:aws:s3:::amzn-s3-demo-bucket1/*"
               ],
               "Condition": {
                   "StringEquals": {
                       "aws:SourceAccount": "123456789012",
                       "aws:SourceArn": "arn:aws:connect:region:123456789012:instance/instance-id"
                   }
               }
           }
       ]
   }
   ```

------

1. 暗号化: Amazon Connect は、S3 バケットで AWS マネージドキー が有効になっている場合、その S3 バケットからプロンプトをダウンロードして再生できません。ただし、カスタマー管理キーを使用して、Amazon Connect インスタンスが S3 バケットにアクセスできるようにする Amazon Connect サービスプリンシパル ("connect.amazonaws.com") を許可することができます。次のコードスニペットを参照してください。

   ```
   {
               "Sid": "Enable Amazon Connect",
               "Effect": "Allow",
               "Principal": {
                   "Service": "connect.amazonaws.com"
               },
               "Action": "kms:decrypt",
               "Resource": [
               	"arn:aws:kms:region:account-ID:key/key-ID"
               ]
   }
   ```

   次の図は、 AWS Key Management Service コンソールの**キーポリシー**タブでコードを配置する場所を示しています。  
![\[キーポリシーを追加する KMS のページ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/contact-flow-prompts-s3.png)

   キー ID を見つける方法については、『*AWS Key Management Service デベロッパーガイド*』の「[キー ID と ARN の検索](https://docs.aws.amazon.com/kms/latest/developerguide/find-cmk-id-arn.html)」を参照してください。

必要なバケットポリシーで S3 バケットを設定した後、バケットからプロンプトを再生するように [顧客の入力を取得する](get-customer-input.md)、[プロンプトのループ](loop-prompts.md)、[プロンプトの再生](play.md)、または [顧客の入力を保存する](store-customer-input.md) を設定します。

**ヒント**  
例や制限を含む S3 バケットの詳細については、[プロンプトの再生](play.md) ブロックを参照してください。

# Amazon Connect で音声プロンプトのテキスト読み上げ音声と言語を選択する
<a name="voice-for-audio-prompts"></a>

テキスト読み上げ機能の音声と言語は、[音声の設定](set-voice.md) ブロックで選択します。

Amazon Lex ボットで SSML を使用して、チャットボットがお客様とやり取りする際に使用する音声を変更することもできます。Amazon Lex ボットで SSML を使用する方法の詳細については、Amazon Lex デベロッパーガイドの「[Managing Messages](https://docs.aws.amazon.com/lex/latest/dg/howitworks-manage-prompts.html#msg-prompts-response)」および「[Managing Conversation Context](https://docs.aws.amazon.com/lex/latest/dg/context-mgmt.html#special-response)」を参照してください。

**ヒント**  
Amazon Polly の音声でサポートされていないテキストを入力した場合、そのテキストは再生されません。ただし、プロンプト内の他のサポートされているテキストはすべて再生されます。サポートされている言語のリストについては、「[Amazon Polly でサポートされる言語](https://docs.aws.amazon.com/polly/latest/dg/SupportedLanguage.html)」を参照してください。

# Amazon Polly で SSML タグを使用してテキスト読み上げ機能をパーソナライズする
<a name="ssml-prompt"></a>

フローにプロンプトを追加すると、SSML タグを使用して顧客に合わせてよりパーソナライズされたエクスペリエンスを提供できます。SSML タグで、提供したテキストから Amazon Polly が音声を生成する方法を制御します。

テキスト読み上げ機能を解釈するためのフローブロックのデフォルト設定は、**[Text]** (テキスト) です。フローブロックのテキスト読み上げ機能に SSML を使用するには、次の図に示すように、**[Interpret as]** (解釈する] フィールドを **[SSML]** に設定します。

![\[テキスト読み上げの [Interpret as] (解釈する) フィールドが SSML に設定されていることを示すフローブロックの設定図\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/connect-interpret-as-ssml.png)


# Amazon Connect チャット会話の SSML タグ
<a name="chat-and-ssml-tags"></a>

テキスト読み上げテキストを作成して SSML タグを適用すると、SSML タグはチャット会話で解釈されません。例えば、次の図では、テキスト **とタグ** の両方がチャット会話で出力されます。

![\[[テキスト読み上げ] ボックスの SSML タグ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/ssml-tags-in-prompt.png)


# Amazon Connect でサポートされている SSML タグ
<a name="supported-ssml-tags"></a>

Amazon Connect は、次の SSML タグをサポートしています。

**ヒント**  
入力テキストでサポートされていないタグを使用すると、処理時に自動的に無視されます。


| タグ | ...を使用して: | 
| --- | --- | 
|  speak  |  SSML 拡張テキストはすべて <speak> タグで囲まれている必要があります。  | 
|  break  |  テキストに一時停止を追加します。一時停止の最大継続時間は 10 秒です。  | 
|  lang  |  特定の単語に別の言語を指定します。  | 
|  mark  |  テキスト内にカスタムタグを配置します。  | 
|  p  |  テキストの段落間に一時停止を追加します。  | 
| phoneme | 特定のテキストに音声発音を作成します。 | 
| prosody | 選択した音声の音量、速度、ピッチを制御します。 | 
| s | テキストの行または文章間に一時停止を追加します。 | 
| say-as | 特定の文字、単語、および数字の読み方を Amazon Polly に指示するには、interpret-as 属性と組み合わせます。 | 
| sub | 頭字語や略語などの選択したテキストを別の単語 (または発音) に置き換えるには、alias 属性と組み合わせます。 | 
| w | 単語の発音をカスタマイズするには、単語の品詞または別の意味を指定します。 | 
| amazon:effect name="whispered" | 入力テキストを通常の音声ではなく、ささやき声で読み上げることを表します。 | 

入力テキストでサポートされていないタグを使用すると、処理時に自動的に無視されます。

SSML タグの詳細については、Amazon Polly デベロッパーガイドの「[Supported SSML Tags](https://docs.aws.amazon.com/polly/latest/dg/supportedtags.html)」を参照してください。

## ニューラル型と会話型の話し方
<a name="neural-and-conversational-tts"></a>

アメリカ英語 (en-US) の **Joanna** と **Matthew** のニューラル音声では、[ニュースキャスターの話し方](https://docs.aws.amazon.com/polly/latest/dg/ntts-speakingstyles.html)を指定することもできます。