استكشاف أخطاء 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) صالحًا من Firebase Console في تطبيقك وتكوين نظام Pushwoosh الأساسي. |
| NotFound | هذا خطأ داخلي في FCM يعني أن خدمة FCM غير متاحة حاليًا. | حاول مرة أخرى بعد فترة. |
| NotRegistered | الجهاز غير مسجل. تعني هذه الحالة أحد الأمور التالية:
| حاول استخدام رمز جديد. |
| PermissionDenied | بيانات الاعتماد المحددة في لوحة تحكم Pushwoosh لا تمنح الإذن بإرسال إشعارات Push. هذا يعني أنه لا يمكن إرسال إشعارات Push من حساب FCM هذا. | احصل على بيانات الاعتماد ذات الأذونات الصحيحة وفقًا لوثائق Firebase. عند إنشاء بيانات اعتماد لإرسال الرسائل، يجب أن يكون لديك دور Firebase Admin أو دور يمتلك إذن ‘cloudmessaging.messages.create’ . |
| SenderIDMistmatch | يحدث الخطأ لأحد الأسباب التالية:
| تأكد من أنك تستخدم معرف مرسل (Sender ID) صالحًا من Firebase Console في تطبيقك وتكوين نظام Pushwoosh الأساسي. |
| TokenIsEmpty | يمكن أن تسبب الأسباب التالية هذا الخطأ:
| إذا كنت ترى هذا الخطأ بشكل متكرر، فيرجى الاتصال بفريق دعم العملاء لدينا. |
| Unavailable | فشل إرسال الرسالة إلى FCM بعد عدة محاولات. هذا يعني عادةً أن خدمة FCM غير متاحة مؤقتًا. | حاول مرة أخرى بعد فترة. إذا كنت ترى هذا الخطأ بشكل متكرر، فيرجى الاتصال بفريق دعم العملاء لدينا. |
| Unregistered | الجهاز غير مسجل. تعني هذه الحالة أحد الأمور التالية:
| حاول استخدام رمز جديد. |
| UnsupportedTokenType | الرمز غير صالح؛ سيتم إلغاء اشتراك الجهاز من الإشعارات. | استخدم الرمز الصالح. |