قسم الإشعارات في مساحة العمل — الحملات والمشتركون ومفاتيح VAPID | مُبَرمِج

شرط الإرسال: تحتاج المنصة إلى ثلاثة متغيرات في بيئة خادمها: VAPID_PUBLIC_KEY وVAPID_PRIVATE_KEY وVAPID_SUBJECT (يبدأ بـmailto: أو https://). إن غاب أحدها تعرض «جاهزية الإرسال» «غير مهيّأة»، ولا يظهر زرّ الاشتراك في موقعك، ويُرفض «إرسال الآن». هذه مفاتيح المنصة لا مفاتيح مشروعك.

من يستطيع فتح القسم

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

ما تعرضه الشاشة

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

حين تكون «غير مهيّأة» يظهر تحتها صندوق تحذير عنوانه «الإرسال غير مهيّأ على المنصّة».

اشتراك زوّار موقعك

1. انشر موقعك واجعله عامًّا: صفحة الاشتراك لا تعمل إلا لموقع منشور مفعّل فيه «الظهور العام» (انظر النشر والإعدادات).
2. في لوحة «الاشتراك من موقعك» فعّل «إظهار زرّ «تفعيل الإشعارات»». تظهر «سيظهر زرّ الإشعارات في موقعك المنشور»، أو التحذير «حُفظ الاختيار، لكن الزرّ لا يظهر في موقعك قبل ضبط مفاتيح VAPID على المنصّة».
3. بعد تحديث صفحة موقعك يظهر رابط عائم «تفعيل الإشعارات». لتضعه حيث تريد أضف السمة data-mubarmij-push-button إلى أي عنصر في صفحتك فيحلّ محلّ الرابط العائم.
4. يضغط الزائر الرابط فينتقل إلى صفحة التفعيل على نطاق المنصة (عنوانها يظهر في اللوحة بعد التفعيل)، ويضغط «تفعيل الإشعارات» ويوافق في متصفحه، ثم «العودة إلى الموقع». ومن الصفحة نفسها يستطيع «إيقاف» الإشعارات.

الانتقال خطوةً إلى المنصة ضروري لأن الموقع المنشور يعمل في بيئة معزولة لا تسمح للمتصفح بالاشتراك داخلها؛ لذلك يظهر الإشعار باسم نطاق المنصة. الحد الأعلى 50,000 مشترك للموقع («بلغ الموقع الحدّ الأعلى للمشتركين»).

كتابة حملة وحفظها

1. افتح «الإشعارات» من القائمة الجانبية.
2. في لوحة «إشعار جديد» اكتب «العنوان» ثم «نص الإشعار».
3. عدّل حقل الرابط إن أردت (القيمة الافتراضية «/»): مسار يبدأ بـ/ لصفحة في موقعك، أو رابط يبدأ بـhttps://. يفتحه الإشعار عند الضغط.
4. راجع مربع «معاينة» الذي يعرض العنوان والنص كما كتبتهما.
5. اضغط «حفظ كمسودّة». تظهر رسالة «حُفظت المسودّة» وتُضاف الحملة إلى لوحة «الحملات» بوسم «مسودّة».

الإرسال

«إرسال الآن» يحفظ الحملة أولًا ثم يرسلها. ولكل حملة غير مُرسلة في «الحملات» زرّ «إرسال» (معطّل ما دامت الجاهزية «غير مهيّأة»).

• بلا مفاتيح VAPID: الحالة 501 ورمز PUSH_SEND_UNAVAILABLE والرسالة «الإرسال غير مهيّأ على المنصّة: مفاتيح VAPID غير مضبوطة — حُفظت الحملة كمسودّة ولم تُرسَل».
• بلا مشتركين: «لا مشتركين بعد — لم يُرسَل شيء وبقيت الحملة مسودّة».
• أكثر من 10 محاولات إرسال في الساعة للمشروع: «بلغت حدّ الإرسال في الساعة — بقيت الحملة مسودّة».
• عند الإرسال تذهب الحملة إلى أقدم 5000 مشترك، وتظهر «أُرسل إلى … مشتركًا». اشتراك ألغاه المتصفح يُحذف من القائمة تلقائيًا.
• تُعلَّم الحملة مُرسلة بعدد مستلميها وتاريخها فقط إن قبلتها خدمة دفع واحدة على الأقل؛ وإلا تظهر «لم يُسلَّم · فشل …» مع الرسالة «لم تقبل أيُّ خدمة دفعٍ الإشعار — راجع المشتركين وأعد المحاولة». وحملة مُرسلة لا تُرسل ثانية («أُرسلت هذه الحملة من قبل»).

لوحة المشتركين

تعرض اللوحة لكل مشترك مضيف خدمة الدفع فقط (لا عنوان الاشتراك الكامل، لأنه يتيح مراسلة ذلك المتصفح)، ووصف المتصفح، وتاريخ الاشتراك، وحتى 200 مشترك. قبل أول اشتراك ترى «لا يوجد مشتركون».

الحذف والأخطاء

• أيقونة سلة المهملات بجانب الحملة تحذفها مباشرة بلا تأكيد.
• «عنوان الإشعار مطلوب» و«نص الإشعار مطلوب» عند ترك الحقلين فارغين، و«رابط الإشعار يبدأ بـ/ لصفحةٍ في موقعك أو بـhttps://» لرابط غير مقبول.
• رسالة القدرة أعلاه (402) إن كانت باقتك لا تشمل الاستضافة.

لإشعارات تطبيق الجوال انظر الجوال.

أسئلة شائعة

جاهزية الإرسال «مهيّأة»، فهل تصل حملتي؟

تصل إلى من اشتركوا فعلًا من زرّ موقعك وقبلتها خدمات الدفع في متصفحاتهم. راجع عدد «المشتركون» ونتيجة الحملة في لوحة «الحملات».

هل أستطيع استخدام مفاتيح VAPID الخاصة بي؟

غير متاح بعد. مسار الإشعارات يقرأ مفاتيح بيئة خادم المنصة وحدها، ولا توجد شاشة لإدخال مفاتيحك.