انتقل إلى المحتوى

استكشاف أخطاء Android و Chrome و Firefox وإصلاحها

الخطأالوصفما يجب فعله
AuthenticationErrorفشل مصادقة FCM بسبب بيانات اعتماد غير صالحة.تحقق من أن بيانات الاعتماد وServerKey وSenderID المحددة في لوحة تحكم Pushwoosh صحيحة.
DisabledFirebaseAPIتم تعطيل إرسال الإشعارات عبر بروتوكول HTTP v1 الجديد في وحدة تحكم FCM.قم بتمكين إرسال إشعارات Push في وحدة تحكم FCM باستخدام بروتوكول HTTP v1 الجديد.
EmptyCredentialsفشل إرسال إشعار Push باستخدام أي من بيانات الاعتماد المحددة. بيانات الاعتماد المحددة في لوحة تحكم Pushwoosh غير صالحة.أعد تكوين النظام الأساسي (الإعداداتتكوين النظام الأساسي).
FCMInternalServerErrorفشل FCM في تسليم الرسالة إلى الجهاز. هذا يعني عادةً أن خدمة FCM غير متاحة مؤقتًا.حاول مرة أخرى بعد فترة.
FrequencyCappingتمت تصفية الجهاز بواسطة تحديد التكرار (Frequency Capping).إذا لم يكن هذا السلوك مقصودًا، فتحقق من إعدادات تحديد التكرار (Frequency Capping).
InternalServerErrorفشل FCM في تسليم الرسالة إلى الجهاز. هذا يعني عادةً أن خدمة FCM غير متاحة مؤقتًا.حاول مرة أخرى بعد فترة.
InvalidCredentialsعند تكوين النظام الأساسي، أضفت JSON غير صحيح ببيانات اعتماد FCM أو حددت SenderID أو ServerKey غير صحيح.أعد تكوين النظام الأساسي باستخدام بيانات الاعتماد الصحيحة وSenderID وServerKey من وحدة تحكم FCM.
InvalidEndpointهذا خطأ داخلي في FCM يعني أن الإشعار يتم إرساله إلى عنوان غير صالح.حاول مرة أخرى بعد فترة.
InvalidPrivateKeyالمفتاح الخاص المحدد في حقل private_key في بيانات اعتماد FCM له بنية غير صالحة.أعد تكوين النظام الأساسي في لوحة تحكم Pushwoosh وأعد تحميل JSON ببيانات الاعتماد.
InvalidRegistrationرمز Push غير صالح؛ سيتم إلغاء اشتراك الجهاز من الإشعارات.استخدم الرمز الصالح وتحقق مما إذا كنت قد قمت بتمكين الإشعارات من تطبيقك على الجهاز.
MessageTooBigيتجاوز حجم الرسالة حد 4096 بايت الخاص بـ FCM.قلل حجم الرسالة التي ترسلها.
MistmatchSenderId

يحدث الخطأ لأحد الأسباب التالية:

  • معرف المرسل (Sender ID) المحدد في تطبيقك لا يتطابق مع معرف المرسل المحدد في لوحة تحكم Pushwoosh عند تكوين النظام الأساسي.
  • معرف المرسل في تطبيقك لا يتطابق مع معرف المرسل المرتبط ببيانات اعتماد FCM التي استخدمتها.
تأكد من أنك تستخدم معرف مرسل (Sender ID) صالحًا من Firebase Console في تطبيقك وتكوين نظام Pushwoosh الأساسي.
NotFoundهذا خطأ داخلي في FCM يعني أن خدمة FCM غير متاحة حاليًا.حاول مرة أخرى بعد فترة.
NotRegistered

الجهاز غير مسجل. تعني هذه الحالة أحد الأمور التالية:

  • تم إلغاء اشتراك الجهاز من الإشعارات؛
  • تم حذف التطبيق من الجهاز؛
  • انتهت صلاحية رمز Push الخاص بالجهاز.
حاول استخدام رمز جديد.
PermissionDeniedبيانات الاعتماد المحددة في لوحة تحكم Pushwoosh لا تمنح الإذن بإرسال إشعارات Push. هذا يعني أنه لا يمكن إرسال إشعارات Push من حساب FCM هذا.احصل على بيانات الاعتماد ذات الأذونات الصحيحة وفقًا لوثائق Firebase. عند إنشاء بيانات اعتماد لإرسال الرسائل، يجب أن يكون لديك دور Firebase Admin أو دور يمتلك إذن ‘cloudmessaging.messages.create’ .
SenderIDMistmatch

يحدث الخطأ لأحد الأسباب التالية:

  • معرف المرسل (Sender ID) المحدد في تطبيقك لا يتطابق مع معرف المرسل المحدد في لوحة تحكم Pushwoosh عند تكوين النظام الأساسي.
  • معرف المرسل في تطبيقك لا يتطابق مع معرف المرسل المرتبط ببيانات اعتماد FCM التي استخدمتها.
تأكد من أنك تستخدم معرف مرسل (Sender ID) صالحًا من Firebase Console في تطبيقك وتكوين نظام Pushwoosh الأساسي.
TokenIsEmpty

يمكن أن تسبب الأسباب التالية هذا الخطأ:

  • الجهاز لا يملك رمزًا (token).
  • لم يتم إرسال الرمز عند تسجيل الجهاز.
  • عند إرسال الطلب، لم يكن الجهاز يملك رمزًا، ولكن لسبب ما، تم إرساله إلى قاعدة بيانات أجهزتنا.
إذا كنت ترى هذا الخطأ بشكل متكرر، فيرجى الاتصال بفريق دعم العملاء لدينا.
Unavailableفشل إرسال الرسالة إلى FCM بعد عدة محاولات. هذا يعني عادةً أن خدمة FCM غير متاحة مؤقتًا.

حاول مرة أخرى بعد فترة.

إذا كنت ترى هذا الخطأ بشكل متكرر، فيرجى الاتصال بفريق دعم العملاء لدينا.

Unregistered

الجهاز غير مسجل. تعني هذه الحالة أحد الأمور التالية:

  • تم إلغاء اشتراك الجهاز من الإشعارات؛
  • تم حذف التطبيق من الجهاز؛
  • انتهت صلاحية رمز Push الخاص بالجهاز.
حاول استخدام رمز جديد.
UnsupportedTokenTypeالرمز غير صالح؛ سيتم إلغاء اشتراك الجهاز من الإشعارات.استخدم الرمز الصالح.