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

간략한 설명

Amazon Connect CCP가 다음과 같은 필수 엔드포인트 중 하나와 통신할 수 없을 때 소프트폰 오류가 발생합니다.

• 신호 엔드포인트
• 미디어 엔드포인트
• API 엔드포인트

해결 방법

Amazon CCP에서 소프트폰 오류를 해결하려면 다음 작업을 수행하십시오.

• 오류 메시지에 있는 엔드포인트 도메인에 대한 트래픽이 차단되었는지 확인합니다. 트래픽이 차단된 경우 Amazon Elastic Compute Cloud(Amazon EC2) 및 Amazon CloudFront IP 범위 요구 사항을 도메인 허용 목록으로 대체합니다.
• 오류 메시지에 있는 엔드포인트 도메인의 필수 포트가 네트워크 방화벽에 열려 있는지 확인합니다.
• IP 주소 범위를 허용하는 경우 Amazon Connect에서 사용하는 모든 IP 주소가 필수 허용 목록에 있는지 확인합니다.
• 네트워크 연결을 통해 Amazon Connect CCP가 필요한 엔드포인트와 연결을 유지할 수 있는지 확인합니다.
• Amazon Connect 엔드포인트 테스트 유틸리티를 사용하여 문제가 있는 에이전트의 연결이 안정적인지 확인합니다.
• Amazon Connect와 신호 엔드포인트, 미디어 엔드포인트 및 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"

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

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

자세한 내용은 최신 Amazon Connect Contact Control Panel(CCP)로 업그레이드를 참조하십시오.

미디어 엔드포인트

다음 오류 메시지는 발생할 수 있는 미디어 엔드포인트 오류의 예입니다.

• "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"

미디어 엔드포인트와 통신하려면 **포트 3478(UDP)**을 통해 TurnNlb-*.elb.REGION.amazonaws.com URL을 허용 목록에 추가하십시오.

API 엔드포인트

다음 오류 메시지는 발생할 수 있는 API 엔드포인트 오류의 예입니다.

• "ccp ERROR 'acceptContact' API request failed: [object Object]"
• "ccp TRACE AWSClient: < Operation 'acceptContact' failed: {"message":"Network Failure","code":"NetworkingError","time":"....""

참고: 원시 CCP 로그를 사용자에게 친숙한 형식으로 변환하려면 CCP 로그 파서를 사용하십시오. 자세한 내용은 GitHub 웹 사이트의 CCP 로그 파서를 참조하십시오.

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

참고: INSTANCE_NAME을 인스턴스 이름으로 바꾸십시오. REGION을 Amazon Connect 인스턴스가 있는 AWS 리전으로 바꾸십시오. 자세한 내용은 Amazon Connect Contact Control Panel(CCP)을 사용하도록 네트워크 설정을 참조하십시오.

관련 정보

Contact Control Panel(CCP) 관련 문제 해결