【Amazon Connect】S3に格納した音声プロンプトを再生する設定と活用アイデア

Amazon Connectの問い合わせフロー内でAmazon S3へ保存した音声ファイルを利用することができるようになりました。
動作を試すとともに、この機能の活用案を考えてみます。

概要
設定
動作確認
- 成功時
- 失敗時
活用案
最後に
- 参考リンク

概要

従来の機能でも、あらかじめ任意の音声ファイルをAmazon Conenctの管理画面からアップロード、利用することはできましたし、テキスト読み上げ機能を利用することでお客様のお名前の読み上げる、等の動的な挙動も実現可能でした。

今回のアップデートによって、さらに柔軟に、下記のような要求にこたえられるようになります。

既存の音声ガイドシステムとオンデマンドに連携したい
音声ガイドを定期的・それなりの頻繁で大量に入れ替えたい
サードパーティーのテキスト読み上げ音声を動的に利用したい

設定

S3バケットの準備

音声プロンプトファイルを保存するS3バケットを作成します。
各種設定については、今回は初期値のまま作成しました。

ACL無効
パブリックアクセスをすべてブロック
サーバー側の暗号化:無効

作成したS3バケットのバケットポリシーを設定します。
下記JSONの customer-prompt-example-bucket をバケット名に、
Condition 部分の SourceAccount、SourceArn部分へ、利用するAWSアカウントID、Amazon ConnectインスタンスARNをそれぞれ設定します。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "statement1",
            "Effect": "Allow",
            "Principal": {
                "Service": "connect.amazonaws.com"
            },
            "Action": [
                "s3:ListBucket",
                "s3:GetObject"
            ],
            "Resource": [
                "arn:aws:s3:::customer-prompt-example-bucket",
                "arn:aws:s3:::customer-prompt-example-bucket/*"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "account-id",
                    "aws:SourceArn": "arn:aws:connect:region:account-id:instance/instance-id"
                }
            }
        }
    ]
}

f:id:swx-shinsaka:20220406190240p:plain

音声ファイルのアップロード

音声ファイルはサンプリングレート（サンプリング周波数）8KHz、ビット深度（ビットレート）8bit、モノラル（1チャンネル）、音声フォーマットは μ-lawで準備します。

上記S3バケットへ音声ファイルをアップロードします。
今回はプレフィックスをつけて connect/hello.wav としました。

f:id:swx-shinsaka:20220406191241p:plain

問い合わせフローを作成

プロンプトの作成ブロックを設置し、「S3バケットから音声ファイルを指定」を選択、S3ファイルパスを入力します。

今回は最もシンプルな S3 URI形式で指定しましたが、https://で始まるオブジェクトURL形式も可です。
または、それを属性値としてセットしても良いですし、ファイルパス部分で変数を記述して連結した記述も可能となっていますので、動的に変化させたいケースでも柔軟に対応できそうです。

f:id:swx-shinsaka:20220406192635p:plain

動作確認

電話を掛け、指定した音声が再生されることを確認できました。
念のため、CloudWatchLogs へ出力された問い合わせフローログを確認します。

成功時

ログは2行出力されました。
1行目で取得元のS3オブジェクトを確認できます。
2行目は音声再生結果が成功したことを確認できます。

{
    "ContactId": "xxxxx",
    "ContactFlowId": "arn:aws:connect:ap-northeast-1:123456789012:instance/yyyyy/contact-flow/zzzzz",
    "ContactFlowName": "InboundS3Prompt",
    "ContactFlowModuleType": "PlayPrompt",
    "Timestamp": "2022-04-06T10:24:29.406Z",
    "Parameters": {
        "PromptLocation": "s3://my-prompts/connect/hello.wav",
        "PromptSource": "S3"
    }
}
{
    "Results": "Success",
    "ContactId": "xxxxx",
    "ContactFlowId": "arn:aws:connect:ap-northeast-1:123456789012:instance/yyyyy/contact-flow/zzzzz",
    "ContactFlowName": "InboundS3Prompt",
    "ContactFlowModuleType": "PlayPrompt",
    "Timestamp": "2022-04-06T10:24:31.178Z"
}

失敗時

1行目は成功時と同様、2行目は失敗したことがわかります。
なお、失敗した場合は問い合わせフローの「エラー」へ分岐します。

{
    "ContactId": "xxxxx",
    "ContactFlowId": "arn:aws:connect:ap-northeast-1:123456789012:instance/yyyyy/contact-flow/zzzzz",
    "ContactFlowName": "InboundS3Prompt",
    "ContactFlowModuleType": "PlayPrompt",
    "Timestamp": "2022-04-06T07:58:36.991Z",
    "Parameters": {
        "PromptLocation": "s3://my-prompts/connect/hello.wav",
        "PromptSource": "S3"
    }
}
{
    "Results": "Failed To Play Prompt.",
    "ContactId": "xxxxx",
    "ContactFlowId": "arn:aws:connect:ap-northeast-1:123456789012:instance/yyyyy/contact-flow/zzzzz",
    "ContactFlowName": "InboundS3Prompt",
    "ContactFlowModuleType": "PlayPrompt",
    "Timestamp": "2022-04-06T07:58:37.258Z"
}