통화 SDK, 통화 자동화 SDK, PSTN, 채팅 SDK 및 SMS SDK에 대한 통화 종료 응답 코드 문제 해결

  • 아티클

이 문서에서는 통화 SDK, 통화 자동화 및 PSTN 통화에 대한 통화 종료 응답 코드 문제 해결에 대해 설명합니다.

문제 해결 팁

문제 해결 시 다음 팁을 고려합니다.

  • 애플리케이션이 IncomingCall Event Grid 이벤트를 수신하고 있지 않습니다. Event Grid를 사용하여 애플리케이션 엔드포인트의 유효성을 검사해야 합니다. 유효성 검사에 성공하면 이벤트 구독에 대한 프로비전 상태가 성공으로 표시됩니다.
  • 오류 The field CallbackUri is invalid의 경우: 호출 자동화는 HTTP 엔드포인트를 지원하지 않습니다. 제공하는 콜백 URL이 HTTPS를 지원하는지 확인합니다.
  • PlayAudio 작업은 아무 것도 재생하지 않습니다. 현재 오디오 파일에는 웨이브 파일(.wav) 형식만 지원됩니다. 웨이브 파일의 오디오 콘텐츠는 Mono(단일 채널), 샘플링 속도가 16,000(16KHz)인 16비트 샘플이어야 합니다.
  • PSTN 엔드포인트에 대한 작업이 작동하지 않습니다. 전화번호에 대한 CreateCall, Transfer, AddParticipant 및 Redirect의 경우 작업 요청에서 SourceCallerId을(를) 설정해야 합니다. 직접 라우팅을 사용하지 않는 경우 작업이 성공하려면 원본 호출자 ID가 Communication Services 리소스에서 소유한 전화번호여야 합니다.

제품 팀에서 추적하는 문제에 대한 자세한 내용은 알려진 문제를 참조하세요.

참고 항목

다음 표에 나열된 메시지 및 결과 범주는 공개 미리 보기로 제공됩니다. 자세한 내용은 Microsoft Azure Preview에 대한 추가 사용 약관을 참조하세요.

호출 코드 및 하위 코드 오류 이해

오류 코드, 하위 코드 및 해당 결과 범주는 개발자가 오류를 식별하고 진단하는 데 도움이 됩니다. 이러한 오류 코드는 통화가 종료된 후 call.callEndReason 속성을 통해 노출됩니다.

오류 코드 세부 정보에는 다음이 포함됩니다.

코드 - 클라이언트 또는 서버 응답 상태를 나타내는 3자리 정수입니다. 코드 범주:

  • 성공적인 응답(200~299)
  • 클라이언트 오류(400~499)
  • 서버 오류(500~599)
  • 전역 오류(600-699)

하위 코드 - 정수로 정의되며 여기서 각 숫자는 시나리오 그룹 또는 특정 시나리오 결과와 관련된 고유한 이유를 나타냅니다.

메시지 - 결과를 설명하고 결과가 실패할 경우 문제를 완화하는 방법에 대한 힌트를 제공합니다.

ResultCategory - 오류 형식을 나타냅니다. 컨텍스트에 따라 값은 Success, ExpectedError, UnexpectedClientError 또는 UnexpectedServerError일 수 있습니다.

Azure Communication Services 통화 SDK 클라이언트 오류 코드 및 하위 코드

클라이언트 오류의 경우 resultCategories 속성이 ExpectedError이면 SDK의 관점에서 오류가 예상됩니다. 이러한 오류는 일반적으로 사전 조건 오류(예: 앱에서 전달한 잘못된 인수) 또는 현재 시스템 상태에서 API 호출을 허용하지 않는 경우에 발생합니다. 애플리케이션은 오류 이유와 API 호출 논리를 확인해야 합니다.

하위 코드 코드 메시지 결과 범주 조언
40101 408 CallAgent를 만들지 못했습니다. 다시 시도하세요. 문제가 지속되면 브라우저 콘솔 로그, .HAR 파일을 수집하고 Azure Communication Services 고객 지원팀에 문의하세요. UnexpectedClientError
40104 408 CallAgent를 만들지 못했습니다. 다시 시도하세요. 문제가 지속되면 브라우저 콘솔 로그, .HAR 파일을 수집하고 Azure Communication Services 고객 지원팀에 문의하세요. UnexpectedClientError
40114 408 Azure Communication Services 인프라에 연결하지 못했습니다. 다시 시도하고 브라우저의 네트워크 요청을 확인합니다. 요청이 계속 실패하면 브라우저 콘솔 로그, .HAR 파일을 수집하고 Azure Communication Services 고객 지원팀에 문의하세요. UnexpectedClientError 자세한 내용은 네트워크 요구사항을 참조하세요.
40115 412 Azure Communication Services 인프라에 대한 연결을 초기화할 수 없는 CallAgent를 만들지 못했습니다. 다시 시도하고 브라우저의 네트워크 요청을 확인합니다. 요청이 계속 실패하면 브라우저 콘솔 로그, .HAR 파일을 수집하고 Azure Communication Services 고객 지원팀에 문의하세요. UnexpectedClientError 자세한 내용은 네트워크 요구사항을 참조하세요.
40216 500 CallAgent를 만들지 못했습니다. 다시 시도하세요. 문제가 지속되면 브라우저 콘솔 로그를 수집하고 Azure Communication Services 지원에 문의하세요. UnexpectedClientError
40228 409 CallAgent를 생성하지 못했습니다. 이 ID와 연결된 CallAgent 인스턴스가 이미 존재합니다. 기존 CallAgent를 삭제하거나 다른 ID를 사용하여 새 CallAgent를 만듭니다. ExpectedError
40230 409 TeamsCallAgent를 생성하지 못했습니다. 이 ID와 연결된 TeamsCallAgent 인스턴스가 이미 존재합니다. 새 TeamsCallAgent를 만들기 전에 기존 TeamsCallAgent를 삭제합니다. ExpectedError
40606 405 스피커를 열거하지 못했습니다. Android Chrome, iOS Safari 또는 macOS Safari에서 스피커를 열거/선택하는 것은 지원되지 않습니다. ExpectedError Android Chrome, iOS Safari 및 macOS Safari에서는 스피커 열거/선택이 지원되지 않습니다. 운영 체제에서 스피커(출력 디바이스)를 자동으로 선택합니다.

