다음을 통해 공유

통화 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 화면 공유를 시작하지 못했습니다. 통화가 연결된 상태가 아닙니다. 통화가 연결되는 때를 알도록 통화의 stateChanged 이벤트를 구독합니다. 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 호출이 클라이언트 SDK, 통화 자동화, 그래프, PSTN 또는 Teams 거부 함수를 통해 대상 사용자로부터 거부되었기 때문에 종료되었습니다.
7 496 클라이언트가 갑자기 네트워크 연결을 끊고 여러 번 다시 시도했음에도 불구하고 연결할 수 없어 통화가 종료되었습니다. ExpectedError 브라우저가 오프라인 상태이거나 네트워크 문제가 있습니다. 브라우저의 네트워크 연결을 확인하고 다시 시도합니다.
3100 410 클라이언트에서 예기치 않은 네트워크 문제로 인해 호출 설정이 실패하고 클라이언트의 네트워크를 확인하고 다시 시도합니다. UnxpectedClientError 네트워크 구성을 확인하고 Azure Communication Calling 네트워크 요구 사항을 따르는지 확인합니다.
3101 410 클라이언트에서 예기치 않은 네트워크 문제로 인해 통화가 끊어졌으며 클라이언트의 네트워크를 확인하고 다시 시도합니다. UnxpectedClientError 네트워크 구성을 확인하고 Azure Communication Calling 네트워크 요구 사항을 따르는지 확인합니다.
3111 410 통화 설정이 실패하여 통화를 연결하는 동안 미디어 제안을 처리할 수 없습니다. UnxpectedClientError 다시 시도하세요. 문제가 지속되면 통화 정보, 클라이언트 로그, 브라우저 콘솔 로그를 수집하고 Azure Communication Services 지원에 문의하세요.
3112 410 클라이언트 쪽의 네트워크 구성 문제로 인해 호출 설정이 실패하고, 클라이언트의 네트워크 구성을 확인하고, 다시 시도합니다. ExpectedError 3112 의 하위 코드로 끝나는 통화에 대한 자세한 내용은 여기를 참조하세요.
4097 0 모임 주최자가 모든 사용자의 통화를 종료했습니다. Success
4502 490 네트워크 연결 문제로 인해 호출이 실패했고 브라우저에서 네트워크 HTTP 요청을 완료하지 못했습니다. UnexpectedClientError 클라이언트가 HTTP 요청 및 응답을 완료하지 못했습니다. 다시 시도하세요. 문제가 지속되면 통화 정보, 클라이언트 로그, 브라우저 콘솔 로그를 수집하고 Azure Communication Services 지원에 문의하세요.
4506 408 통화 시간이 초과되었습니다. 발신자가 전화를 받고 수락했는지 확인합니다. UnexpectedClientError 다시 시도하세요. 문제가 지속되면 통화 정보, 클라이언트 로그, 브라우저 콘솔 로그를 수집하고 Azure Communication Services 지원에 문의하세요.
4507 495 애플리케이션이 유효한 Azure Communication Services 토큰을 제공하지 않아 통화가 종료되었습니다. UnexpectedClientError 애플리케이션이 토큰 새로 고침 메커니즘을 올바르게 구현하는지 확인합니다.
4521 0 사용자가 갑자기 통화 연결을 끊어 통화가 종료되었습니다. 이는 사용자가 적절한 중단 없이 브라우저 탭을 닫아 애플리케이션을 종료하는 등 호출을 호스트한 애플리케이션을 닫아서 발생할 수 있습니다. ExpectedError
5000 0 이 참가자에 대한 통화가 종료되었습니다. 다른 참가자가 대화에서 참가자를 제거했습니다. Success
5003 0 모든 수신자 엔드포인트가 통화를 거부하여 통화가 성공적으로 종료되었습니다. Success
5300 0 다른 참가자가 대화에서 이 참가자를 제거하여 해당 참가자의 통화가 종료되었습니다. Success 다른 참가자가 이를 제거하면 이 참가자에 대한 호출이 종료되었으며, 다른 클라이언트인 Call Automation API, Graph API일 수 있습니다.
5,317 0 참가자 역할 업데이트로 인해 대상 참가자가 제거됩니다. ExpectedError
5828 403 사용자가 초대 대상 목록에 속하지 않으므로 채팅방 모임에 참가할 수 있는 권한이 없습니다. UnexpectedClientError
5829 403 종료 시간 이후 또는 모임 시작 시간 이전에 회의실 모임에 참가할 수 없습니다. UnexpectedClientError
5830 403 Communication Services 사용자만 룸 모임에 참가할 수 있습니다. ExpectedError
7000 0 호출은 Azure Communication Service Call Automation API 또는 서버 봇에 의해 종료되었습니다. Success 호출은 ACS 호출 자동화 API 또는 그래프 봇에 의해 종료되었습니다.
10003 487 다른 엔드포인트에서 다른 곳에서 수락되었으므로 이 사용자 엔드포인트에 대한 호출이 취소되었습니다. Success 대상 사용자(통화 시작, 참가자 추가, 전송)에 대한 호출이 시작되었으며, 대상 사용자에게는 동시에 여러 활성 엔드포인트가 있었고, 엔드포인트 사용자 중 한 명이 통화를 수락했습니다. 이는 정상적인 동작이며, 하나의 엔드포인트만 호출을 수락하고 연결할 수 있습니다. 다른 모든 엔드포인트는 호출이 이미 수락되었음을 나타내기 위해 하위 코드 10003을 받습니다.
10004 487 대상 사용자가 정시에 수락하거나 거부하지 않았기 때문에 시간 제한 시 통화가 취소되었습니다. 사용자가 알림 및/또는 애플리케이션이 자동으로 처리할 수 있는지 확인하고 해당 호출을 다시 시작합니다. ExpectedError 대상 사용자가 수락하거나 거부하지 않았기 때문에 미리 정의된 시간(일반적으로 2분) 후에 호출이 취소되었습니다.
10009 401 인증되지 않은 ID입니다. Azure Communication Services 토큰이 유효하고 만료되지 않았는지 확인합니다. UnexpectedClientError
10024 487 통화가 종료되었습니다. 모든 수신자 엔드포인트에서 통화가 거부되었습니다. Success 통화를 다시 시도합니다.
10037 480 대상 사용자에게 ACS에 등록된 엔드포인트가 없습니다. 대상 사용자에게 활성 엔드포인트가 하나 이상 있고 온라인 상태인지 확인합니다. ExpectedError 대상 사용자가 Azure Communication Services 통화 SDK를 사용하는 경우 클라이언트 애플리케이션에서 SDK가 성공적으로 초기화되었는지 확인합니다. 대상 사용자가 Teams 사용자인 경우 클라이언트가 온라인인지 확인합니다. 대상 사용자의 식별자(CommunicationUserIdentifier, MicrosoftTeamsUserIdentifier 또는 MicrosoftTeamsBotIdentifier)가 올바른지 확인합니다. Graph API user 에 속성 department 이 설정된 Microsoft Communication Application Instance MicrosoftTeamsBotIdentifier 경우 지정해야 합니다.
10057 408 통화가 실패했거나, 수신자가 통화 설정을 완료하지 못했거나, 대부분의 경우 수신자의 네트워크가 끊겼거나, 애플리케이션을 갑자기 종료했습니다. 클라이언트가 연결되어 있고 사용 가능한지 확인합니다. ExpectedError
10076 480 대상 사용자가 등록되었지만 통화 당시에는 온라인 상태가 아니었습니다. 대상 사용자에게 활성 엔드포인트가 하나 이상 있고 온라인 상태인지 확인합니다. ExpectedError 대상 사용자가 Azure Communication Services 통화 SDK를 사용하는 경우 클라이언트 애플리케이션에서 SDK가 성공적으로 초기화되고 해당 엔드포인트가 온라인 상태인지 확인합니다. 대상 사용자가 Teams 사용자인 경우 클라이언트가 온라인인지 확인합니다.
10077 480 대상 사용자가 ACS 및/또는 푸시 알림에 등록되었지만 통화 당시에는 온라인 상태가 아니었습니다. 대상 사용자에게 활성 엔드포인트가 하나 이상 있고 온라인 상태인지 확인합니다. ExpectedError 대상 사용자가 Azure Communication Services 통화 SDK를 사용하는 경우 클라이언트 애플리케이션에서 SDK가 성공적으로 초기화되고 해당 엔드포인트가 온라인 상태인지 확인합니다. 애플리케이션이 푸시 알림을 활용하는 경우 올바르게 구성되었는지 확인합니다. 대상 사용자가 Teams 사용자인 경우 클라이언트가 온라인인지 확인합니다.
10078 480 원격 클라이언트 엔드포인트가 등록되지 않았거나 연결할 수 없습니다. 원격 클라이언트 엔드포인트가 Azure Communication Services에 네트워크 요청을 성공적으로 보내고 있는지 확인합니다. ExpectedError - 대상 사용자가 Azure Communication Services Calling SDK를 사용하는 경우 클라이언트 애플리케이션에서 SDK가 성공적으로 초기화되고 해당 엔드포인트가 온라인 상태인지 확인합니다. 애플리케이션이 푸시 알림을 활용하는 경우 올바르게 구성되었는지 확인합니다.
- 대상 사용자가 Teams 사용자인 경우 클라이언트가 온라인인지 확인합니다.
301004 410 통화 설정 중에 Azure Communication Services 인프라와의 미디어 연결을 설정할 수 없어서 참가자가 Azure Communication Services 인프라에 의해 호출에서 제거되었습니다. 로컬 네트워크, 방화벽, VPN 구성을 비롯한 사용자의 네트워크 구성을 확인하고 다시 시도합니다. UnexpectedClientError 사용자의 네트워크가 올바르게 구성되었는지 확인하려면 '네트워크 권장 사항' 공개 설명서를 따르세요.
301005 410 동일한 인프라를 사용한 미디어 연결 손실로 인해 Azure Communication Services 인프라의 호출에서 참가자가 제거되었습니다. 이는 일반적으로 참가자가 갑자기 전화를 끊거나 네트워크 연결이 끊어지는 경우에 발생합니다. 참가자는 통화를 계속하려면 다시 연결할 수 있습니다. UnexpectedClientError 지원되는 환경에서 최신 SDK를 사용하고 있는지 확인합니다.
540000 0 로컬 PSTN 호출자가 호출을 성공적으로 종료했습니다. Success
510403 403 통화가 종료되고 이전에 스팸으로 표시되어 이제 차단되었습니다. ExpectedError - Communication Services 토큰이 유효하고 만료되지 않았는지 확인합니다.
- 통화 옵션에서 AlternateId을(를) 전달해야 합니다.
540487 487 발신자가 통화를 취소하여 통화가 성공적으로 종료되었습니다. Success
560000 0 원격 PSTN 참가자가 통화를 성공적으로 종료했습니다. Success 가능한 원인:
- 사용자가 통화를 종료했습니다.
- 미디어 에이전트가 통화를 종료했습니다.
560486 486 원격 PSTN 참가자가 통화 중이어서 통화가 종료되었습니다. 전화를 건 번호는 이미 통화 중이거나 기술적인 문제가 있는 번호입니다. Success - 직접 라우팅 통화의 경우 세션 경계 제어 로그와 설정 및 시간 제한 구성을 확인합니다. 가능한 원인: 호출된 번호가 이미 통화 중이거나 기술적인 문제가 발생했습니다.
404 호출을 찾을 수 없습니다. 통화하는 번호(또는 조인하는 통화)가 있는지 확인합니다.
408 통화 컨트롤러 시간이 초과되었습니다. 사용자 엔드포인트에서 프로토콜 메시지를 기다리는 동안 통화 컨트롤러 시간이 초과되었습니다. 클라이언트가 연결되어 있고 사용 가능한지 확인합니다.
410 로컬 미디어 스택 또는 미디어 인프라 오류입니다. 지원되는 환경에서 최신 SDK를 사용하고 있는지 확인합니다.
430 클라이언트 애플리케이션에 메시지를 전달할 수 없습니다. 클라이언트 애플리케이션이 실행 중이고 사용 가능한지 확인합니다.
480 원격 클라이언트 엔드포인트가 등록되지 않았습니다. 원격 엔드포인트를 사용할 수 있는지 확인합니다.
481 들어오는 호출을 처리하지 못했습니다. Azure Portal을 통해 지원 요청을 제출합니다.
490, 491, 496, 497, 498 로컬 엔드포인트 네트워크 문제. 네트워크 구성을 확인하고 Azure Communication Calling 네트워크 요구 사항을 따르는지 확인합니다.
500, 503, 504 Communication Services 인프라 오류입니다. Azure Portal을 통해 지원 요청을 제출합니다.

