الإشعارات: الجرس والبريد الإلكتروني وأجهزة الجوال

الغرض#

تُبلغ المنصة الأشخاص بالمستجدات عبر ثلاث قنوات: الجرس في لوحة الويب (داخل التطبيق)، والبريد الإلكتروني، والإشعارات الفورية (push) إلى تطبيقات الجوال. يشرح هذا الدليل الجرس وحالة القراءة، والأحداث التي ترسل بريداً، وكيف تُسجَّل أجهزة الجوال. أما مشكلات وصول الإشعارات الفورية فيغطيها دليل استكشاف أخطاء الإشعارات.

الجرس (الإشعارات داخل التطبيق)#

تظهر أيقونة الجرس في الشريط العلوي للسوبر أدمن وموظفي الشركة والتاجر. ولا جرس للمندوب لأنه لا يملك لوحة ويب. ويسرد الجرس ما جرى خلال آخر 14 يوماً (أو منذ تاريخ بدء الإشعارات الذي حدّدته المنصة إن كان أحدث):

يعرض كل إشعار عنوانه وموضوعه و«من: الاسم» ووقته. وتعدّ الشارة الإشعارات غير المقروءة وتعرض 9+ إذا زادت على تسعة، وتعرض القائمة أحدث 8 إشعارات. ولا تظهر في الجرس أحداث الطرود ولا المحفظة ولا المتاجر.

1. افتح الجرس

   اضغط على الجرس. تظهر الإشعارات غير المقروءة مميّزة، وإن لم يوجد شيء تظهر العبارة «ما في إشعارات جديدة».

2. افتح إشعاراً

   بالضغط على الإشعار يُعلَّم مقروءاً وتُفتح التذكرة أو صفحة الأخبار والعروض.

3. علّم الكل كمقروء

   اضغط «تعليم الكل كمقروء». يُعلَّم كل إشعار معروض مقروءاً لك وحدك دون التأثير في غيرك.

إشعارات البريد الإلكتروني#

لا يُرسَل البريد إلا إذا كان مسؤول المنصة قد أعدّ البريد الصادر.

ولا ترسل أحداث الطرود والمحفظة والمتاجر بريداً. أما رمز تسجيل التاجر فيصل برسالة SMS لا بالبريد، والتسجيل بالرمز (على الويب أو في تطبيق التاجر) لا يرسل بريد ترحيب.

أجهزة الجوال#

• التسجيل. يسجّل التطبيق بعد تسجيل الدخول جهازاً باستدعاء POST /api/v10/fcm-subscribe مع رمز الجهاز (مطلوب، والمنصة اختيارية: android أو ios أو web)، ويعمل ذلك حتى لو انتهى اشتراك الباقة. يحفظ الخادم الجهاز ويسجّله في مواضيع الإشعارات (topics) الخاصة به: الكل، والدور، والشركة، والشركة مع الدور. والجهاز الذي ينتقل إلى مستخدم أو شركة أخرى يُلغى اشتراكه من مواضيعه القديمة. ويزيل POST /api/v10/fcm-unsubscribe تسجيل الجهاز. ولا يبيّن كود الخادم هل تستدعي نسخة معيّنة من التطبيق هاتين الواجهتين تلقائياً بعد تسجيل الدخول.

أخطاء شائعة#

• توقّع إشعار في الجرس لحدث طرد. تلك الأحداث تذهب إلى الإشعارات الفورية فقط، إن كان الجهاز مسجّلاً.
• فشل تسجيل الشركة بالرسالة «Something went wrong.» إذا تعذّر إرسال البريد الذي فيه الرمز (مثلاً لأن البريد الصادر غير مُعدّ إعداداً صحيحاً) يُلغى التسجيل وتظهر هذه الرسالة؛ وتظهر الرسالة نفسها عند أي خطأ آخر أثناء التسجيل. اطلب من مسؤول المنصة مراجعة إعداد البريد الصادر.
• لا يصل الإشعار الفوري إلى جهاز. لا يستقبل الجهاز الإشعارات الفورية الموجّهة بالمواضيع إلا بعد تسجيله لدى الخادم (انظر «التسجيل» أعلاه).

الحدود والصلاحيات#

• الجرس خاص بكل مستخدم، وحالة القراءة غير مشتركة.
• تسجيل الجهاز يحتاج مستخدماً مسجّل الدخول ورمز جهاز.