디바이스 관리 및 이러한 문제를 가장 잘 완화하는 방법에 대해 자세히 알아보세요.
40613 400 마이크 및/또는 카메라 사용 권한을 가져오지 못했거나, 거부되었거나 실패했습니다. 브라우저 및 OS 설정에서 사용 권한을 허용해야 합니다. ExpectedError 디바이스 사용 권한을 가장 잘 처리하는 방법에 대해 자세히 알아보세요.
40614 500 디바이스 사용 권한을 요청하지 못했습니다. 브라우저 설정 및 OS 설정에서 사용 권한을 허용하고 다시 시도하세요. 문제가 지속되면 브라우저 콘솔 로그를 수집하고 Azure Communication Services 지원에 문의하세요. UnexpectedClientError 디바이스 사용 권한을 가장 잘 처리하는 방법에 대해 자세히 알아보세요.
41006 400 수신 전화를 수락하지 못했습니다. 벨이 울리는 상태가 아닙니다. CallAgent의 incomingCall 이벤트를 구독하여 수신 전화를 수락합니다. ExpectedError 문제의 근본 원인을 확인하려면 다음 문서를 참조하세요.
- 수신 전화 받기
- SDK 이벤트 구독
41007 400 수신 전화를 거부하지 못했습니다. 벨이 울리는 상태가 아닙니다. CallAgent의 incomingCall 이벤트를 구독하여 수신 전화를 거부합니다. ExpectedError 문제의 근본 원인을 확인하려면 다음 문서를 참조하세요.
- 수신 전화 받기
- SDK 이벤트 구독
41015 500 마이크를 음소거하지 못했습니다. 다시 시도하세요. 문제가 지속되면 브라우저 콘솔 로그를 수집하고 Azure Communication Services 지원에 문의하세요. UnexpectedClientError
41016 400 마이크 음소거를 해제하지 못했습니다. 다시 시도하세요. 문제가 지속되면 브라우저 콘솔 로그를 수집하고 Azure Communication Services 지원에 문의하세요. UnexpectedClientError
41025 400 비디오를 시작하지 못했습니다. LocalVideoStream 인스턴스가 잘못되었거나 비어 있습니다. LocalVideoStream 인스턴스를 전달합니다. ExpectedError 비디오를 시작하기 위해 전달된 개체가 LocalVideoStream의 인스턴스인지 확인합니다.
VideoDeviceInfo 개체 또는 MediaStream 개체를 사용하여 LocalVideoStream을(를) 생성합니다.

