الإشعارات والدفع وخرائط Google: إعدادات الشركة

الغرض#

تغطي هذه الصفحة أربعة أماكن في لوحة شركة التوصيل تتعلق بالإشعارات والخرائط: قواعد الإشعارات التلقائية في «مركز الإشعارات»، وصفحة «إعدادات الإشعار» القديمة (مفتاح Firebase السري وموضوع FCM)، وصفحة «دفع الإخطار» القديمة لإرسال رسالة يدوية، وصفحة مفتاح خرائط Google. الهدف أن تعرف أيّها يؤدي عملاً فعلياً وأيّها يمكنك تركه.

من يستطيع الوصول؟#

الصفحات القديمة الثلاث («إعدادات الإشعار» و«دفع الإخطار» و«GoogleMap Setting») تعمل على نطاق الشركة نفسه وليس على النطاق الرئيسي للمنصة، أما «مركز الإشعارات» فيُفتح من قائمة لوحة الشركة. وتظهر عناصر القائمة للحسابات التي تملك الصلاحية المطابقة فقط، أما مجموعة «ضبط» فتتطلب صلاحية قراءة واحدة على الأقل من: فئات التوصيل، رسوم التوصيل، أنواع التوصيل، السوائل والقابل للكسر، التغليف.

يُخفى عنصر «دفع الإخطار» عن أدمن الشركة والمسؤول لأن «مركز الإشعارات» يحل محله، لكن أي حساب يملك push_notification_read يستطيع فتح الصفحة بكتابة عنوانها مباشرة.

الإشعارات التلقائية: ما الذي يصل ولمن؟#

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

• التجار (مفعّل افتراضياً): تعيين مندوب للتوصيل، وإعادة جدولة التوصيل، وتم التسليم، وتسليم جزئي، ومرتجع، وطلبات شحن الرصيد، وطلبات السحب، وطلب متجر لم يتحوّل إلى طرد (واسمه في الجدول «طلب متجر ما انعمل طرد»). أما «طرد جديد» و«تعيين مندوب استلام» فمعطّلان افتراضياً.
• المناديب (مفعّل): تعيين مندوب للتوصيل، وتعيين مندوب استلام، وإعادة جدولة التوصيل.
• موظفو الشركة: «طرد جديد» و«طلب شحن رصيد من تاجر» مفعّلان، و«تم التسليم» و«مرتجع» معطّلان افتراضياً.

ولكل صف من هذه الصفوف ما يلي:

• لكل صف مفتاح تفعيل، ويمكنك تعديل العنوان (حتى 150 حرفاً) والنص (حتى 500 حرف). الحقل الفارغ يعني النص الافتراضي. والمتغيرات المتاحة في النص: {tracking} و{customer} و{address} و{merchant} و{amount} و{status} و{reason}. ثم اضغط «حفظ».
• الصف الذي تظهر عليه علامة القفل «موقّف من الإدارة» لا تستطيع الشركة تفعيله ولا تعديل نصه. يظهر القفل عندما يكون الحدث معطّلاً على مستوى المنصة، إما لأن السوبر أدمن أوقفه، أو لأنه معطّل افتراضياً ولم يفعّله السوبر أدمن بعد. لذلك تبقى الصفوف المعطّلة افتراضياً («طرد جديد» و«تعيين مندوب استلام» للتجار، و«تم التسليم» و«مرتجع» لموظفي الشركة) مقفلة إلى أن يفعّلها السوبر أدمن. أما الصف المفعّل على مستوى المنصة فيمكن للشركة إيقافه أو تغيير نصه.
• لا يصل الإشعار إلا لمن لديه جهاز مسجّل. وتعرض الصفحة تنبيه «الإشعارات مو شغّالة لسا» عندما لا يكون ملف حساب الخدمة (Service Account) الخاص بـ Firebase مضبوطاً على الخادم (يرفعه السوبر أدمن عادةً من إعدادات Firebase)، ويُطلب من مستخدمي الشركة التواصل مع الإدارة.

صفحة «إعدادات الإشعار» القديمة#

فيها حقلان إلزاميان: «مفتاح Firebase السري» (حتى 800 حرف) و«موضوع FCM» (حتى 20 حرفاً). تُحذف المسافات من المفتاح وتتحول المسافات في الموضوع إلى شرطة سفلية. يقرأ هاتين القيمتين المرسِل القديم فقط، وقد أوقفت Google الواجهة القديمة التي يعتمد عليها؛ ولا يستخدمهما «مركز الإشعارات». لذلك لا تشغّل هذه الصفحة الإشعارات، واطلب من السوبر أدمن رفع ملف Firebase بدلاً من ذلك.

