Amazon Connect CCP ソフトフォンのエラーをトラブルシューティングするにはどうすればよいですか?

最終更新日: 2021 年 10 月 20 日

エンドポイントに接続できないというソフトフォンエラーが Amazon Connect Contact Control Panel (CCP) に表示されます。これらのエラーを修正するにはどうすればよいですか?

簡単な説明

Amazon Connect CCP エンドポイントエラーには、次の 3 種類があります。

  • シグナリングエンドポイントエラー
  • メディアエンドポイントエラー
  • API エンドポイントエラー

これらのエラーは、次の例のように、Amazon Connect CCP ログソフトフォンエラーとして表示されます。

注: CCP Log Parser を使用して、生の CCP ログをより読みやすい形式に変換できます。詳細については、GitHub の CCP Log Parser を参照してください。

Amazon Connect CCP ソフトフォンエラーの例

シグナリングエンドポイントエラー メディアエンドポイントエラー API エンドポイントエラー

「ソフトフォン ERROR {コンタクト ID} SESSION シグナリングサーバーへの接続に失敗しました タイムアウト」

「ソフトフォン ERROR ソフトフォンエラーが発生しました: signalling_connection_failure URL {シグナリングエンドポイント URL} に到達できません。」

「ソフトフォン WARN {コンタクト ID} SESSION ICE 収集がタイムアウトしました」

「ソフトフォン ERROR {コンタクト ID} SESSION ICE 候補がありません」

「ソフトフォン INFO {コンタクト ID} SESSION ConnectSignalingAndIceCollectionState => FailedState」

「ソフトフォン ERROR ソフトフォンエラーが発生しました: ice_collection_timeout Ice コレクションがタイムアウトしました。」

「ccp ERROR 'acceptContact' API リクエストが失敗しました: [オブジェクト Object]」

「ccp TRACE AWSClient: < Operation 'acceptContact' failed: {"message":"Network Failure","code":"NetworkingError","time":"...."」

ソフトフォンエラーは、Amazon Connect CCP が次の必須エンドポイントと通信できない場合に発生します。

必須の Amazon Connect CCP エンドポイント

エンドポイントタイプ ドメイン/URL 許可リスト ポート
シグナリング

CCP v1 の場合:

rtc*.connect-telecom.{region}.amazonaws.com

CCP v2 の場合:

*.transport.connect.{region}.amazonaws.com

詳細については、Upgrade to the latest CCP を参照してください。

443
(TCP)
メディア TurnNlb-*.elb.{region}.amazonaws.com 3478
(UDP)
API

*.telemetry.connect.{region}.amazonaws.com

新規: 許可リストにさらに追加するドメイン

{myInstanceName}.my.connect.aws/ccp-v2

{myInstanceName}.my.connect.aws/api

*.static.connect.aws

以前の必須項目:

{myInstanceName}.awsapps.com/connect/ccp-v2

{myInstanceName}.awsapps.com/connect/api

*.cloudfront.net

443
(TCP)

重要: 各ドメインの {region} を Amazon Connect インスタンスの場所に置き換えてください。詳細については、「ネットワークをセットアップする」を参照してください。

解決方法

  1. エラーメッセージに示されたエンドポイントドメインへのトラフィックがブロックされていないことを確認します。詳細については、「 Amazon EC2 および CloudFront IP 範囲の要件をドメイン許可リストに置き換える 」を参照してください。
  2. エラーメッセージに記載されているエンドポイントドメインに必要なポートがネットワークファイアウォールで開いていることを確認します。詳細については、Replace Amazon EC2 and CloudFront IP range requirements with a domain allow list を参照してください。
  3. IP アドレスの範囲を許可する場合は、Amazon Connect で使用されるすべての IP アドレスが必須の許可リストに含まれていることを確認してください。詳細については、Allow IP address ranges を参照してください。
  4. Amazon Connect CCP が必要なエンドポイントとの接続を維持できるだけの十分なネットワーク接続が安定していることを確認します。

この記事はお役に立ちましたか?


請求に関するサポートまたは技術サポートが必要ですか?