문제의 근본 원인을 확인하려면 다음 문서를 참조하세요.
- 비디오 카메라로 전화 걸기
- 통화 중 로컬 비디오 보내기 시작 및 중지
- 원시 비디오 액세스
41027 400 비디오를 시작하지 못했습니다. 비디오가 이미 시작되었습니다. ExpectedError 유용한 링크:
- 비디오 카메라로 전화 걸기
- 통화 중 로컬 비디오 보내기 시작 및 중지
41030 400 비디오를 시작하지 못했습니다. 비디오가 이미 중지되었습니다. ExpectedError 유용한 링크:
- 비디오 카메라로 전화 걸기
- 통화 중 로컬 비디오 보내기 시작 및 중지
41032 400 비디오를 중지하지 못했습니다. 잘못된 인수입니다. 입력으로 사용되는 LocalVideoStream은 현재 전송되지 않습니다. ExpectedError 통화에서 전송되는 LocalVideoStream은 Call.localVideoStreams[] 배열에 저장되며 Video 또는 RawMedia 형식입니다.
문제의 근본 원인을 확인하려면 다음 문서를 참조하세요.
- 비디오 카메라로 전화 걸기
- 통화 중 로컬 비디오 보내기 시작 및 중지
- 원시 비디오 액세스
41033 500 통화를 보류하지 못했습니다. 다시 시도하세요. 문제가 지속되면 브라우저 콘솔 로그를 수집하고 Azure Communication Services 지원에 문의하세요. UnexpectedClientError
41034 500 통화를 다시 시작하지 못했습니다. 다시 시도하세요. 문제가 지속되면 브라우저 콘솔 로그를 수집하고 Azure Communication Services 지원에 문의하세요. UnexpectedClientError
41035 400 화면 공유를 시작하지 못했습니다. 화면 공유가 이미 시작되었습니다. ExpectedError 통화 중 화면 공유를 시작 및 중지하는 방법에 대해 자세히 알아보기
41041 400 화면 공유를 중지하지 못했습니다. 화면 공유가 이미 중지되었습니다. ExpectedError 통화 중 화면 공유를 시작 및 중지하는 방법에 대해 자세히 알아보기
41048 410 통화 설정 프로세스 중에 비디오를 시작하지 못했습니다. 브라우저의 설정 및 OS 설정에서 비디오 사용 권한을 허용하고 카메라 디바이스가 다른 프로세스에서 사용되지 않는지 확인합니다. UnexpectedClientError - 시스템에서 카메라 디바이스를 사용하지 않도록 설정했을 수 있습니다.
- 카메라가 다른 프로세스에서 사용되고 있습니다.
41056 412 통화 시작 또는 참가에 실패했습니다. Teams Enterprise 음성 정책은 이 Azure Communication Services 리소스에 대해 사용하도록 설정되지 않았습니다. 온라인으로 자습서를 수행하여 사용하도록 설정합니다. ExpectedError Teams Enterprise 음성 정책을 사용하도록 설정하기 위해 사용자가 Enterprise Voice 온라인 및 전화 시스템 음성사서함을 사용하도록 설정하는 방법을 참조하세요.
41071 412 화면 공유를 시작하지 못했습니다. 통화가 연결된 상태가 아닙니다. 통화가 연결되는 때를 알도록 통화의 statteChanged 이벤트를 구독합니다. ExpectedError 유용한 링크:
- 통화 속성 확인
- SDK 이벤트 구독
41073 412 사용자 지정 MediaStream을 다운로드하거나 설정하지 못했습니다. 이 기능은 현재 Azure Communication Services에서 사용할 수 없습니다. ExpectedError
43000 412 비디오를 시작하지 못했습니다. 비디오 디바이스가 다른 프로세스/애플리케이션에서 사용되고 있습니다. 카메라가 다른 프로세스/애플리케이션에서 사용되지 않도록 하고 다시 시도하세요. ExpectedError 다른 프로세스에서 사용 중인 카메라를 가장 잘 처리하는 방법에 대해 자세히 알아보기
43001 403 비디오를 시작하지 못했습니다. 선택한 비디오 디바이스를 사용할 수 있는 권한이 부여되지 않았습니다. 브라우저의 설정 및 시스템 설정에서 비디오 디바이스 사용 권한이 허용되는지 확인합니다. ExpectedError 브라우저 설정 및 디바이스 시스템 설정에서 카메라 사용 권한이 허용되는지 확인합니다.
디바이스 시스템 설정에서 카메라를 사용하지 않도록 설정하지 않았는지 확인합니다.
macOS에서 시스템 설정에서 화면 녹화가 허용되는지 확인합니다.

유용한 링크:
- 디바이스 권한 요청-
macOS의 화면 공유 권한
- macOS 및 iOS에서 Safari용 디바이스 열거 또는 액세스
43002 500 비디오를 시작하지 못했습니다. 알 수 없는 오류입니다. 다시 시도하세요. 문제가 지속되면 Azure Communication Services 지원에 문의하세요. UnexpectedClientError
43004 400 비디오 디바이스를 전환하지 못했습니다. 입력이 잘못되었습니다. 입력은 VideoDeviceInfo 형식이어야 합니다. ExpectedError 디바이스 관리자를 사용하여 VideoDeviceInfo 개체 목록을 가져와서 VideoDeviceInfo 개체를 사용하여 원본을 전환합니다.

통화 중 로컬 비디오 보내기 시작 및 중지하는 방법을 자세히 알아보기
43005 400 비디오 디바이스를 전환하지 못했습니다. 동일한 비디오 디바이스로 전환할 수 없습니다. 이미 선택되어 있습니다. ExpectedError
43013 412 비디오를 시작하지 못했습니다. 비디오 디바이스를 찾을 수 없습니다. 비디오 디바이스가 시스템 설정에 연결되고 사용하도록 설정되어 있는지 확인합니다. ExpectedError 디바이스에 카메라가 연결되어 있고 설치되어 있는지 확인합니다.
43014 412 비디오를 시작하지 못했습니다. 미디어 스트림을 요청하는 동안 오류가 발생했습니다. 다시 시작하세요. 문제가 지속되면 Azure Communication Services 지원에 문의하세요. UnexpectedClientError
43015 412 비디오를 시작하지 못했습니다. 미디어 스트림 요청 시간이 초과되었습니다. 카메라에 액세스하려면 브라우저의 프롬프트에 대한 사용 권한을 허용하고 다시 시도하세요. ExpectedError 이 오류는 사용자가 브라우저의 사용 권한 프롬프트에서 카메라에 대한 액세스를 허용하는 작업을 수행하지 않는 경우에 발생할 수 있습니다.
43016 412 비디오를 시작하지 못했습니다. 시스템에서 사용 권한을 거부했습니다. 브라우저의 설정 및 시스템 설정에서 비디오 디바이스 사용 권한이 허용되는지 확인합니다. ExpectedError - 브라우저 설정 및 디바이스 시스템 설정에서 카메라 권한이 허용되는지 확인합니다.
- 디바이스 시스템 설정에서 카메라를 사용하지 않도록 설정하지 않았는지 확인합니다.
- macOS에서 시스템 설정에서 화면 녹화가 허용되는지 확인합니다.

