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

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

> تعرّف على كيفية ضبط إشعارات البريد الإلكتروني في oFatoura، وإعداد اتصال البريد عبر SMTP أو Resend، وإدارة اشتراكات تقارير المبيعات، وربط Beamer وPusher للتنبيهات الفورية داخل التطبيق.

ثلاث صفحات إعدادات منفصلة تعمل معاً للتحكم في طريقة تواصل oFatoura مع فريقك وعملائك: تتحكم **Email & Notification Settings** (إعدادات البريد والإشعارات) في الأحداث التي تُطلق إرسال رسائل البريد الإلكتروني، وتضبط **Email Configuration** (إعداد البريد) اتصال البريد الذي تُرسَل من خلاله تلك الرسائل، فيما تربط **Push Notification Settings** (إعدادات الإشعارات الفورية) كلاً من Beamer وPusher للتنبيهات الحية داخل التطبيق.

<Note>
  تحتاج إلى صلاحية **Manage Settings** (إدارة الإعدادات) لتغيير أيٍّ من هذه الإعدادات.
</Note>

***

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

انتقل إلى **Settings → Email & Notification Settings** في لوحة الإدارة على الويب.

تتيح لك هذه الصفحة اختيار الأحداث التشغيلية وأحداث الطلبات التي تُرسَل بشأنها رسائل بريد إلكتروني، وإضافة ما يصل إلى خمسة عناوين بريدية لتلقّي تقرير مبيعات دوري، وإرسال رسالة اختبارية سريعة للتأكد من صحة الإعداد.

### تفعيل الإشعارات وإيقافها لكل حدث

لكل نوع من أنواع الإشعارات مفتاح تشغيل/إيقاف خاص به. الأحداث التي يمكنك تفعيلها أو إيقافها هي:

* استلام طلب جديد
* تأكيد الطلب
* إلغاء الطلب
* استلام الدفع
* معالجة الاسترداد
* إنشاء حجز
* تقديم طلب نادل

شغّل المفتاح لأي حدث تريد أن يتلقّى فريقك بريداً إلكترونياً بشأنه، وأوقفه للأحداث التي لا تريد إرسال إشعار بريدي عنها.

### اشتراكات تقارير المبيعات

<Steps>
  <Step title="إضافة بريد اشتراك">
    في حقل **Subscription Emails** (بريد الاشتراك)، اكتب عنوان بريد إلكتروني صحيحاً ثم احفظ. يمكنك إضافة ما يصل إلى **خمسة عناوين** لكل فرع.
  </Step>

  <Step title="حذف عنوان">
    انقر على زر الحذف بجوار أي عنوان لا تريد استمرار استلامه للتقرير.
  </Step>
</Steps>

<Tip>
  تتلقّى عناوين الاشتراك ملخصات مبيعات دورية للفرع. إذا كنت تدير عدة فروع، فأضف الاشتراكات بشكل منفصل لكل فرع.
</Tip>

### بريد الاختبار

أدخل عنوان المستلم في حقل **Test Email** (بريد الاختبار) ثم انقر **Send Test Email** (إرسال بريد اختبار). إذا وصلت الرسالة، فإن إعدادات الإشعارات واتصال البريد يعملان بشكل صحيح. إذا لم تصل، تحقق من إعداد البريد الإلكتروني (أدناه).

***

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

انتقل إلى **Settings → Email Configuration** في لوحة الإدارة على الويب.

تضبط هذه الصفحة اتصال البريد الذي تستخدمه جميع رسائل الإشعارات. يجب حفظ إعداد صحيح هنا قبل أن تتمكن رسائل الإشعارات من الوصول إلى مستلميها.

