Amazon Connect のアウトバウンドキャンペーンに関する問題をトラブルシューティングする方法を教えてください。
Amazon Connect のアウトバウンドキャンペーンに関する問題をトラブルシューティングしたいと考えています。
解決策
注: AWS コマンドラインインターフェイス (AWS CLI) コマンドの実行中にエラーが発生した場合は、「AWS CLI で発生したエラーのトラブルシューティング」を参照してください。また、AWS CLI の最新バージョンを使用していることを確認してください。
前提条件:
アウトバウンドキャンペーンの国と地域を確認する
アウトバウンドキャンペーンは、サポート対象の国および AWS リージョン内の送信先番号にのみ発信できます。キャンペーンに使用する発信元の電話番号は、送信先の電話番号と同じ国のものである必要があります。
注: オーストラリアとニュージーランドでのアウトバウンドキャンペーンでは、専用の電話番号が必要です。メキシコにキャンペーンを発信するには、大容量アウトバウンド通信 (HVOC) 番号を使用する必要があります。専用の電話番号とキャンペーンをリクエストするには、AWS サポートケースを作成する必要があります。詳細については、「よくある質問」参照してください。
アウトバウンドコンタクトを確認する
アウトバウンドコンタクトのトラブルシューティングを行うには、Amazon Connect インスタンス経由でコールを発信しており、そのコールが送信先に到達できることを確認します。まず、AWS CloudTrail イベント履歴を参照し、StartOutboundVoiceContact API の有無を確認します。StartOutboundVoiceContact が表示されている場合、リクエストは Amazon Connect に正常に到達しています。StartOutboundVoiceContact がない場合は、Amazon Pinpoint などのイニシエーターに問題があります。
注: 進行中の通話は、[連絡先の検索] ページにも表示される場合があります。AWS CLI コマンド describe-contact を実行し、特定の連絡先 ID に対するコールが成功したかどうかを確認します。呼び出しが進行中の場合、DisconnectTimestamp はコマンド出力に表示されません。
Amazon Pinpoint と Amazon Connect で StartOutboundVoiceContact が生成されたかどうかを確認するには、コンタクトレコードを参照します。Amazon Pinpoint のプロセスが生成したコンタクト ID のリストを表示するには、[開始メソッド: API] フィルターを適用します。
注: イベントデータを Amazon Kinesis または Amazon Data Firehose にストリーミングする設定を Amazon Pinpoint で行うことを推奨します。詳細については、「Amazon Pinpoint のイベントを Kinesis にストリーミングする」を参照してください。また、Amazon Simple Storage Service (Amazon S3) で送信先設定を行い、Firehose にイベントを送信することも推奨されます。
CloudTrail イベントにおいて、StartOutboundVoiceContact イベントで LimitExceededException エラーコードが発生している場合、アウトバウンドコンタクトのクォータに達しています。この問題を解決するには、アクティブな同時キャンペーンコールについて、インスタンスクォータの増加をリクエストしてください。
重要: 2026 年 10 月 30 日に、AWS は Amazon Pinpoint のサポートを終了します。
アウトバウンドコールでの障害のトラブルシューティング
アウトバウンドコールが失敗した場合、連絡先を検索してもコンタクト ID は表示されません。コールが失敗したかどうかを確認するには、describe-contact コマンドを実行し、特定のコンタクト ID に対してコールが成功したかどうかを判断します。InitiationTimestamp と DisconnectTimestamp の差が数ミリ秒の場合、コールは正常に行われていません。
キャンペーンのクォータに達している場合、アウトバウンドコールが失敗する可能性があります。
キャンペーンのクォータに達したかどうかを確認するには、次の手順を実行します。
- Amazon CloudWatch コンソールを開きます。
- ナビゲーションペインで [メトリクス] を選択した後、[すべてのメトリクス] を選択します。
- [Amazon Connect] を選択し、[インスタンスのメトリクス] を選択します。
- CallsBreachingConcurrencyQuota メトリクスおよび ThrottledCalls メトリクスを確認します。
CallsBreachingConcurrencyQuota または ThrottledCalls メトリクスにカウントが含まれている場合は、サービスクォータに達している可能性があります。この問題を解決するには、クォータの増加をリクエストしてください。
各インスタンスのキャンペーンコールまたは同時コールがクォータに達した場合、Amazon Connect によりコールがブロックされます。次の例では、Amazon Connect インスタンスの現在のコールクォータは 10 で、キャンペーンコールのクォータは 5 に設定されています。
同時コールのクォータ
Amazon Connect インスタンスで 7 件のインバウンドコールが進行中で、4 件のアウトバウンドキャンペーンコールを発信しています。同時コールクォータである 10 件に達しているため、4 件目のコールは失敗します。
キャンペーンコールのクォータ
Amazon Connect インスタンスで 4 件のインバウンドコールが進行中で、6 件のアウトバウンドキャンペーンコールを発信しています。キャンペーンコールの上限である 5 件に達しているため、6 件目のコールは失敗します。
関連情報
- 言語
- 日本語
関連するコンテンツ
- 質問済み 1年前