유용한 링크:
- 디바이스 권한 요청
-macOS의 화면 공유 권한
- macOS 및 iOS에서 Safari용 디바이스 열거 또는 액세스
43017 412 비디오를 시작하지 못했습니다. 지원되지 않는 스트림입니다. 다시 시작하세요. 문제가 지속되면 Azure Communication Services 지원에 문의하세요. UnexpectedClientError
43018 412 비디오를 시작하지 못했습니다. 제약 조건을 설정하지 못했습니다. 다시 시작하세요. 문제가 지속되면 Azure Communication Services 지원에 문의하세요. UnexpectedClientError 비디오 제약 조건을 설정하는 방법에 대해 자세히 알아보기
43019 412 비디오를 시작하지 못했습니다. 디바이스가 선택되지 않았습니다. VideoDeviceInfo로 생성된 LocalVideoStream을 전달하고 다시 시도하세요. 문제가 지속되면 Azure Communication Services 지원에 문의하세요. UnexpectedClientError 유용한 링크:
- 비디오 카메라로 전화 걸기
- 통화 중 로컬 비디오 보내기 시작 및 중지
43200 412 비디오 스트림을 렌더링하지 못했습니다. 이 스트림을 사용할 수 없습니다. 스트림의 isAvailable 속성을 구독하여 원격 참가자가 비디오를 켜고 스트림을 렌더링할 수 있을 때 알림을 받습니다. ExpectedError 유용한 링크:
- 원격 참가자 비디오/화면 공유 스트림 렌더링
- 앱에 1:1 영상 통화 추가
- SDK 이벤트 구독
43202 404 비디오 스트림을 렌더링하지 못했습니다. 이 스트림은 더 이상 사용할 수 없습니다. 원격 참가자가 비디오를 껐습니다. ExpectedError 원격 참가자가 비디오를 보기로 만드는 동안 비디오를 껐습니다.
43203 408 비디오 스트림을 렌더링하지 못했습니다. 비디오 프레임을 기다리는 동안 렌더링 시간이 초과되었습니다. 다시 시작하세요. 문제가 지속되면 Azure Communication Services 지원에 문의하세요. UnexpectedClientError
43204 500 비디오 스트림을 렌더링하지 못했습니다. Azure Communication Services 인프라에서 비디오를 구독하지 못했습니다. 다시 시작하세요. 문제가 지속되면 Azure Communication Services 지원에 문의하세요. UnexpectedClientError
43209 405 비디오 스트림을 렌더링하지 못했습니다. 초기화 프로세스 중에 VideoStreamRenderer가 삭제되었습니다. ExpectedError
43210 400 VideoStreamRenderer가 이미 삭제되었기 때문에 삭제하지 못했습니다. ExpectedError
43220 400 이미 도달한 활성 RemoteVideoStream 보기의 최대 수인 보기를 만들지 못했습니다. 새 항목을 만들기 위해 이전 항목을 삭제할 수 있습니다. ExpectedError 가장 많은 수신 비디오 스트림을 올바르게 지원하는 방법에 대해 자세히 알아보기
480 원격 클라이언트 엔드포인트가 등록되지 않았습니다. 원격 엔드포인트를 사용할 수 있는지 확인합니다.
481 들어오는 호출을 처리하지 못했습니다. Azure Portal을 통해 지원 요청을 제출합니다.
487 엔드포인트 불일치 문제로 인해 통화가 취소되거나, 로컬에서 거부되거나, 종료되었거나 미디어 제품을 생성하지 못했습니다. 예상 동작.
490, 491, 496, 497, 498 로컬 엔드포인트 네트워크 문제. 네트워크를 확인합니다.
503, 504 Communication Services 인프라 오류입니다. Azure Portal을 통해 지원 요청을 제출합니다.
600 어디서나 통화할 수 있습니다. 참가자에게 성공적으로 연락했지만 통화 중 신호음이 반환되었습니다. 예상 동작.
603 원격 Communication Services 참가자가 전역적으로 거부한 호출입니다. 예상 동작.
604 어디에도 존재하지 않습니다. 요청된 URI가 없습니다. 예상 동작.
606 허용되지 않습니다. 참가자에게 성공적으로 연락했지만 설명된 세션을 지원할 수 없습니다. 예상 동작.

호출 코드 및 하위 코드 오류 이해

오류 코드, 하위 코드 및 해당 결과 범주는 개발자가 오류를 식별하고 진단하는 데 도움이 됩니다. 이러한 오류 코드는 통화가 종료된 후 call.callEndReason 속성을 통해 노출됩니다.

오류 코드 세부 정보에는 다음이 포함됩니다.

코드 - 클라이언트 또는 서버 응답 상태를 나타내는 3자리 정수입니다. 코드 범주:

  • 성공적인 응답(200~299)
  • 클라이언트 오류(400~499)
  • 서버 오류(500~599)
  • 전역 오류(600-699)

하위 코드 - 정수로 정의되며 여기서 각 숫자는 시나리오 그룹 또는 특정 시나리오 결과와 관련된 고유한 이유를 나타냅니다.