호출 코드 및 하위 코드 이해

오류 코드는 언제 수신되나요?

호출 자동화에 대한 오류 코드는 제공된 콜백 URI를 통해 API 호출에 대한 동기 응답 또는 비동기 응답으로 제공될 수 있습니다. 동기 상황에서 API 호출이 이루어지고 수락되지 않는 경우 ACS는 API 호출이 거부된 이유를 설명하는 오류 코드를 제공합니다. 비동기 시나리오에서 API 호출이 이루어지고 수락되었지만 여전히 문제가 발생하는 경우 콜백 이벤트와 오류 코드가 모두 수신됩니다. 호출 실패 callDisconnected 에 대한 일반적인 콜백 이벤트의 예는 호출 연결이 끊어질 때마다 표시되는 이벤트입니다. callDisconnected 이벤트가 수신되면 지정된 호출에 대한 콜백 이벤트가 더 이상 발생하지 않습니다. 호출 신호 콜백 이벤트 목록은 (이 페이지) 및 미디어 작업에 대한 콜백 이벤트 목록을 참조하세요(이 페이지).

오류 코드 구문

오류 코드, 하위 코드 및 해당 결과 범주는 개발자가 오류를 식별하고 진단하는 데 도움이 됩니다. 오류 코드 세부 정보에는 다음이 포함됩니다.

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

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

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

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

