Amazon Connect CCP 소프트폰 오류를 해결하려면 어떻게 해야 합니까?

간략한 설명

Amazon Connect CCP 엔드포인트 오류에는 세 가지 유형이 있습니다. 이러한 오류는 모두 Amazon Connect CCP 로그에 소프트폰 오류로 나타나며 다음 예와 비슷합니다.

신호 엔드포인트 오류

이러한 오류에는 다음 예가 포함됩니다.

• “소프트폰 오류 {연락처 ID} 세션 신호 서버에 연결하지 못했습니다. 시간 초과”
• “소프트폰 오류 소프트폰 오류가 발생했습니다. 신호_연결_실패 URL {신호 엔드포인트 URL}에 연결할 수 없습니다.“

미디어 엔드포인트 오류

이러한 오류에는 다음 예가 포함됩니다.

• “소프트폰 경고 {연락처 ID} 세션 ICE 수집 시간이 초과되었습니다.”
• “소프트폰 오류 {연락처 ID} 세션 번호 ICE 후보 없음”
• “소프트폰 정보 {연락처 ID} 세션 ConnectSignalingAndIceCollectionState => FailedState”
• “소프트폰 오류 소프트폰 오류 발생: ice_collection_timeout Ice 수집 시간이 초과되었습니다.“

엔드포인트 오류

이러한 오류에는 다음 예가 포함됩니다.

• "ccp 오류 'acceptContact' API 요청 실패: [object Object]"
• "ccp TRACE AWSClient: < 작업 'acceptContact' 실패: {"message":"네트워크 장애","code":"NetworkingError","time":"....""

참고: 원시 CCP 로그를 보다 읽기 쉬운 형식으로 변환하려면 CCP 로그 파서를 사용하세요. 자세한 내용은 GitHub의 CCP 로그 파서를 참조하세요.

해결 방법

Amazon Connect와 엔드포인트 간의 통신을 확인합니다.

Amazon Connect CCP가 다음과 같은 필수 엔드포인트 중 하나 이상과 통신할 수 없을 때 소프트폰 오류가 발생합니다.
참고: INSTANCE_NAME을 사용자의 인스턴스 이름으로 바꿉니다. 리전을 사용자의 Amazon Connect 인스턴스 위치로 바꿉니다. 자세한 내용은 네트워크 설정을 참조하세요.

신호 엔드포인트
신호 엔드포인트와 통신하려면 **포트 443(TCP)**을 통해 허용 목록에 다음 URL을 추가하세요.

• CCP v1의 경우: rtc*.connect-telecom.REGION.amazonaws.com
• CCP v2의 경우: *.transport.connect.REGION.amazonaws.com

자세한 내용은 최신 ](https://docs.aws.amazon.com/connect/latest/adminguide/upgrade-to-latest-ccp.html) CCP로 [ 업그레이드를 참조하세요.
미디어 엔드포인트
미디어 엔드포인트와 통신하려면 **포트 3478(UDP)**을 통해 허용 목록에 다음 URL을 추가하세요.

• TurnNlb-*.elb.REGION.amazonaws.com

API 엔드포인트
API 엔드포인트와 통신하려면 ** 포트 443(TCP)**을 통해 허용 목록에 다음 URL을 추가하세요.

• *.telemetry.connect.REGION.amazonaws.com
• INSTANCE_NAME.my.connect.aws/ccp-v2
• INSTANCE_NAME.my.connect.aws/api
• *.static.connect.aws
• INSTANCE_NAME.awsapps.com/connect/ccp-v2
• INSTANCE_NAME.awsapps.com/connect/api
• *.cloudfront.net

추가 고려 사항

1. 오류 메시지에 나열된 엔드포인트 도메인으로의 트래픽을 차단하는 것이 없는지 확인합니다. 자세한 내용은 Amazon EC2 및 CloudFront IP 범위 요구 사항을 도메인 허용 목록으로 바꾸기를 참조하세요.
2. 오류 메시지에 나열된 엔드포인트 도메인의 필수 포트가 네트워크 방화벽에 열려 있는지 확인합니다. 자세한 내용은 Amazon EC2 및 CloudFront IP 범위 요구 사항을 도메인 허용 목록으로 바꾸기를 참조하세요.
3. IP 주소 범위를 허용하는 경우 Amazon Connect에서 사용하는 모든 IP 주소가 필수 허용 목록에 있는지 확인하세요. 자세한 내용은 IP 주소 범위 허용을 참조하세요.
4. Amazon Connect CCP가 필요한 엔드포인트와 연결을 유지할 수 있을 만큼 네트워크 연결이 안정적인지 확인하세요.

관련 정보

CCP(접촉 제어판) 관련 문제 해결

네트워크 설정