메시지 - 결과를 설명하고 결과가 실패할 경우 문제를 완화하는 방법에 대한 힌트를 제공합니다.

ResultCategory - 오류 형식을 나타냅니다. 컨텍스트에 따라 값은 Success, ExpectedError, UnexpectedClientError 또는 UnexpectedServerError일 수 있습니다.

통화 종료 코드 및 하위 코드 호출

통화가 종료된 이유에 대한 설명은 다양합니다. 통화 종료 방법을 보여 주는 통화 종료 코드 및 하위 코드의 의미는 다음과 같습니다.

하위 코드 코드 메시지 결과 범주 조언
0 0 로컬 참가자가 통화를 성공적으로 종료했습니다. Success
0 487 발신자가 통화를 취소하여 통화가 성공적으로 종료되었습니다. Success
0 603 수신자가 거부하여 통화가 성공적으로 종료되었습니다. Success
3100 410 통화 설정이 클라이언트의 예기치 않은 네트워크 문제로 인해 실패했습니다. 클라이언트의 네트워크를 확인하고 다시 시도하세요. UnxpectedClientError - 지원되는 환경에서 최신 SDK를 사용하고 있는지 확인합니다.
3101 410 클라이언트의 예기치 않은 네트워크 문제로 인해 통화가 끊어졌습니다. 클라이언트의 네트워크를 확인하고 다시 시도하세요. UnxpectedClientError
3112 410 통화 설정이 클라이언트 쪽의 네트워크 구성 문제로 인해 실패했습니다. 클라이언트의 네트워크 구성을 확인하고 다시 시도하세요. ExpectedError
4097 0 모임 주최자가 모든 사용자의 통화를 종료했습니다. Success
4507 495 애플리케이션이 유효한 Azure Communication Services 토큰을 제공하지 않아 통화가 종료되었습니다. UnexpectedClientError 애플리케이션이 토큰 새로 고침 메커니즘을 올바르게 구현하는지 확인합니다.
4521 0 사용자가 갑자기 통화 연결을 끊어 통화가 종료되었습니다. 이는 사용자가 적절한 중단 없이 브라우저 탭을 닫아 애플리케이션을 종료하는 등 호출을 호스트한 애플리케이션을 닫아서 발생할 수 있습니다. ExpectedError
5000 0 이 참가자에 대한 통화가 종료되었습니다. 다른 참가자가 대화에서 참가자를 제거했습니다. Success
5003 0 모든 수신자 엔드포인트가 통화를 거부하여 통화가 성공적으로 종료되었습니다. Success
5300 0 이 참가자에 대한 통화가 종료되었습니다. 다른 참가자가 대화에서 참가자를 제거했습니다. Success
5,317 0 참가자 역할 업데이트로 인해 대상 참가자가 제거됩니다. ExpectedError
5828 403 사용자가 초대 대상 목록에 속하지 않으므로 회의실 모임에 참가할 수 있는 권한이 없습니다. UnexpectedClientError
5829 403 종료 시간 이후 또는 모임 시작 전에 회의실 모임에 참가할 수 없습니다. UnexpectedClientError
5830 403 Communication Services 사용자만 룸 모임에 참가할 수 있습니다. ExpectedError
7000 0 Azure Communication Services 플랫폼에 의해 통화가 종료되었습니다. Success
10003 487 이 사용자의 다른 엔드포인트에서 다른 곳에서 통화가 수락되었습니다. Success
10004 487 시간 제한으로 통화가 취소되었으며, 수신자 엔드포인트가 제 시간에 수락되지 않았습니다. 사용자가 알림을 확인했는지 확인하고 해당 통화를 다시 시작해 보세요. ExpectedError
10024 487 통화가 종료되었습니다. 모든 수신자 엔드포인트에서 통화가 거부되었습니다. Success - 다시 전화를 걸어보세요.
10057 408 통화가 실패했거나, 수신자가 통화 설정을 완료하지 못했거나, 대부분의 경우 수신자의 네트워크가 끊겼거나, 애플리케이션을 갑자기 종료했습니다. 클라이언트가 연결되어 있고 사용 가능한지 확인합니다. ExpectedError
301005 410 동일한 인프라를 사용한 미디어 연결 손실로 인해 Azure Communication Services 인프라의 호출에서 참가자가 제거되었습니다. 이는 일반적으로 참가자가 갑자기 전화를 끊거나 네트워크 연결이 끊어지는 경우에 발생합니다. 참가자는 통화를 계속하려면 다시 연결할 수 있습니다. UnexpectedClientError 지원되는 환경에서 최신 SDK를 사용하고 있는지 확인합니다.
510403 403 통화가 종료되고 이전에 스팸으로 표시되어 이제 차단되었습니다. ExpectedError - Communication Services 토큰이 유효하고 만료되지 않았는지 확인합니다.
- 통화 옵션에서 AlternateId을(를) 전달해야 합니다.
540487 487 발신자가 통화를 취소하여 통화가 성공적으로 종료되었습니다. Success
560000 0 원격 PSTN 참가자가 통화를 성공적으로 종료했습니다. Success 가능한 원인:
- 사용자가 통화를 종료했습니다.
- 미디어 에이전트가 통화를 종료했습니다.
560486 486 원격 PSTN 참가자가 통화 중이어서 통화가 종료되었습니다. 전화를 건 번호는 이미 통화 중이거나 기술적인 문제가 있는 번호입니다.
404 호출을 찾을 수 없습니다. 통화하는 번호(또는 조인하는 통화)가 있는지 확인합니다.
408 통화 컨트롤러 시간이 초과되었습니다. 사용자 엔드포인트에서 프로토콜 메시지를 기다리는 동안 통화 컨트롤러 시간이 초과되었습니다. 클라이언트가 연결되어 있고 사용 가능한지 확인합니다.
410 로컬 미디어 스택 또는 미디어 인프라 오류입니다. 지원되는 환경에서 최신 SDK를 사용하고 있는지 확인합니다.
430 클라이언트 애플리케이션에 메시지를 전달할 수 없습니다. 클라이언트 애플리케이션이 실행 중이고 사용 가능한지 확인합니다.
480 원격 클라이언트 엔드포인트가 등록되지 않았습니다. 원격 엔드포인트를 사용할 수 있는지 확인합니다.
481 들어오는 호출을 처리하지 못했습니다. Azure Portal을 통해 지원 요청을 제출합니다.
490, 491, 496, 497, 498 로컬 엔드포인트 네트워크 문제. 네트워크를 확인합니다.
500, 503, 504 Communication Services 인프라 오류입니다. Azure Portal을 통해 지원 요청을 제출합니다.

