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

تأتي هذه الأخطاء من Firebase Cloud Messaging (FCM) عندما يرسل Pushwoosh إشعارات فورية إلى أجهزة Android أو Chrome أو Firefox.

الخطأ	الوصف	ما يجب فعله
AuthenticationError	فشل مصادقة FCM بسبب بيانات اعتماد غير صالحة.	تحقق من صحة بيانات الاعتماد و ServerKey و SenderID المحددة في لوحة تحكم Pushwoosh.
DisabledFirebaseAPI	تم تعطيل إرسال الإشعارات الفورية عبر بروتوكول HTTP v1 الجديد في وحدة تحكم FCM.	قم بتمكين إرسال الإشعارات الفورية في وحدة تحكم FCM باستخدام بروتوكول HTTP v1 الجديد.
EmptyCredentials	فشل إرسال إشعار فوري باستخدام أي من بيانات الاعتماد المحددة. بيانات الاعتماد المحددة في لوحة تحكم 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 token) غير صالح؛ سيتم إلغاء اشتراك الجهاز من الإشعارات.	استخدم الرمز الصالح وتحقق مما إذا كنت قد قمت بتمكين الإشعارات من تطبيقك على الجهاز.
MessageTooBig	حجم الرسالة يتجاوز حد FCM البالغ 4096 بايت.	قلل حجم الرسالة التي ترسلها.
MistmatchSenderId	يحدث الخطأ لأحد الأسباب التالية: معرف المرسل (sender ID) المحدد في تطبيقك لا يتطابق مع معرف المرسل المحدد في لوحة تحكم Pushwoosh عند تكوين المنصة. معرف المرسل في تطبيقك لا يتطابق مع معرف المرسل المرتبط ببيانات اعتماد FCM التي استخدمتها.	تأكد من أنك تستخدم معرف مرسل (sender ID) صالحًا من Firebase Console في تطبيقك وفي تكوين منصة Pushwoosh.
NotFound	هذا خطأ داخلي في FCM يعني أن خدمة FCM غير متاحة حاليًا.	حاول مرة أخرى بعد فترة.
NotRegistered	الجهاز غير مسجل. تعني هذه الحالة أحد الأمور التالية: تم إلغاء اشتراك الجهاز من الإشعارات؛ تم حذف التطبيق من الجهاز؛ انتهت صلاحية رمز الإشعار الفوري (push token) للجهاز.	حاول استخدام رمز جديد.
PermissionDenied	بيانات الاعتماد المحددة في لوحة تحكم Pushwoosh لا تمنح الإذن لإرسال الإشعارات الفورية. هذا يعني أنه لا يمكن إرسال الإشعارات الفورية من حساب FCM هذا.	احصل على بيانات الاعتماد بالأذونات الصحيحة وفقًا لـ وثائق Firebase. عند إنشاء بيانات اعتماد لإرسال الرسائل، يجب أن يكون لديك دور Firebase Admin أو دور لديه إذن ‘cloudmessaging.messages.create’.
SenderIDMistmatch	يحدث الخطأ لأحد الأسباب التالية: معرف المرسل (sender ID) المحدد في تطبيقك لا يتطابق مع معرف المرسل المحدد في لوحة تحكم Pushwoosh عند تكوين المنصة. معرف المرسل في تطبيقك لا يتطابق مع معرف المرسل المرتبط ببيانات اعتماد FCM التي استخدمتها.	تأكد من أنك تستخدم معرف مرسل (sender ID) صالحًا من Firebase Console في تطبيقك وفي تكوين منصة Pushwoosh.
TokenIsEmpty	يمكن أن تسبب الأسباب التالية هذا الخطأ: الجهاز لا يملك رمزًا (token). لم يتم إرسال الرمز عند تسجيل الجهاز. عند إرسال الطلب، لم يكن لدى الجهاز رمز، ولكن لسبب ما، تم إرساله إلى قاعدة بيانات أجهزتنا.	إذا كنت ترى هذا الخطأ بشكل متكرر، يرجى الاتصال بـ فريق دعم العملاء لدينا.
Unavailable	فشل إرسال الرسالة إلى FCM بعد عدة محاولات. هذا يعني عادةً أن خدمة FCM غير متاحة مؤقتًا.	حاول مرة أخرى بعد فترة. إذا كنت ترى هذا الخطأ بشكل متكرر، يرجى الاتصال بـ فريق دعم العملاء لدينا.
Unregistered	الجهاز غير مسجل. تعني هذه الحالة أحد الأمور التالية: تم إلغاء اشتراك الجهاز من الإشعارات؛ تم حذف التطبيق من الجهاز؛ انتهت صلاحية رمز الإشعار الفوري (push token) للجهاز.	حاول استخدام رمز جديد.
UnsupportedTokenType	الرمز (token) غير صالح؛ سيتم إلغاء اشتراك الجهاز من الإشعارات.	استخدم الرمز الصالح.