코드 및 하위 코드 외에도 더 자세한 문제 해결 정보는 호출 로그에서 찾을 수 있습니다. 호출 로그를 사용하도록 설정하고 액세스하는 방법에 대한 자세한 내용은 이 페이지에서 자세한 지침을 참조하세요.

통화 자동화 SDK 오류 코드

다음 표에는 가장 일반적인 코드 및 하위 코드가 포함되어 있습니다. 이 표에 오류가 없는 경우 일반 코드 및 하위 코드를 참조하여 특정 시나리오에 대한 자세한 정보를 확인하세요.

가장 일반적인 호출 자동화 오류 코드

코드 하위 코드 설명 완화 방법
404 8522 리소스를 찾을 수 없음을 나타내는 일반 오류 코드입니다. 리소스에는 통화 및 참가자가 포함될 수 있습니다. 통화 상태를 다시 확인합니다. 통화가 이미 종료되었거나 참가자가 전화를 끊었을 수 있습니다.
400 8523 요청 본문에 있는 항목이 잘못되었음을 나타내는 제네릭 오류 코드입니다. 모든 매개 변수가 유효한지 확인합니다. 오류를 throw하는 매개 변수를 확인하려면 오류 메시지를 참조하세요.
400 8501 지원되지 않는 작업 호출이 설정되지 않음 호출이 활성화되지 않은 동안 오류 메시지와 관련된 작업이 활성화되었습니다. 통화 연결이 끊긴 후 새 호출 작업이 시작되지 않았는지 확인합니다. 이 오류는 통화 연결이 끊긴 시간에 가까운 경우 호출이 활성 상태인 동안 호출된 작업으로 인해 발생할 수도 있습니다.
400 8500 미디어 모드가 잘못되었습니다. 미디어 작업의 상태를 확인하여 이미 활성 상태인지 또는 대상 참가자가 이미 미디어 작업에 있는지 확인합니다. 활성 미디어 작업이 있는 경우 작업이 완료되기를 기다린 다음 다시 시도합니다.
400 8559 단일 전화 접속 앱만 지원되지 않는 작업 이미 시작되었거나 진행 중인 녹음/녹화 요청을 복제합니다. 녹음/녹화 상태를 다시 확인하여 새 녹음/녹화 통화를 제출하기 전에 비활성 상태인지 확인합니다.
400 8528 지원되지 않는 호출이 종료됨 호출이 종료되는 동안 오류 메시지와 관련된 작업이 활성화되었습니다. 호출이 종료된 후 새 호출 작업이 시작되지 않는지 확인합니다. 이 오류는 호출 종료 시간에 가까운 경우 호출이 활성 상태인 동안 호출된 작업으로 인해 발생할 수도 있습니다.
409 8519 충돌 동일한 리소스에서 여러 작업이 병렬로 수행되지 않는지 확인합니다. 충돌하는 두 작업을 식별하려면 오류 메시지를 참조하세요.
403 7507 호출 원본 ID가 잘못되었습니다. 권한 부여 토큰의 애플리케이션 ID가 호출 원본의 애플리케이션 ID와 일치하지 않습니다. 수신 통화 웹후크가 구성된 ACS 리소스의 연결 문자열 사용하고 있는지 확인합니다(전화 번호는 통화에 응답하는 동일한 ACS 리소스가 소유해야 함).
403 7504 애플리케이션 사용 권한 부족 권한이 부족한 일반 코드는 권한이 부족한 리소스에 대한 컨텍스트에 대한 오류 메시지를 확인합니다.
400 8585 현재 호출 상태에서 유효하지 않은 작업 통화가 설정되지 않았거나 연결이 끊어졌습니다. 미디어 작업을 다시 시도하기 전에 통화가 설정될 때까지 기다립니다.
405 8520 현재 지원되지 않는 기능 예상 오류: 워크플로가 현재 지원되지 않습니다. 릴리스 블로그를 확인하여 이러한 기능을 사용하도록 설정한 업데이트된 SDK가 있는지 확인합니다. 지원되지 않는 워크플로 목록은 호출 자동화 알려진 제한 사항 페이지를 참조하세요.
412 8583 Precondition Failed 호환되지 않는 미디어 작업을 실행하거나 큐에 대기하지 않도록 하려면 호환되지 않는 미디어 작업을 나열하는 이 페이지를 참조하세요.
400 8567 ACS 리소스 서비스 주체를 사용할 수 없음 Azure Cognitive Service 리소스가 제대로 구성되지 않았습니다. Azure Cognitive Service 리소스 설정에 대한 가이드는 이 페이지를 참조하세요.
405 8522 누락된 구성 구성을 설정해야 하는 더 많은 컨텍스트에 대한 오류 메시지를 확인합니다. 이 구성은 AnswerCall API를 호출할 때 발생해야 합니다.

