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

所要時間2分

エンドポイントに接続できないというソフトフォンエラーが Amazon Connect Contact Control Panel (CCP) に表示されます。

簡単な説明

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

これらのエラーは、次の例のように、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.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 インスタンスの場所に置き換えてください。詳細については、「ネットワークをセットアップする」を参照してください。

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