> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# الإشعارات

> صندوق الإشعارات داخل التطبيق في /notifications، وكيف يختلف عن أيقونة الجرس في الشريط العلوي.

يملك Scanova **واجهتي إشعارات منفصلتين**، تم التحقق منهما مباشرة مقابل التطبيق قيد التشغيل: أيقونة الجرس في الشريط العلوي (موجودة في كل صفحة من صفحات لوحة التحكم)، وصفحة مخصصة باسم `/notifications`. إنهما ليسا نفس النظام — راجع [نظاما إشعارات منفصلان](#نظاما-إشعارات-منفصلان-تباين-حقيقي) أدناه قبل أن تبحث عن أحدهما داخل الآخر.

توثّق هذه الصفحة `/notifications`، الوحدة المشمولة هنا — صندوق وارد بسيط بعلامتي **All** / **Unread** لأحداث على مستوى الحساب مثل دعوات الفريق، وتحذيرات الحصة، وتنبيهات العملاء المحتملين أو استجابات النماذج.

<Note>
  هذا ليس المكان الذي تتحكم فيه بالرسائل الإلكترونية التي يرسلها Scanova إليك. لذلك، راجع [تفضيلات البريد الإلكتروني](/ar/account/email-preferences) — قائمة تبديل منفصلة من ست فئات في `/account/email-preferences`. هذه الصفحة تتعلق برسائل داخل التطبيق تقرؤها في لوحة التحكم، وليست بريدك الإلكتروني.
</Note>

## صفحة الإشعارات

افتح `/notifications` مباشرة (لا يوجد رابط في الشريط الجانبي إليها — راجع ملاحظة التباين أدناه). التخطيط هو صندوق وارد بلوحتين:

* **اللوحة اليسرى** — قائمة قابلة للتمرير من الإشعارات، يعرض كل منها عنوانًا ومعاينة نص من سطر واحد وطابعًا زمنيًا نسبيًا. العناصر غير المقروءة تحمل نقطة مملوءة وعنوانًا بخط عريض؛ العناصر المقروءة لا تحملهما.
* **اللوحة اليمنى** — عرض تفصيلي لأي إشعار تختاره، يعرض العنوان الكامل، وطابعًا زمنيًا مطلقًا، ونص الجسم الكامل. إذا كان الإشعار يحمل رابطًا عميقًا، يظهر زر **Open** في رأسية التفاصيل.

<Frame caption="صفحة الإشعارات، تم التحقق منها مباشرة على حساب اختبار بلا إشعارات بعد">
  <img src="https://mintcdn.com/scanova-api/2FTGGTqcp1qRUtvm/images/v2/notifications/overview/notifications-all-tab.png?fit=max&auto=format&n=2FTGGTqcp1qRUtvm&q=85&s=b27b8e5de958a99970ebd666543630dd" alt="صفحة Notifications تعرض علامتي تبويب All وUnread، وقائمة إشعارات فارغة تقول 'No notifications — You're all caught up!'، ولوحة تفاصيل فارغة تقول 'Select a notification — Choose one from the list to read it'" width="1440" height="900" data-path="images/v2/notifications/overview/notifications-all-tab.png" />
</Frame>

في أعلى القائمة، تُصفّي علامتا تبويب ما يُعرض:

| العلامة    | تعرض                                                                                                             |
| ---------- | ---------------------------------------------------------------------------------------------------------------- |
| **All**    | كل إشعار في حسابك، مقروءًا كان أو غير مقروء.                                                                     |
| **Unread** | الإشعارات غير المقروءة فقط. تعرض العلامة عدادًا حيًا، مثل "Unread (3)"، بمجرد أن يكون لديك إشعار واحد على الأقل. |

يظهر زر **Mark all read** بجانب صف العلامتين كلما كان لديك إشعار واحد غير مقروء على الأقل، ويمسحها كلها بنقرة واحدة.

اختيار إشعار غير مقروء من القائمة يجعله مقروءًا فورًا (دون تأكيد منفصل) ويحدّث نقطته/خطه العريض في مكانه.

## أنواع الإشعارات

كان الحساب المستخدم للتحقق من هذه الصفحة بلا أي إشعارات، لذا لم يتسنَّ التقاط مثال حي. استنادًا إلى مسارات عمل الإشعارات المسجَّلة في الواجهة الخلفية (‏`qcg-backend/src/notification/workflows.py`)، هناك أربعة أنواع أحداث مربوطة لإطلاق إشعار:

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

<Note>
  تُشير الشفرة الخلفية نفسها إلى أن هذه الأنواع الأربعة "مقترحة، وغير مؤكدة" مقابل لوحة تحكم خدمة توصيل الإشعارات الأساسية في وقت ربطها — تعامل مع هذه القائمة على أنها مجموعة المُحفّزات المقصودة، وليست ضمانًا بأن كل واحد منها فعّال في الإنتاج اليوم.
</Note>

## نظاما إشعارات منفصلان (تباين حقيقي)

وجد التحقق المباشر أن أيقونة الجرس في الشريط العلوي — نقطة الدخول للإشعارات التي يراها كل مستخدم فعليًا، في كل صفحة من صفحات لوحة التحكم — هي **أداة مختلفة ومنفصلة** عن صفحة `/notifications` الموصوفة أعلاه:

<Frame caption="النقر على أيقونة الجرس في الشريط العلوي يفتح أداة صندوق وارد منفصلة بعلامة تجارية من طرف ثالث، وليست صفحة /notifications">
  <img src="https://mintcdn.com/scanova-api/2FTGGTqcp1qRUtvm/images/v2/notifications/overview/topbar-bell-novu-inbox.png?fit=max&auto=format&n=2FTGGTqcp1qRUtvm&q=85&s=5491b9187c56e0b23fa3c4e374eb95dc" alt="نافذة منبثقة تُفتح من أيقونة الجرس في الشريط العلوي، تعرض قائمة منسدلة موسومة Inbox، وعدة صفوف إشعارات في وضع التحميل الهيكلي، وإسناد صغير 'Inbox by Novu' أسفلها" width="1440" height="900" data-path="images/v2/notifications/overview/topbar-bell-novu-inbox.png" />
</Frame>

* يعرض الجرس أداة صندوق وارد مضمّنة من طرف ثالث (منسوبة إلى "Inbox by Novu" في تذييلها الخاص) بحالة قراءة/عدم قراءة خاصة بها، وواجهة نافذة منبثقة خاصة بها، وتوصيل فوري خاص بها — هذا ما تغذّيه فعليًا أنواع الأحداث الأربعة في الجدول أعلاه.
* صفحة `/notifications` الموثقة أعلاه هي صفحة **منفصلة ومبنية خصيصًا** تصل إلى نقطة نهاية خلفية خاصة بها، بشكل بيانات خاص بها. إنها غير مرتبطة من الشريط الجانبي، أو الشريط العلوي، أو أي مكان آخر في التطبيق تمكّن هذا التحقق من إيجاده — الطريقة الوحيدة للوصول إليها هي كتابة الرابط مباشرة.

إذا كنت تبحث عن إشعاراتك يوميًا، استخدم أيقونة الجرس في الشريط العلوي، وليس `/notifications`. هذه الصفحة موثقة كما هي لأنها مسار حقيقي يمكن الوصول إليه، لكن لا ينبغي التعامل معها على أنها الواجهة الأساسية للإشعارات.

## ذات صلة

* [تفضيلات البريد الإلكتروني](/ar/account/email-preferences) — التحكم في الرسائل الإلكترونية التي يرسلها Scanova إليك، نظام منفصل عن واجهتَي الإشعارات في هذه الصفحة.