통화 자동화 SDK 오류 코드

다음 오류 코드는 호출 자동화 SDK에 의해 노출됩니다.

SubCode 코드 메시지 결과 범주 조언
400 Bad request 입력 요청이 잘못되었습니다. 오류 메시지를 확인하여 잘못된 입력을 확인합니다.
400 재생 실패 오디오 파일이 WAV, 16KHz 또는 Mono인지 확인하고 파일 URL에 공개적으로 액세스할 수 있는지 확인합니다.
400 인식 실패 오류 메시지를 확인합니다. 시간 제한에 도달했거나 작업이 취소된 경우 메시지가 강조 표시됩니다. 오류 코드 및 메시지에 대한 자세한 내용은 사용자 입력 수집을 참조하세요.
401 Unauthorized HMAC 인증에 실패했습니다. CallAutomationClient를 만드는 데 사용한 연결 문자열이 올바른지 확인합니다.
403 금지 요청이 금지되었습니다. 액세스하려는 리소스에 액세스할 수 있는지 확인합니다.
404 리소스를 찾을 수 없음 작업하려는 호출이 존재하지 않습니다. 예를 들면 이전에 연결이 끊긴 통화의 전송입니다.
429 Too many requests Retry-After 헤더에 제안된 지연 후 다시 시도한 다음, 기하급수적으로 백오프합니다.
500 내부 서버 오류 지연 후 다시 시도합니다. 오류가 계속되면 지원 티켓을 제출하세요.
500 재생 실패 Azure Portal을 통해 지원 요청을 제출합니다.
500 인식 실패 오류 메시지를 확인하고 오디오 파일 형식이 유효한지 확인합니다(WAV, 16KHz, Mono). 파일 형식이 유효한 경우 Azure Portal을 통해 지원 요청을 제출합니다.
502 나쁜 게이트웨이 새 http 클라이언트를 사용하여 지연 후 다시 시도합니다.
503,504 Communication Services 인프라 오류입니다. Azure Portal을 통해 지원 요청을 제출합니다.

ParticipantEndReason을 사용하는 PSTN 호출 응답 코드

이 섹션에서는 다양한 ParticipantEndReason 및 ParticipantEndSubCode 응답 코드 조합에 대한 문제 해결 정보를 제공합니다. 이 섹션에 있는 표의 경우, ParticipantEndReason = 코드 및 ParticipantEndSubCode = 하위 코드입니다.

ParticipantEndReason 0

값이 0인 응답 ParticipantEndReason은(는) 일반적으로 일반 호출 지우기를 의미하고 오류 없이 완료된 호출을 표시합니다.

SubCode 코드 메시지 결과 범주 조언
0 0 로컬 참가자가 통화를 성공적으로 종료했습니다. Success
560000 0 일반 PSTN 호출 종료:
- 사용자가 통화를 종료했습니다.
- 미디어 에이전트가 통화를 종료했습니다.		 Success
540000 0 일반 PSTN 호출 종료:
- 사용자가 통화를 종료했습니다.
- 미디어 에이전트가 통화를 종료했습니다.		 Success

ParticipantEndReason 4xx

값이 4xx인 응답 ParticipantEndReason은(는) 호출이 연결되지 않았음을 의미합니다.

