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)을 사용하도록 네트워크 설정을 참조하십시오.

관련 정보

연락 제어판(CCP) 관련 문제 해결