AWS re:Postを使用することにより、以下に同意したことになります 利用規約

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

所要時間2分
0

エンドポイントに接続できないというソフトフォンエラーが 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 詳細については、「最新の CCP へのアップグレード」を参照してください。443(TCP)
メディアTurnNlb-*.elb.{region}.amazonaws.com3478(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.net443(TCP)

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

解決方法

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

関連情報

CCP の問題のトラブルシューティング

Set up your network

AWS公式
AWS公式更新しました 3ヶ月前