SubCode 코드 메시지 결과 범주 조언
510403 403 통화 차단됨:
- 호출에 대한 대체 ID가 제공되지 않습니다.
- 사용자 SBC(Session Border Controller)에서 허용하지 않는 전화번호입니다.		 - 대체 ID에 대한 자세한 내용은 호출 관리를 참조하세요.
- 유효한 대체 ID를 지정했는지 확인합니다. 사용 중인 리소스에 속하는 전화번호여야 합니다.
- 전화를 걸 때 사용하는 리소스를 소유하고 있는지 확인합니다.
- 직접 라우팅 통화의 경우 Session Border Controller에서 호출을 허용하지 않은 이유를 확인합니다.
560403 403 - 통화가 금지되었습니다.
- 통화가 취소되었습니다.
- 통화가 거부되었습니다.		 올바른 형식으로 유효한 전화번호를 호출했는지 확인합니다. 지원되는 숫자 형식에 대한 자세한 내용은 https://en.wikipedia.org/wiki/E.164을(를) 참조하세요.
511532 403 리소스 SIP 트렁크 구성을 찾을 수 없습니다. Azure Portal에서 직접 라우팅 설정을 확인합니다. 자세한 내용은 직접 라우팅 프로비전을 참조하세요.
560404 404 - 전화번호를 찾을 수 없습니다.
- 대상에 할당되지 않은 전화번호입니다.
- Session Border Controller에서 허용하지 않는 전화번호입니다.		 - 전화 번호가 사용 중인 리소스에 속하고 리소스를 소유하고 있는지 확인합니다.
- 호출하는 번호가 있고 유효한 대상에 할당되었는지 확인합니다.
511404 404 - 전화번호를 찾을 수 없습니다.
- 호출에 사용된 리소스를 찾을 수 없습니다.		 - 사용 중인 리소스에 속하고 리소스를 소유하고 있는 전화번호를 사용했는지 확인합니다.
- 호출하는 번호가 있고 유효한 대상에 할당되었는지 확인합니다.
- 통화에 사용 중인 리소스가 삭제되거나 사용하지 않도록 설정되지 않았는지 확인합니다.
- Azure 구독이 삭제되거나 사용하지 않도록 설정되지 않았는지 확인합니다.
560408 408 호출된 당사자가 규정된 기간 내에 통화 설정 메시지에 응답하지 않았습니다. - 호출된 당사자가 응답하지 않은 이유를 다시 확인합니다.
- 직접 라우팅 호출의 경우 SBC(세션 구분 컨트롤) 로그 및 설정과 시간 제한 구성을 확인합니다.
500001 408 사용자 게이트웨이 시간 제한
Azure Communication Services는 지정된 시간 제한 내에 클라이언트로부터 응답을 받지 못했고 요청을 종료했습니다.		 - 호출된 당사자가 응답하지 않은 이유를 다시 확인합니다.
- 직접 라우팅 호출의 경우 SBC 로그 및 설정 및 시간 제한 구성을 확인합니다.
531004 410 ICE(대화형 연결 설정) 검사가 실패했습니다. - 미디어 경로를 설정할 수 없습니다. 잘못된 네트워크 구성으로 인해 발생할 수 있습니다. 네트워크 구성을 확인하여 필요한 IP 주소 및 포트가 차단되지 않았는지 확인합니다. https://www.rfc-editor.org/rfc/rfc5245#section-7의 지침을 읽습니다.
- 직접 라우팅 호출의 경우 ICE 구성 및 프로필에 대한 SBC 로그 및 설정을 확인합니다. 구성 도움말은 SBC 공급업체에 문의하세요. 자세한 내용은 Azure Communication Services 직접 라우팅 대해 인증된 Session Border Controller 목록을 참조하세요.
560480 480 - 호출된 사용자의 답변이 없습니다.
- 호출된 사용자가 일시적으로 대화가 불가능합니다.		 - 호출된 당사자가 응답하지 않은 이유를 다시 확인합니다.
- 호출된 당사자가 일시적으로 대화가 불가능한 경우 나중에 호출을 다시 시도합니다.
- 직접 라우팅 호출의 경우 SBC 로그 및 설정 및 시간 제한 구성을 확인합니다.
560484 484 - 불완전하거나 잘못된 수신자 주소입니다.
- 불완전하거나 잘못된 수신자 번호 형식입니다.		 - 경우에 따라 사용자가 잘못된 번호로 전화를 걸기 때문에 이러한 오류를 무시할 수 있습니다.
- 전화번호의 형식이 올바르게 지정되었는지 확인합니다. 자세한 내용은 https://en.wikipedia.org/wiki/E.164를 참조하세요.
- 직접 라우팅의 경우 SBC는 콜 전환 시나리오에서 누락된 구성으로 인해 이러한 오류를 발생시킬 수 있습니다.
60486 486 호출된 번호가 통화 중이었습니다. - 호출된 번호가 기존 통화에 연결되어 있거나 기술적인 문제가 있을 수 있습니다.
- 직접 라우팅 호출의 경우 SBC 로그 및 설정 및 시간 제한 구성을 확인합니다.
540487 487 발신자가 호출 요청을 종료했습니다. 호출을 다시 시도합니다.
560487 497 - 발신자가 호출 요청을 종료했습니다.
- 기본 호출 지우기로 요청이 종료되었습니다.		 호출을 다시 시도합니다.

ParticipantEndReason 5xx

값이 5xx인 응답 ParticipantEndReason은(는) 연결을 완료하는 데 필요한 소프트웨어 또는 하드웨어 구성 요소 문제로 인해 호출이 실패했음을 의미합니다.

