Voicemail Express for Amazon Connect での問題をトラブルシューティングする方法を教えてください。

所要時間2分

Amazon Connect のソリューション Voicemail Express での問題をトラブルシューティングしたいです。

解決策

Voicemail Express for Amazon Connect は、Amazon Connect に自動ボイスメール機能を提供します。詳細については、GitHub のウェブサイトで「Voicemail Express V3」を参照してください。問題に基づいて、次のセクションに記載した手順を実行してください。

注: Voicemail Express for Amazon Connect は、AWS Lambda のログ記録を使用します。問題のトラブルシューティングを行う際に詳細情報を出力するには、ログレベルを変更する必要がある場合があります。

エージェントがボイスメールとトランスクリプトを受信していない

AWS CloudFormation スタックの起動時には、配信メールアドレス (VMToEmailDefaultFrom) のパラメータを入力する必要があります。コンタクトフローで email_from 属性を指定していない場合、Voicemail Express はデフォルトの From メールアドレスを使用します。ボイスメールとトランスクリプトのメールを受信するには、配信メールアドレスを確認する必要があります。

コンタクトフローには次の属性を設定する必要があります。

vmx3_mode 属性は、email に設定する必要があります。
entity_type 属性は agent に設定する必要があります。エージェントのメールアドレスは、Amazon Connect ユーザー管理で追加したものである必要があります。

ログがメールは送信されたが受信されなかったことを示している場合は、Amazon Simple Email Service (Amazon SES) のイベント発行を有効化し、配信の問題の詳細を確認します。

エージェントがボイスメールとトランスクリプトに関するタスクを受信していない

タスクに対し、コンタクトフローで次の属性が設定されている必要があります。

vmx3_mode 属性は、task に設定する必要があります。
タスクを実行するには、vmx3_task_flow 属性を有効なフローに設定する必要があります。
ルーティングプロファイルには、チャネル設定で有効にしたタスクが必要です。

キューがボイスメールとトランスクリプトのメールを受信していない

キューがボイスメールや通話のトランスクリプトを受信していない場合は、コールフローの設定を確認します。vmx3_queue_email 属性の値が、標準キュータグの email 値であることを確認します。vmx3_mode 属性も email に設定する必要があります。

オーディオファイルが Amazon S3 バケットで生成されない

Voicemail Express を使用して Amazon Kinesis Video Stream のオーディオからボイスメールを抽出し、そのファイルを Amazon Simple Storage Service (Amazon S3) に書き込みます。Voicemail Express は、Amazon Connect の連絡先レコードを Lambda 関数に対する Amazon Kinesis トリガーとして使用します。関数を開始させるには、コンタクトトレースレコード (CTR) が Kinesis トリガーのフィルター条件を満たしている必要があります。

オーディオファイルが確実に生成されるようにするには、次のタスクを実行します。

ライブメディアストリーミングオプションを有効化し、保持期間を 1 時間より大きい値に設定します。詳細については、GitHub のウェブサイトで「Voicemail Express の前提条件」を参照してください。
Kinesis トリガーを更新し、Lambda 関数 VMX3-KVStoS3-XXXX でアクティブ化するようにします。
vmx3_flag 属性を、フローで 1 の値に設定します。詳細については、GitHub のウェブサイトで「Voicemail Express の概要」を参照してください。

トランスクリプトが Amazon S3 バケットで生成されない

Voicemail Express は、オーディオが Amazon S3 に保存されるときに Amazon EventBridge イベントを使用して Lambda 関数を起動します。Lambda 関数 VMX3-Transcriber-XXXX が音声からトランスクリプトを生成し、そのトランスクリプトを Amazon S3 に保存します。Lambda 関数が失敗すると、VMX3-TranscribeErrorHandler-XXXX 関数が起動します。Lambda ログを確認し、関数が失敗する理由を特定します。

トランスクリプトが確実に生成されるようにするには、次のタスクを実行します。

EventBridge トリガーを更新し、VMX3-Transcriber-XXXX でアクティブ化するようにします。
Lambda 関数 VMX3-KVStoS3-XXXX がオーディオファイルを生成し、そのオーディオファイルが S3 バケットにあることを確認します。

CloudFormation スタックのデプロイに問題がある

CloudFormation スタックのデプロイに問題がある場合は、CloudFormation スタックのイベントでエラーメッセージを確認します。エラーメッセージは次の例のような形式です。

CREATE_FAILED, ROLLBACK_COMPLETE.

詳細については、「CloudFormation コンソールでスタック情報を確認する」を参照してください。