Amazon Connect CCP ソフトフォンのエラーのトラブルシューティング方法を教えてください。

最終更新日: 2021 年 1 月 6 日

エンドポイントに接続できないというソフトフォンエラーが Amazon Connect コンタクトコントロールパネル (CCP) に表示されます。この問題を解決する方法を教えてください。

簡単な説明

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

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

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

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

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

“softphone ERROR {your contact ID} SESSION Failed connecting to signaling server Timeout”

“softphone ERROR Softphone error occurred : signalling_connection_failure URL {signaling endpoint URL} cannot be reached.”

“softphone WARN {your contact ID} SESSION ICE collection timed out”

“softphone ERROR {your contact ID} SESSION No ICE candidate”

“softphone INFO {your contact ID} SESSION ConnectSignalingAndIceCollectionState => FailedState”

“softphone ERROR Softphone error occurred : ice_collection_timeout Ice collection timedout.”

“ccp ERROR 'acceptContact' API request failed: [object 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.com
3478
(UDP)
API

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