SubCode 코드 메시지 결과 범주 조언
560500 500 호출과 관련된 서비스 중 하나에서 내부 서버 오류가 발생했습니다. - 호출을 다시 시도합니다. 문제가 지속되면 통신 공급자 또는 Microsoft 지원에 문의하세요.
- 직접 라우팅 호출의 경우 SBC 로그 및 설정과 시간 제한 구성을 확인하여 SBC로 인해 실패했는지 확인합니다.
560503 503 - 호출과 관련된 서비스 중 하나에서 내부 서버 오류로 인해 호출이 실패했습니다.
- 호출을 설정하는 데 사용되는 네트워크가 순서를 벗어났습니다.
- 호출과 관련된 서비스 중 하나의 일시적인 실패입니다.		 - 네트워크 및 라우팅 구성에서 가능한 문제를 확인합니다. 네트워크 방화벽 규칙이 올바른지 확인합니다.
- 호출을 다시 시도합니다. 문제가 지속되면 통신 공급자 또는 Microsoft 지원에 문의하세요.
- 직접 라우팅 호출의 경우 SBC 로그 및 설정과 시간 제한 구성을 확인하여 SBC로 인해 실패했는지 확인합니다.

ParticipantEndReason 603

값이 603인 응답 ParticipantEndReason은(는) 연결되지 않고 호출이 거부되었음을 의미합니다.

SubCode 코드 메시지 결과 범주 조언
560603 603 - 수신자가 통화를 거부했습니다.
- 사기 감지로 인해 통화가 거부되었습니다.		 - 수신자가 거절한 경우 호출을 다시 시도합니다.
- Azure Communication Services 전화번호에 허용되는 최대 동시 호출 수를 초과하지 않는지 확인합니다. 자세한 내용은 PSTN 호출 제한을 참조하세요.

채팅 SDK 오류 코드

채팅 SDK는 채팅 문제를 해결하는 데 도움이 되는 다음 오류 코드를 사용합니다. 오류 코드는 오류 응답에서 error.code 속성을 통해 노출됩니다.

코드 메시지 조언
401 Unauthorized Communication Services 토큰이 유효하고 만료되지 않았는지 확인합니다.
403 금지 요청한 사람이 리소스에 액세스할 수 있는지 확인합니다.
429 Too many requests 클라이언트 쪽 애플리케이션이 사용자에게 친숙한 방식으로 이 시나리오를 처리하는지 확인합니다. 오류가 지속되면 지원 요청을 제출합니다.
503 Service Unavailable Azure Portal을 통해 지원 요청을 제출합니다.

SMS 오류 코드

SMS SDK는 SMS 문제를 해결하는 데 도움이 되는 다음 오류 코드를 사용합니다. 오류 코드는 SMS 배달 보고서의 DeliveryStatusDetails 필드를 통해 노출됩니다.

코드 메시지 조언
2000 메시지가 성공적으로 배달되었습니다.
4000 사기 감지로 인해 메시지가 거부되었습니다. 번호에 허용되는 최대 메시지 수를 초과하지 않고 있는지 확인합니다.
4001 잘못된 원본/보낸 사람 번호 형식으로 인해 메시지가 거부되었습니다. 받는 사람 번호가 E.164 형식이고 거는 사람 번호 형식이 E.164 또는 짧은 코드 형식인지 확인합니다.
4002 잘못된 대상/받는 사람 번호 형식으로 인해 메시지가 거부되었습니다. 받는 사람 번호가 E.164 형식인지 확인합니다.
4003 지원되지 않는 대상으로 인해 메시지를 배달하지 못했습니다. 보내려는 대상이 지원되는지 확인합니다.
4004 대상/대상 번호가 없으므로 메시지를 배달하지 못했습니다. 보내고 있는 받는 사람의 번호가 유효한지 확인합니다.
4005 대상 이동 통신 사업자가 차단한 메시지입니다.
4006 대상/받는 사람 번호에 연결할 수 없습니다. 나중에 메시지를 다시 보내 보세요.
4007 대상/받는 사람 번호가 사용자의 메시지 수신을 옵트아웃했습니다. 번호에 대한 추가 메시지 시도가 수행되지 않도록 대상/받는 사람 번호를 옵트아웃 상태로 표시합니다.
4008 프로필에 허용되는 최대 메시지 수를 초과했습니다. 번호에 허용되는 최대 메시지 수를 초과하거나 큐를 사용하여 메시지를 일괄 처리하지 않는지 확인합니다.
4009 Microsoft 권한 시스템에서 거부된 메시지입니다. 사기 행위가 감지되면 이 오류가 자주 발생합니다. 자세한 내용은 고객 지원팀에 문의하세요.
4010 확인되지 않는 무료 번호로 인해 메시지가 차단되었습니다. 확인되지 않은 보내기 제한을 검토하고 가능한 한 빨리 무료 검증을 제출합니다.
5000 메시지를 전송하지 못했습니다. 자세한 내용은 Microsoft 지원 팀에 문의하세요. Azure Portal을 통해 지원 요청을 제출합니다.
5001 애플리케이션/시스템의 임시 사용 불가로 인해 메시지를 배달하지 못했습니다.
5002 이동 통신 사업자는 전달 보고서를 지원하지 않습니다. 이동 통신 사업자가 전달 보고서를 지원하지 않는 경우 이 오류가 자주 발생합니다. 메시지가 이미 전달되었을 수 있으므로 아무 작업도 필요하지 않습니다.
9999 알 수 없는 오류/실패로 인해 메시지를 배달하지 못했습니다. 메시지를 다시 보내 보세요.