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

# الإشعارات

> أرسل إشعارات لأجهزة محددة أو لمواضيع كاملة، من لوحة التحكم أو REST API.

## ما الذي تفعله

تتيح لك وحدة الإشعارات (Push Notifications) الوصول إلى مستخدميك على iOS
وAndroid والويب دون تشغيل بنية تحتية خاصة بك لـ APNs/FCM — أعِدّ بيانات
اعتماد منصّتك مرة واحدة من لوحة التحكم، ثم أرسل من لوحة التحكم أو REST API.

* **تسليم أصلي (Native).** Apple Push Notification service (APNs) مباشرةً
  على iOS — بدون الحاجة إلى Firebase — وFirebase Cloud Messaging (FCM) على
  Android، وWeb Push القياسي (VAPID) في المتصفح — بدون الحاجة إلى Firebase
  أو OneSignal هناك أيضاً.
* **استهدف أجهزة محددة، أو موضوعاً كاملاً.** أرسل إلى واحد أو أكثر من رموز
  الأجهزة المسجّلة، أو إلى كل جهاز مشترك في موضوع (يُنشأ الموضوع تلقائياً أول
  مرة يشترك فيها جهاز — لا حاجة لإعداد مسبق من لوحة التحكم لبدء استخدامه).
* **صوت مخصّص.** اضبط صوت إشعار مخصّص لكل إرسال، طالما أن ملف الصوت مُرفق
  بالفعل داخل تطبيقك.
* **صور غنية.** أرفق `imageUrl` لعرض صورة غنية في الإشعار — يعمل تلقائياً على
  Android والويب؛ يحتاج iOS خطوة إعداد لمرة واحدة (Notification Service
  Extension).
* **بيانات وصفية مخصّصة.** أرفق بيانات JSON حرّة بالإشعار — يوصلها الـ SDK
  إلى الجهاز كـ `payload.metadata`، لتوجيه الضغط على الإشعار إلى شاشة محددة
  مثلاً.
* **أرسل من لوحة التحكم أو الـ API.** أنشئ الإشعار وأرسله من تبويب **إرسال
  إشعار**، أو استدعِ REST API من الباك إند الخاص بك.

## تبويبات لوحة التحكم

يحتوي قسم **الإشعارات** لكل مشروع في لوحة التحكم على:

| التبويب                  | الاستخدام                                                                                                                                                                                        |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **نظرة عامة (Overview)** | إجمالي الإشعارات المرسلة، معدل التسليم، عدد المعلّقة، الأجهزة المسجّلة، والمنصات المُعدّة                                                                                                        |
| **السجل (History)**      | كل إشعار أُرسل على الإطلاق، قابل للبحث والتصفية حسب الحالة                                                                                                                                       |
| **إرسال إشعار**          | تأليف وإرسال إشعار لأجهزة محددة أو لموضوع                                                                                                                                                        |
| **المواضيع (Topics)**    | إنشاء المواضيع وعرض عدد المشتركين فيها وحذفها                                                                                                                                                    |
| **الإعدادات**            | رفع مفتاح Apple ‎.p8 وملف Android ‎google-services.json، أو إنشاء زوج مفاتيح Web Push — تظهر شارة **تم الإعداد** بمجرد توفّر بيانات الاعتماد لتلك المنصة، ويمكنك مراجعتها أو استبدالها في أي وقت |

## ابدأ الآن

<CardGroup cols={3}>
  <Card title="Flutter" icon="flutter" href="/ar/frameworks/flutter/push-notifications">
    أعِدّ الإشعارات والمواضيع — iOS وAndroid والويب، حزمة واحدة.
  </Card>

  <Card title="Web" icon="js" href="/ar/frameworks/web/push-notifications">
    إشعارات المتصفح عبر JS SDK، لتطبيقات الويب غير المبنية بـ Flutter.
  </Card>

  <Card title="REST API" icon="code" href="/ar/api-reference/push-notifications">
    أرسل الإشعارات مباشرة من الباك إند الخاص بك.
  </Card>
</CardGroup>

المزيد من أدلة المنصات قادمة قريباً — راجع صفحة [البدء](/ar) لمعرفة حالة كل
منصة.