<Steps>
  <Step title="اختيار برنامج تشغيل البريد">
    اختر **SMTP** أو **Resend** من القائمة المنسدلة **Mail Driver** (برنامج تشغيل البريد). يعمل SMTP مع أي مزوّد بريد قياسي (Gmail وSendGrid وMailgun وخادمك الخاص وغيرها). أما Resend فهو خدمة بريد للمعاملات لا تتطلب سوى مفتاح API.
  </Step>

  <Step title="إدخال بيانات الاعتماد">
    أكمل الحقول التي تظهر وفق برنامج التشغيل الذي اخترته:

    **لـ SMTP:**

    | الحقل      | ما تُدخله                                     |
    | ---------- | --------------------------------------------- |
    | SMTP Host  | اسم مضيف خادم البريد (مثال: `smtp.gmail.com`) |
    | SMTP Port  | عادةً 465 (SSL) أو 587 (TLS)                  |
    | Encryption | **TLS** أو **SSL**                            |
    | Username   | اسم المستخدم أو عنوان حساب البريد             |
    | Password   | كلمة مرور حساب البريد أو كلمة مرور التطبيق    |

    **لـ Resend:**
    أدخل مفتاح Resend API في حقل **Mail Password** (كلمة مرور البريد). لا حاجة لمضيف أو منفذ.
  </Step>

  <Step title="تحديد هوية المُرسِل">
    أكمل حقل **Mail From Name** (اسم المُرسِل) وهو الاسم الذي يراه المستلمون (مثال: "اسم مطعمك")، وحقل **Mail From Email** (بريد المُرسِل) وهو العنوان الذي تُرسَل منه الرسائل.
  </Step>

  <Step title="تفعيل قائمة الانتظار (اختياري)">
    شغّل **Enable Queue** (تفعيل قائمة الانتظار) إذا أردت إرسال رسائل البريد في الخلفية بدلاً من إرسالها فورياً. يُنصح بذلك في الأنظمة المشغولة لتجنّب إبطاء معالجة الطلبات.
  </Step>

  <Step title="اختبار الاتصال">
    انقر **Send Test Email** (إرسال بريد اختبار)، وأدخل عنوان مستلم في النافذة المنبثقة، ثم أرسل. يؤكد وصول الرسالة بنجاح أن إعدادك صحيح.
  </Step>
</Steps>

<Warning>
  إذا غيّرت برنامج تشغيل البريد أو بيانات الاعتماد، فأرسل بريد اختبار فوراً للتأكد من التسليم قبل الاعتماد على رسائل الإشعارات الحية.
</Warning>

***

## إعدادات الإشعارات الفورية

انتقل إلى **Settings → Push Notifications** في لوحة الإدارة على الويب.

تربط هذه الصفحة خدمتين للإشعارات الفورية: **Beamer** لبانرات الإعلانات داخل التطبيق، و**Pusher** للبث الحي لتحديثات الطلبات إلى لوحة تحكم الويب وتطبيق النادل.

### Beamer (الإعلانات داخل التطبيق)

يعرض Beamer بانرات الإشعارات داخل لوحة تحكم oFatoura لفريقك.

<Steps>
  <Step title="تفعيل Beamer">
    شغّل مفتاح **Beamer Status** (حالة Beamer).
  </Step>

  <Step title="إدخال بيانات اعتماد Beamer">
    الصق **Beamer Instance ID** (معرّف النسخة) و**Beamer Secret** (المفتاح السري) من لوحة تحكم حساب Beamer الخاص بك.
  </Step>

  <Step title="الحفظ">
    انقر حفظ. ستظهر الإعلانات داخل التطبيق للموظفين المسجّلين دخولهم في لوحة الإدارة على الويب.
  </Step>
</Steps>

### Pusher (البث الفوري)

يُشغّل Pusher تحديثات حالة الطلبات الحية على لوحة التحكم وتطبيق النادل. بدونه، يضطر الموظفون إلى تحديث الصفحة يدوياً لرؤية الطلبات الجديدة.

<Steps>
  <Step title="تفعيل Pusher">
    شغّل مفتاح **Pusher Broadcast Status** (حالة بث Pusher).
  </Step>

  <Step title="إدخال بيانات اعتماد Pusher">
    انسخ القيم الأربع من لوحة تحكم تطبيق Pusher والصقها هنا:

    | الحقل   | مكان الحصول عليه                           |
    | ------- | ------------------------------------------ |
    | App ID  | لوحة Pusher ← App Keys                     |
    | Key     | لوحة Pusher ← App Keys                     |
    | Secret  | لوحة Pusher ← App Keys                     |
    | Cluster | لوحة Pusher ← App Keys (مثال: `ap2`، `eu`) |
  </Step>

  <Step title="الحفظ">
    انقر حفظ. ستبدأ التحديثات الفورية بالتدفق على الفور للجلسات النشطة.
  </Step>
</Steps>

<Note>
  بيانات اعتماد Pusher خاصة بكل مطعم. إذا كان لديك عدة فروع، فجميع الفروع ضمن المطعم الواحد تشترك في إعداد Pusher ذاته.
</Note>

***

## مواضيع ذات صلة

* [إعدادات تطبيق النادل (ePOS)](/ar/settings/waiter-app-settings) — تحكم فيما يراه الموظفون ويمكنهم فعله في تطبيق النادل
* [تفضيلات إشعارات واتساب](/ar/whatsapp/notification-preferences) — إرسال تحديثات الطلبات والحجوزات عبر واتساب
* [الفروع وأوقات العمل](/ar/settings/branches-and-operating-hours) — إدارة تفاصيل الفروع ذات الصلة باشتراكات الإشعارات لكل فرع