Salesforce Voice에서 Amazon Connect의 오류 해결
참조 목록에 대해 소프트폰 오류 메시지 및 콘솔 로그 오류를 확인하여 담당자의 통화를 성공적으로 만들기 위해 취해야 할 조치를 확인합니다. 다음 오류 및 메시지는 Amazon Connect에서 생성되었지만 Salesforce Voice에서 사용할 수 있습니다.
필수 Edition
필수 Edition
| 지원되는 Edition을 확인하세요. |
이 기사는 다음에 적용됩니다.
- Amazon Connect를 사용하는 Salesforce Voice
- Amazon Connect의 파트너 전화 통신을 사용하는 Salesforce Voice
설정 및 액세스 문제에 대한 소프트폰 오류
해당 설정 오류 및 메시지는 담당자가 옴니채널 소프트폰에서 볼 수 있습니다. 오류가 트리거되면 브라우저 콘솔에 해당 콘솔 로그 레이블이 표시됩니다.
| 소프트폰 오류 | 콘솔 로그 레이블 | 나타나는 이유 | 수행할 작업 |
|---|---|---|---|
| SSO를 통해 인증할 수 없습니다. 브라우저를 새로 고치거나 Salesforce 관리자에게 도움을 요청하십시오. | AUTH_RETRIES_EXHAUSTED |
이전에 담당자가 성공적으로 로그인했습니다. 백그라운드에서 실행되는 Amazon Connect 연락처 제어판(CCP)에서 싱글사인온(SSO)이 성공했습니다. 그러나 연결 또는 세션이 반복적으로 실패하고 시스템에서 이 세션에 대한 인증 시도를 중지했습니다. 만료되거나 유효하지 않은 세션 또는 토큰이 있는 경우 또는 토큰 새로 고침에 실패한 경우 이 상황이 발생할 수 있습니다. SAML 또는 SSO 로그인 실패로 인해 발생할 수도 있습니다. 가능한 원인은 |
담당자에게 브라우저를 새로 고치도록 요청합니다. 담당자에게 현재 상태를 사용 가능으로 선택하여 옴니채널에 다시 로그인하도록 요청합니다. Salesforce Voice 문제 해결의 옴니채널 로그인 및 SSO 문제 해결 방법 섹션에서 권장 사항을 따르십시오. 구성을 확인했지만 문제가 지속되는 경우 전화 통신 모델에 따라 ID 공급자(IdP) 관리자에게 Salesforce 지원 또는 Amazon 지원에 문의해달라고 요청하십시오. |
| SSO 인증 세션이 만료되었습니다. 브라우저를 새로 고칩니다. 문제가 지속될 경우 현재 상태를 업데이트하여 옴니채널에서 로그아웃한 후 다시 사용 가능한 상태로 로그인합니다. | AUTH_SESSION_EXPIRED |
이전에 담당자가 성공적으로 로그인했습니다. 백그라운드에서 실행되는 Amazon Connect 연락처 제어판(CCP)에서 SSO가 성공했습니다. 그러나 연결 또는 세션이 만료되었습니다. 만료되거나 유효하지 않은 세션 또는 토큰이 있는 경우 또는 토큰 새로 고침에 실패한 경우 이 상황이 발생할 수 있습니다. SAML 또는 SSO 로그인 실패로 인해 발생할 수도 있습니다. 가능한 원인은 |
담당자에게 브라우저를 새로 고치도록 요청합니다. 담당자에게 현재 상태를 사용 가능으로 선택하여 옴니채널에 다시 로그인하도록 요청합니다. Salesforce Voice 문제 해결의 옴니채널 로그인 및 SSO 문제 해결 방법 섹션에서 권장 사항을 따르십시오. 구성을 확인했지만 문제가 지속되는 경우 전화 통신 모델에 따라 ID 공급자 관리자에게 Salesforce 지원 또는 Amazon 지원에 문의해달라고 요청하십시오. |
| SSO 인증에서 필수 액세스 권한을 제공하지 않았습니다. Salesforce 관리자에게 Amazon Connect에서 사용자 구성을 확인해달라고 요청하십시오. | CONNECTOR_ACCESS_DENIED |
Amazon Connect가 403 금지됨 또는 유사한 상태 코드로 응답했습니다. 사용자가 인증되었지만 요청된 작업을 수행할 수 없습니다. 이 오류는 인증 실패가 아닌 인증 실패로 인해 발생합니다. 이 상황은 담당자에게 작업에 대한 IAM 또는 Amazon Connect 권한이 없거나 보안 프로필 또는 라우팅 프로필이 잘못 구성된 경우 발생할 수 있습니다. |
다음 문제 해결 팁을 시도하고 자세한 내용은 Amazon Connect 권한 및 보안 프로필 문서를 참조하십시오.
네트워크 유효성을 검사한 후 문제가 지속되는 경우 네트워크 팀에 Salesforce 지원팀 또는 Amazon 지원팀에 문의해달라고 요청하십시오. 전화 모델에 따라 |
| 브라우저에서 마이크를 활성화합니다. | microphone_not_shared |
담당자가 Salesforce Voice 소프트폰을 실행하는 사이트의 브라우저 설정에 마이크가 활성화되어 있지 않은 경우 | Chrome의 경우 Chrome에서 카메라 및 마이크 사용을 참조하십시오. Firefox를 사용하는 경우에는 Firefox 페이지 정보 창을 참조하십시오. 마이크 권한 설정을 업데이트한 후 Salesforce 앱을 다시 로드합니다. |
| 네트워크 문제가 있습니다. Salesforce 관리자에게 네트워크 구성을 확인해달라고 요청하십시오. (E-1016) | signalling_handshake_failure |
Amazon Connect 소프트폰은 WebRTC에 대한 초기 신호 연결을 설정할 수 없습니다. 이 상황은 WebSocket 연결을 차단하는 방화벽, 네트워크 프록시 문제, 제한적인 보안 정책 또는 기타 네트워크 구성 문제로 인해 발생할 수 있습니다. |
다음 문제 해결 단계를 시도하고 자세한 내용은 Amazon Connect 네트워크 요구 사항을 참조하십시오.
네트워크 유효성을 검사한 후 문제가 지속되는 경우 네트워크 팀에 Salesforce 지원팀 또는 Amazon 지원팀에 문의해달라고 요청하십시오. 전화 모델에 따라 |
| 네트워크 문제가 있습니다. Salesforce 관리자에게 네트워크 구성을 확인해달라고 요청하십시오. (E-1017) | signalling_connection_failure |
내부 연결 오류로 인해 Amazon Connect 소프트폰에서 WebRTC에 대한 초기 신호 연결을 설정할 수 없습니다. 이 상황은 WebSocket 연결을 차단하는 방화벽, 네트워크 프록시 문제, 제한적인 보안 정책 또는 기타 네트워크 구성 문제로 인해 발생할 수 있습니다. |
다음 문제 해결 단계를 시도하고 자세한 내용은 Amazon Connect 네트워크 요구 사항을 참조하십시오.
네트워크 유효성을 검사한 후 문제가 지속되는 경우 네트워크 팀에 Salesforce 지원팀 또는 Amazon 지원팀에 문의해달라고 요청하십시오. 전화 모델에 따라 |
| 이 브라우저는 지원되지 않습니다. 다른 브라우저로 다시 시도하십시오. | unsupported_browser |
담당자가 지원되지 않는 브라우저를 사용하고 있습니다. Voice는 안정적인 최신 브라우저 버전인 Google Chrome, Mozilla Firefox, Microsoft Edge(Chromium)만 지원합니다. | 담당자에게 브라우저를 변경하거나 업데이트해달라고 요청합니다. |
| Chrome 및 Firefox와 같은 다른 브라우저에서 로그인한 것처럼 보입니다. 한 번에 하나의 브라우저에서 Salesforce Voice에 액세스합니다. | user_busy_error |
담당자는 동시에 두 개의 고유한 브라우저에서 실행되는 Amazon Connect 연락처 제어판(CCP)을 보유하고 있습니다. 담당자가 옴니채널에 로그인하면 Salesforce가 백그라운드에서 CCP를 로드합니다. | 담당자에게 한 번에 하나의 브라우저를 사용하여 옴니채널에 로그인하도록 요청합니다. |
| 음성 통화 VDI 설정에 문제가 있는 것 같습니다. 브라우저를 새로 고친 다음, Salesforce 관리자에게 코드 E-1019에 대한 도움을 요청하십시오. | vdi_redir_not_supported |
담당자가 Citrix 오디오 리디렉션을 사용하려고 하지만 Citrix 환경에서는 이 기능을 지원하지 않습니다. 오디오 리디렉션을 사용하면 담당자의 음성이 로컬 장치에서 Amazon Connect(가상 데스크톱 우회)로 직접 이동하여 통화 품질을 향상할 수 있습니다. | Citrix 환경이 요구 사항을 충족하는지 확인하려면 Amazon Connect 관리자 가이드에서 Citrix 클라우드 데스크탑용 Amazon Connect 오디오 최적화를 참조하십시오. |
| 음성 통화 VDI 설정에 문제가 있는 것 같습니다. 브라우저를 새로 고친 다음, Salesforce 관리자에게 코드 E-1018에 대한 도움을 요청하십시오. | vdi_strategy_not_supported |
현재 사용 중인 VDI(가상 데스크톱 인프라) 플랫폼은 현재 Amazon Connect에서 오디오 리디렉션을 지원하지 않습니다. Amazon Connect는 특정 VDI 플랫폼만 지원합니다. | Amazon Connect가 지원하는 VDI 플랫폼을 확인하려면 Amazon-connect-streams 설명서( Virtual Desktop 사용자용 음성 통화 오디오 설정을 사용하여 VDI 설정을 구성합니다. |
| 네트워크 문제가 있습니다. Salesforce 관리자에게 네트워크 구성을 확인해달라고 요청하십시오. (E-1015) | webrtc_error |
담당자가 지원되지 않는 브라우저를 사용하거나 필수 포트 또는 프로토콜이 열리지 않으므로 문제가 발생했습니다. 예를 들어 443 포트의 UDP는 허용되지 않습니다. Chrome 또는 Firefox의 최신 세 가지 버전만 지원됩니다. | 담당자가 지원되는 브라우저를 사용하고 있는지 확인합니다. Voice는 안정적인 최신 브라우저 버전인 Google Chrome, Mozilla Firefox, Microsoft Edge(Chromium)만 지원합니다. 모든 트래픽이 필수 포트 및 프로토콜에 허용되는지 확인합니다. 자세한 내용은 CCP 네트워킹 및 전화 설정을 참조하십시오. 브라우저 및 포트 및 프로토콜에 대한 설정을 확인한 후 문제가 지속되는 경우 전화 통신 모델에 따라 Salesforce 지원 또는 Amazon 지원에 문의하십시오. |
브라우저 콘솔 로그 오류 및 메시지
이러한 오류 및 메시지는 브라우저 콘솔 로그에서만 사용할 수 있으며 옴니채널 소프트폰에 표시되지 않습니다.
| 콘솔 로그 레이블 | 나타나는 이유 | 수행할 작업 |
|---|---|---|
AgentHungUp |
담당자가 자발적으로 연락을 종료하거나 통화에서 연결을 끊었으며, 종종 성공적인 연결이 완전히 설정되기 전입니다. 시스템에서 예기치 않은 연결 끊김을 등록하면 이 메시지가 표시됩니다. 이 오류가 표시되면 Salesforce가 |
조기 중단이 반복되는 경우 담당자에게 이 동작을 피하도록 지시합니다. |
BadAddressAgent |
담당자의 소프트폰 또는 외부 장치 전화 번호가 유효하지 않거나, 액세스할 수 없거나, 잘못되었을 경우 이 구성 오류가 표시됩니다. 이 오류가 표시되면 Salesforce에서 |
소프트폰 또는 외부 장치의 전화 번호 구성을 수정합니다. Amazon Connect 인스턴스 구성의 Amazon Connect에서 전화번호 신청 섹션을 참조하십시오. 데스크폰의 경우 상담 센터의 데스크폰 설정을 참조하십시오. |
BadAddressCustomer |
고객의 대상 전화 번호가 유효하지 않거나, 액세스할 수 없거나, 잘못되었을 경우 이 인프라 오류가 표시됩니다. 이 오류는 일반적으로 아웃바운드 통화 또는 전송을 시도하는 동안 발생합니다. 이 오류가 표시되면 Salesforce가 |
문제가 계속해서 여러 번호에 영향을 미치는 경우 전화 통신 모델에 따라 Salesforce 지원 또는 Amazon 지원에 문의하십시오. |
Default |
이 인프라 오류는 Amazon Connect에서 보고한 분류되지 않거나 예기치 않은 오류 상태에 사용됩니다. 이 오류가 표시되면 Salesforce가 |
전화 통신 모델에 따라 Salesforce 지원 또는 Amazon 지원에 문의하십시오. |
Error |
Amazon Connect 서비스 계층에 대한 이 인프라 오류는 Amazon Connect에서 담당자 작업 또는 상태 전환 중 발생하는 일반적인 분류되지 않은 오류입니다. 이 오류가 표시되면 Salesforce에서 통화 수락 실패 메트릭( |
전화 통신 모델에 따라 Salesforce 지원 또는 Amazon 지원에 문의하십시오. |
FailedConnectAgent |
Amazon Connect가 통화 담당자를 설정할 수 없는 경우 이 인프라 오류가 표시됩니다. 이 오류가 표시되면 Salesforce에서 통화 수락 실패 메트릭( |
전화 통신 모델에 따라 Salesforce 지원 또는 Amazon 지원에 문의하십시오. |
FailedConnectCustomer |
Amazon Connect에서 통화의 고객을 설정할 수 없는 경우 이 인프라 오류가 표시됩니다. 예를 들어, 고객이 응답하지 않거나, 회선이 사용 중이거나, 고객 측의 인프라가 실패합니다. 이 오류가 표시되면 Salesforce에서 |
전화 통신 모델에 따라 Salesforce 지원 또는 Amazon 지원에 문의하십시오. |
ice_collection_timeout |
Amazon Connect 소프트폰이 Salesforce 소프트폰 끝점과 통신할 수 없습니다. 이 상황은 WebSocket 연결을 차단하는 방화벽, 네트워크 프록시 문제 또는 제한적인 보안 정책으로 인해 발생할 수 있습니다. |
다음 문제 해결 단계를 시도하고 자세한 내용은 Amazon Connect 네트워크 요구 사항을 참조하십시오.
네트워크 유효성을 검사한 후 문제가 지속되는 경우 네트워크 팀에 Salesforce 지원팀 또는 Amazon 지원팀에 문의해달라고 요청하십시오. 전화 모델에 따라 |
LineEngagedAgent |
이 메시지는 담당자가 회선 가용성을 제대로 관리하지 않는 경우 로그에 표시됩니다. Amazon Connect가 새 연락처를 라우팅하려고 할 때 담당자의 외부 회선이 사용 중입니다. 이 오류가 표시되면 Salesforce가 |
별도의 작업이 필요하지 않습니다. 정보 메시지만 해당됩니다. |
LineEngagedCustomer |
이 메시지는 담당자 또는 시스템에서 아웃바운드 통화 또는 전송을 시도할 때 고객의 회선이 사용 중인 경우에 표시됩니다. 이 메시지가 표시되면 Salesforce에서 |
별도의 작업이 필요하지 않습니다. 정보 메시지만 해당됩니다. |
MissedCallAgent |
담당자가 구성된 시간 제한 기간 내에 라우팅된 통화를 수락하지 않을 경우 이 메시지가 표시됩니다. 이 메시지가 표시되면 Salesforce가 |
담당자에게 시간 초과 기간 내에 통화를 수락하도록 요청합니다. |
MultipleCcpWindows |
담당자가 동시에 여러 브라우저 탭 또는 창에서 연락처 제어판(CCP)에 로그인한 경우 이 메시지가 표시됩니다. 여러 브라우저 탭 또는 창에서 옴니채널에 로그인한 경우 이 상황이 발생할 수 있습니다. 이 메시지가 표시되면 Salesforce는 한 세션을 제외한 모든 세션에서 담당자를 오프라인 또는 오류 상태로 설정하여 |
담당자에게 한 번에 하나의 브라우저 탭 또는 창에서 옴니채널을 사용하도록 요청합니다. Salesforce Voice 제한 및 제한 사항을 참조하십시오. |
Other |
Amazon에서 내부 오류가 발생했습니다. | 브라우저를 새로 고칩니다. 문제가 지속될 경우 전화 통신 모델에 따라 Salesforce 지원 또는 Amazon 지원에 문의하십시오. 자세한 내용은 Amazon Connect 네트워크 요구 사항을 참조하십시오. |
RealtimeCommunicationError |
담당자의 브라우저와 Amazon Connect 간에 WebRTC 또는 실시간 미디어 통신에서 복구할 수 없는 지속적인 오류가 발생하는 경우 이 인프라 오류가 표시됩니다. 이 메시지가 표시되면 Salesforce에서 |
문제가 해결되지 않을 경우 전화 통신 모델에 따라 Salesforce 지원 또는 Amazon 지원에 문의하십시오. 자세한 내용은 Amazon Connect 네트워크 요구 사항을 참조하십시오. |
SSOLogin Failed |
담당자의 싱글사인온(SSO) 인증에 실패하여 연락처 제어판(CCP) 또는 기본 Amazon Connect 서비스에 안전하게 로그인할 수 없습니다. 일반적인 원인:
|
Salesforce Voice 문제 해결의 옴니채널 로그인 및 SSO 문제 해결 방법 섹션에서 권장 사항을 따르십시오. 구성을 확인했지만 오류가 지속되는 경우 전화 통신 모델에 따라 ID 공급자 관리자에게 Salesforce 지원 또는 Amazon 지원에 문의해달라고 요청하십시오. |

