콘텐츠로 건너뛰기

Android, Chrome, Firefox 오류 문제 해결

ErrorDescriptionWhat to do
AuthenticationError유효하지 않은 자격 증명으로 인해 FCM 인증에 실패했습니다.Pushwoosh Control Panel 에 지정된 자격 증명, ServerKey 및 SenderID 가 올바른지 확인합니다.
DisabledFirebaseAPIFCM 콘솔에서 새 HTTP v1 프로토콜을 통한 푸시 전송이 비활성화되었습니다.새 HTTP v1 프로토콜을 사용하여 FCM Console 에서 푸시 알림 전송을 활성화합니다.
EmptyCredentials지정된 자격 증명 중 어느 것도 사용하여 푸시 알림을 보내는 데 실패했습니다. Pushwoosh Control Panel 에 지정된 자격 증명이 유효하지 않습니다.플랫폼을 재구성합니다 (SettingsConfigure platform).
FCMInternalServerErrorFCM 이 기기로 메시지를 전달하는 데 실패했습니다. 이는 일반적으로 FCM 서비스가 일시적으로 사용할 수 없음을 의미합니다.잠시 후 다시 시도합니다.
FrequencyCapping기기가 Frequency Capping 에 의해 필터링되었습니다.이러한 동작이 의도된 것이 아닌 경우, Frequency Capping 설정을 확인합니다.
InternalServerErrorFCM 이 기기로 메시지를 전달하는 데 실패했습니다. 이는 일반적으로 FCM 서비스가 일시적으로 사용할 수 없음을 의미합니다.잠시 후 다시 시도합니다.
InvalidCredentials플랫폼을 구성할 때, FCM 자격 증명과 함께 잘못된 JSON 을 추가했거나 잘못된 SenderID 또는 ServerKey 를 지정했습니다.FCM Console 에서 올바른 자격 증명, SenderID 및 ServerKey 를 사용하여 플랫폼을 재구성합니다.
InvalidEndpoint이는 푸시가 유효하지 않은 주소로 전송되었음을 의미하는 내부 FCM 오류입니다.잠시 후 다시 시도합니다.
InvalidPrivateKeyFCM 자격 증명의 private_key 필드에 지정된 개인 키 구조가 유효하지 않습니다.Pushwoosh Control Panel 에서 플랫폼을 재구성하고 자격 증명과 함께 JSON 을 다시 업로드합니다.
InvalidRegistration푸시 토큰이 유효하지 않습니다. 기기는 알림 구독이 해지됩니다.유효한 토큰을 사용하고 기기에서 앱의 알림을 활성화했는지 확인합니다.
MessageTooBig메시지 크기가 4096 bytes FCM 제한을 초과합니다.보내는 메시지 크기를 줄입니다.
MistmatchSenderId

이 오류는 다음 이유 중 하나로 발생합니다:

  • 앱에 지정된 Sender ID 가 플랫폼 구성 시 Pushwoosh Control Panel 에 지정된 Sender ID 와 일치하지 않습니다.
  • 앱의 Sender ID 가 사용한 FCM 자격 증명과 연결된 Sender ID 와 일치하지 않습니다.
애플리케이션 및 Pushwoosh 플랫폼 구성에서 Firebase Console 의 유효한 Sender ID 를 사용하고 있는지 확인합니다.
NotFound이는 FCM 서비스가 현재 사용할 수 없음을 의미하는 내부 FCM 오류입니다.잠시 후 다시 시도합니다.
NotRegistered

기기가 등록되지 않았습니다. 이 상태는 다음 중 하나를 의미합니다:

  • 기기가 알림 구독이 해지되었습니다;
  • 애플리케이션이 기기에서 삭제되었습니다;
  • 기기의 푸시 토큰이 만료되었습니다.
새 토큰을 사용해 봅니다.
PermissionDeniedPushwoosh Control Panel 에 지정된 자격 증명은 푸시 알림을 보낼 권한을 부여하지 않습니다. 이는 이 FCM 계정에서 푸시 알림을 보낼 수 없음을 의미합니다.Firebase documentation 에 따라 올바른 권한을 가진 자격 증명을 가져옵니다. 메시지를 보내기 위한 자격 증명을 생성할 때, Firebase Admin 역할 또는 cloudmessaging.messages.create 권한을 가진 역할이 있어야 합니다.
SenderIDMistmatch

이 오류는 다음 이유 중 하나로 발생합니다:

  • 앱에 지정된 Sender ID 가 플랫폼 구성 시 Pushwoosh Control Panel 에 지정된 Sender ID 와 일치하지 않습니다.
  • 앱의 Sender ID 가 사용한 FCM 자격 증명과 연결된 Sender ID 와 일치하지 않습니다.
애플리케이션 및 Pushwoosh 플랫폼 구성에서 Firebase Console 의 유효한 Sender ID 를 사용하고 있는지 확인합니다.
TokenIsEmpty

다음 이유로 오류가 발생할 수 있습니다:

  • 기기에 토큰이 없습니다.
  • 기기 등록 시 토큰이 전송되지 않았습니다.
  • 요청 전송 시 기기에 토큰이 없었지만, 어떤 이유로 인해 당사 기기 데이터베이스로 전송되었습니다.
이 오류가 자주 발생하는 경우, Customer Support Team 에 문의하십시오.
Unavailable여러 번 시도한 후 FCM 으로 메시지를 보내는 데 실패했습니다. 이는 일반적으로 FCM 서비스가 일시적으로 사용할 수 없음을 의미합니다.

잠시 후 다시 시도합니다.

이 오류가 자주 발생하는 경우, Customer Support Team 에 문의하십시오.

Unregistered

기기가 등록되지 않았습니다. 이 상태는 다음 중 하나를 의미합니다:

  • 기기가 알림 구독이 해지되었습니다;
  • 애플리케이션이 기기에서 삭제되었습니다;
  • 기기의 푸시 토큰이 만료되었습니다.
새 토큰을 사용해 봅니다.
UnsupportedTokenType토큰이 유효하지 않습니다. 기기는 알림 구독이 해지됩니다.유효한 토큰을 사용합니다.