إرسال رسالة يدوية من «دفع الإخطار»#

1. افتح الصفحة

   من القائمة اختر «دفع الإخطار». تعرض القائمة الرسائل السابقة بأعمدة: «#» (رقم الصف) والصورة والعنوان والوصف والمستعمل والإجراءات. اضغط زر الإضافة (+) لتفتح نموذج «إنشاء إعلام دفع».

2. املأ النموذج

   «عنوان» (إلزامي، حتى 191 حرفاً)، و«دور» (إلزامي): «All Role» أو أحد أدوار الشركة، و«المستعمل» (اختياري، بحث بالاسم)، و«ملف» لصورة اختيارية بصيغة PNG فقط وحتى نحو 5 ميغابايت، و«وصف» (إلزامي، حتى 1000 حرف، وتُحذف منه وسوم التنسيق عند الحفظ).

3. احفظ

   اضغط «حفظ». تُضاف الرسالة إلى القائمة وتُرسل فوراً، وتظهر رسالة «تمت إضافة إعلام الدفع بنجاح.» حتى لو فشل الإرسال، لأن أخطاء الإرسال تُكتب في سجل الخادم فقط ولا تظهر للمستخدم.

مَن يستلم الرسالة: عند اختيار «All Role» تصل إلى كل مستخدمي الشركة ما عدا حسابات أدمن الشركة (النوع 1)، ولا يُؤخذ بالشخص المختار إلا إذا اخترت معه دوراً محدداً. وتُرسل بثلاث طرق: موضوع Firebase القديم (بالمفتاح والموضوع من «إعدادات الإشعار»)، ورمز جهاز الهاتف عبر FCM v1 بملف اعتماد على الخادم (وليس الملف المرفوع في مركز الإشعارات)، ورموز المتصفح عبر المفتاح القديم. ولا تظهر هذه الإرسالات في «السجل» داخل مركز الإشعارات.

مفتاح خرائط Google#

1. افتح الصفحة

   من «ضبط» اختر «GoogleMap Setting». وتظهر في الواجهة العربية أيضاً بعض تسمياتها بالإنجليزية («GoogleMap Setting» و«GoogleMap Key») لأن ترجمتها العربية غير موجودة.

2. أدخل المفتاح واحفظ

   ألصق المفتاح في حقل «GoogleMap Key» (إلزامي، حتى 800 حرف، وتُحذف منه المسافات) ثم اضغط «حفظ التغيير». يُحفظ المفتاح لشركتك وحدها، وتظهر رسالة «تم تغيير الحفظ بنجاح».

3. جرّب صفحة خريطة

   افتح صفحة خريطة الفروع أو نموذج تعديل مندوب أو طرد. تحمّل هذه الصفحات مكتبة خرائط Google بمفتاح شركتك: خريطة الفروع، وصفحة «Map Show» في قائمة الطرود (المناديب وطرودهم)، ونماذج إضافة المندوب وتعديله، ونموذج تعديل الطرد للموظفين ولوحة التاجر.

إذا لم يُحفظ أي مفتاح فإن المنصة تطلب مكتبة Google بمفتاح فارغ ولا تعرض أي تحذير؛ وما يظهر في الخريطة يقرره Google. والمفتاح يُكتب داخل شيفرة الصفحة التي يراها المتصفح، فاستخدم مفتاحاً مقيّداً بنطاق موقعك من لوحة تحكم Google.

أخطاء شائعة#

• ملء «إعدادات الإشعار» وانتظار وصول الإشعارات. لا تستخدمها قواعد المركز.
• اختيار «All Role» مع شخص معيّن. يُهمل الشخص ويستلم الجميع الرسالة.
• اختيار دور محدد. يقارن المرسِل القيمة المختارة برقم نوع الحساب (2 تاجر، 3 مندوب، وهكذا) وليس بسجل الدور، فقد لا يطابق الجمهور المقصود. فضّل «مركز الإشعارات».
• اعتبار رسالة النجاح دليلاً على الوصول. هي تؤكد الحفظ فقط.

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

• يصل الإشعار الفوري فقط إلى جهاز سُجّل بعد فتح التطبيق أو السماح بإشعارات المتصفح.
• قائمة «دفع الإخطار» تتيح الإضافة والحذف فقط، ولا يمكن تعديل رسالة محفوظة.
• يصف هذا الدليل نسخة الشركة من «مركز الإشعارات»؛ وللسوبر أدمن وللتاجر صاحب شركة التوصيل الخاصة نسخة منفصلة.
• لتشخيص الإشعارات التي لا تصل راجع دليل «عدم وصول الإشعارات».