일반 오류 코드

2xx 코드

2xx 코드는 성공적인 응답을 나타냅니다. 성공적인 응답에 대한 하위 코드는 0입니다.

4xx 코드

4xx 코드는 클라이언트 오류를 나타냅니다.

상태 코드 설명
400 Bad request
401 Unauthorized
403 금지
404 없습니다.
405 Method not allowed
406 허용되지 않음
408 Timed out
409 충돌
412 Precondition failed
413 엔터티가 너무 큰 요청
426 업그레이드 필요
429 Too many requests
481 트랜잭션이 없습니다.
487 취소됨

5xx 코드

5xx 코드는 서버 오류를 나타냅니다.

상태 코드 설명
500 내부 서버 오류
501 구현되지 않음
502 나쁜 게이트웨이
503 Service Unavailable
504 게이트웨이 시간 초과

6xx 코드

6xx 코드는 전역 오류를 나타냅니다.

상태 코드 설명
603 거부함

제네릭 하위 코드

하위 코드 설명
0 Success
7000 정상
7,500 지원되지 않는 AAD ID
7501 Invalid Token
7502 Access Not Enabled
7504 애플리케이션 사용 권한 부족
7505 엔터프라이즈 테넌트 불일치
7506 신뢰할 수 없는 인증서
7507 호출 원본 ID가 잘못되었습니다.
7508 지원되지 않는 ACS ID
7509 Hmac 유효성 검사 오류
7510 관리 ID 유효성 검사 오류
7600 리소스 액세스를 사용할 수 없음
7601 ACS 원본 ID가 잘못되었습니다.
7602 ACS 대상 ID가 잘못되었습니다.
7603 잘못된 ACS ID
7604 권한 없는 Teams Interop 시나리오
7605 권한 없는 Teams 기록 Interop 시나리오
7606 인식 작업에 대한 권한 없는 ACS 리소스
8500 미디어 모드가 잘못되었습니다.
8501 통화 설정 안 됨
8502 내 참가자 ID를 사용할 수 없음
8503 미디어 상태 오디오 비활성 호출
8504 미디어 스트림을 사용할 수 없음
8505 대체가 있는 여러 참가자
8506 비준수 녹음/녹화 통화
8508 작업 취소됨
8509 최대 침묵 시간 제한에 도달했습니다.
8510 초기 침묵 시간 제한에 도달했습니다.
8511 재생 프롬프트 실패
8512 경고음 재생 실패
8513 미디어 수신 시간 제한
8514 중지 톤이 감지됨
8515 최대 레코드 기간에 도달했습니다.
8516 통화 제한
8517 호출 테넌트 ID 불일치
8518 호출 예외
8519 충돌
8520 Not Implemented
8521 너무 많은 홉
8522 Not Found
8523 잘못된 인수
8524 규정 준수 기록에 대한 참가자 수가 잘못되었습니다.
8525 기록되지 않은 파티
8526 잘못된 조인 토큰
8527 잘못된 조인 URL
8528 종료된 호출
8529 통화 제한 월별 제한에 도달했습니다.
8530 통화 제한 활성 호출 제한에 도달했습니다.
8531 받은 최대 자릿수
8532 숫자 간 시간 제한에 도달했습니다.
8533 Dtmf 옵션 일치
8534 잘못된 톤 입력됨
8535 잘못된 파일 형식
8536 파일 다운로드 실패
8537 활성 시간 제한 도달 유지
8538 수신자 거부됨
8539 통화 중인 수신자
8,540 모든 곳에서 통화 중인 수신자
8541 호출 수신자 사용할 수 없음
8542 통화 취소됨
8543 호출이 없습니다.
8544 호출 수신자에게 연결할 수 없음
8545 음성 옵션이 일치됨
8546 호출 수신자가 잘못된 요청을 보냈습니다.
8547 음성 옵션이 일치하지 않음
8548 통화가 그룹 통화가 아님
8549 대상 다시 지정 대화 만들기 실패
8550 대상 다시 지정 미디어 협상 실패
8551 대상 다시 지정이 지원되지 않음
8552 이끌이를 제거할 수 없습니다.
8553 중복 기록
8554 모임 중 참가자 오디오 믹스
8555 이미 진행 중인 대상 다시 지정
8556 CR 호출에 대해 지원되지 않는 작업
8557 형식 유형이 잘못되었습니다.
8558 참가자가 없음
8559 중복된 단일 전화 접속
8560 잠긴 모임으로 인해 대화 참가가 차단됨
8561 모임에 참가 ID가 잘못되었습니다.
8562 기록 모드가 지원되지 않음
8563 음성 인식 안 됨
8564 Speech Service 연결 오류
8565 Cognitive Services 오류
8566 음소거 해제 작업 허용 안 됨
8567 ACS 리소스 서비스 주체를 사용할 수 없음
8568 Cognitive Service 요청에 대한 관리 ID 실패
8571 기록 작업 충돌
8569 음성 인식됨
8570 Cognitive Services 음성 인식 오류
8572 서비스 종료 재생
8573 Resume 메서드 일시 중지 허용 안 됨
8578 전사 실패
8579 전사 취소됨
8580 전사 서비스 종료
8581 잘못된 스트림 URL
8582 원본 텍스트 또는 Ssml 비어 있음 재생
8583 Precondition Failed
8585 현재 호출 상태에서 유효하지 않은 작업
8586 봇에서 승인되지 않은 수신 호출
8587 수신 전화가 시간 내에 응답하지 않음
8588 레코드 완료 및 미디어 수신 시간 제한
8589 레코드 제한
8594 모임 상태 업데이트 실패
8603 미디어 스트리밍 실패
8604 미디어 스트리밍 취소됨
8605 전사 사용자 지정 음성 모델이 지원되지 않음
8,606 통신 식별자 만들기 실패
8607 전송 작업 충돌
8608 참가자 클라이언트 기록 오류
8609 봇의 잘못된 조인 응답
8610 알림 시 봇의 응답 없음
8613 통화 제한 라이브 캡션 제한에 도달했습니다.
9001 기본 서비스에서 알 수 없는 오류
9002 기본 서비스의 시간 제한 오류
9003 작업 취소됨 오류
9998 심각한 오류
9999 Unknown

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 알 수 없는 오류/실패로 인해 메시지를 배달하지 못했습니다. 메시지를 다시 보내 보세요.