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

# إعداد قواعد الأتمتة لتشغيل مهام المتجر تلقائياً

> أنشئ قواعد أتمتة ذكية لمتجرك: زامن المنتجات عند التحديث، حدّث حالة الطلبات تلقائياً، وأرسل إشعارات للعملاء بدون تدخل يدوي.

الأتمتة هي قدرة التطبيق على تنفيذ مهام متجرك بشكل استباقي وذكي دون أن تضطر إلى تشغيلها يدوياً في كل مرة. بدلاً من مراقبة متجرك باستمرار والتدخل عند كل حدث، تُنشئ أنت قاعدة واحدة تقول فيها: "عندما يحدث كذا، قم بكذا"، ويتولى التطبيق التنفيذ تلقائياً. في هذا الدليل، ستتعلم كيف تُنشئ قواعد الأتمتة، وما هي المُحفِّزات والإجراءات المتاحة، وكيف تستخدمها لتوفير الوقت وضمان الدقة في إدارة متجرك.

## المتطلبات المسبقة

* إتمام الإعداد الأولي وربط متجرك بالمنصة. راجع [الإعداد الأولي](/getting-started/first-setup) و[ربط المتجر](/getting-started/connect-store).
* فهم أساسي لكيفية عمل المزامنة في التطبيق. راجع [لوحة التحكم](/using-app/dashboard-overview).
* صلاحيات المسؤول للوصول إلى قسم الأتمتة.

***

## ما هي قاعدة الأتمتة؟

قاعدة الأتمتة تتكوّن من ثلاثة عناصر رئيسية:

<CardGroup cols={2}>
  <Card title="⚡ المُحفِّز (Trigger)" icon="bolt">
    الحدث الذي يُشغّل القاعدة. مثال: "عند وصول طلب جديد" أو "عند تحديث مخزون منتج".
  </Card>

  <Card title="🔍 الشرط (Condition)" icon="filter">
    معايير اختيارية تُحدد متى تُطبَّق القاعدة. مثال: "فقط إذا كانت قيمة الطلب أكبر من 100 ريال".
  </Card>

  <Card title="🎯 الإجراء (Action)" icon="play">
    ما يفعله التطبيق عند تحقق المُحفِّز والشرط. مثال: "زامن الطلب مع المنصة الأخرى وأرسل إشعاراً".
  </Card>

  <Card title="📋 نتيجة السجل (Log)" icon="list-check">
    يُسجّل التطبيق كل مرة تُنفَّذ فيها القاعدة مع التوقيت والحالة، ما يُتيح لك مراجعة سجل كامل للعمليات التلقائية.
  </Card>
</CardGroup>

***

## إنشاء قاعدة أتمتة جديدة

<Steps>
  <Step title="الوصول إلى قسم الأتمتة">
    من القائمة الجانبية، انقر على **الأتمتة**. ستجد قائمة بالقواعد الموجودة حالياً (إن وجدت) وزر **+ إنشاء قاعدة جديدة** في أعلى الصفحة.
  </Step>

  <Step title="تسمية القاعدة">
    في حقل **اسم القاعدة**، أدخل اسماً وصفياً يساعدك على التعرف عليها لاحقاً. مثال: "مزامنة الطلبات الجديدة فوراً" أو "تنبيه نفاد المخزون". الاسم الواضح يسهّل عليك إدارة قواعد متعددة.
  </Step>

  <Step title="اختيار المُحفِّز">
    من قائمة **المُحفِّز**، اختر الحدث الذي تريده مُشغِّلاً للقاعدة. المُحفِّزات المتاحة:

    * **طلب جديد** — عند وصول أي طلب شراء جديد إلى متجرك
    * **تحديث منتج** — عند تعديل أي بيانات منتج (السعر، الوصف، الصورة)
    * **تغيير المخزون** — عند زيادة أو نقصان كمية منتج
    * **تسجيل عميل جديد** — عند إنشاء حساب عميل جديد في متجرك
    * **تغيير حالة طلب** — عند الانتقال من حالة إلى أخرى (مثل: معلّق → مؤكد)
    * **اكتمال مزامنة** — بعد انتهاء كل عملية مزامنة بنجاح
  </Step>

  <Step title="تحديد الشروط (اختياري)">
    إذا أردت تقييد متى تُطبَّق القاعدة، انقر على **+ إضافة شرط** وحدد:

    * **الحقل**: مثل قيمة الطلب، فئة المنتج، اسم العميل، المنطقة الجغرافية
    * **المُعامِل**: مثل "يساوي"، "أكبر من"، "يحتوي على"، "لا يحتوي"
    * **القيمة**: مثل 500 ريال، "إلكترونيات"، "الرياض"

    يمكنك إضافة شروط متعددة وتحديد ما إذا يجب استيفاؤها جميعاً (AND) أو أي منها (OR).
  </Step>

  <Step title="تحديد الإجراء">
    من قائمة **الإجراء**، اختر ما تريد أن يفعله التطبيق عند تحقق المُحفِّز. الإجراءات المتاحة:

    * **مزامنة فورية** — مزامنة العنصر المُحفِّز مع المنصة الأخرى في الحال
    * **تحديث حالة الطلب** — تغيير حالة الطلب تلقائياً إلى حالة تحددها
    * **إرسال إشعار داخلي** — إظهار تنبيه في مركز إشعارات لوحة التحكم
    * **إرسال بريد إلكتروني** — إرسال إشعار بريدي إلى العناوين التي تحددها
    * **تحديث سمة منتج** — تغيير حقل معين في بيانات المنتج تلقائياً
    * **إنشاء تقرير** — توليد تقرير تلقائي وإرساله إلى بريدك
  </Step>

  <Step title="اختبار القاعدة قبل التفعيل">
    انقر على **اختبار القاعدة** لتشغيلها على بيانات تجريبية والتحقق من أنها تعمل كما تتوقع. راجع نتائج الاختبار في نافذة السجل المنبثقة.
  </Step>

  <Step title="حفظ وتفعيل القاعدة">
    بعد التحقق من صحة القاعدة، انقر على **حفظ وتفعيل**. ستظهر القاعدة في قائمة الأتمتة بحالة "نشطة" ✅. يمكنك أيضاً اختيار **حفظ كمسودة** إذا أردت مراجعتها لاحقاً قبل التفعيل.
  </Step>
</Steps>

<Tip>
  ابدأ بقاعدة أتمتة واحدة بسيطة واختبرها جيداً قبل إنشاء قواعد متعددة. القواعد المتشابكة أو المتعارضة قد تُسبب نتائج غير متوقعة. ننصح بمراجعة سجل الأتمتة يومياً في الأسبوع الأول من التشغيل.
</Tip>

***

## المُحفِّزات المتاحة بالتفصيل

<Tabs>
  <Tab title="طلب جديد">
    يُشغَّل هذا المُحفِّز فور تسجيل طلب شراء جديد في متجرك، بغض النظر عن حالته الأولية. يمكنك تقييده بشروط مثل قيمة الطلب الحد الأدنى أو طريقة الدفع أو المنطقة الجغرافية.

    **حالة استخدام شائعة**: مزامنة الطلب فوراً مع المنصة الأخرى وإرسال إشعار للفريق.
  </Tab>

  <Tab title="تحديث منتج">
    يُشغَّل عند تعديل أي حقل في بيانات منتج: السعر، الوصف، الصور، الفئة، أو أي حقل مخصص. يمكنك تقييده بحقل محدد (مثلاً: يُشغَّل فقط عند تغيير السعر).

    **حالة استخدام شائعة**: مزامنة تحديثات الأسعار فوراً لضمان تطابقها عبر المنصتين.
  </Tab>

  <Tab title="تغيير المخزون">
    يُشغَّل عند تغيير كمية المخزون، سواء بالزيادة (استلام شحنة) أو النقصان (بيع أو تعديل يدوي). يمكنك تقييده بحد كمي معين.

    **حالة استخدام شائعة**: إرسال تنبيه عند وصول المخزون إلى أقل من 10 وحدات.
  </Tab>

  <Tab title="تسجيل عميل">
    يُشغَّل عند إنشاء حساب عميل جديد. يمكنك تقييده بمصدر التسجيل (سلة / زد) أو المنطقة الجغرافية.

    **حالة استخدام شائعة**: إضافة العميل تلقائياً إلى قائمة بريدية ومزامنة بياناته عبر المنصتين.
  </Tab>
</Tabs>

***

## تفعيل أو تعطيل القواعد

<Steps>
  <Step title="عرض قائمة القواعد">
    انتقل إلى **الأتمتة** لعرض جميع القواعد مع حالة كل منها: نشطة ✅ أو معطّلة ⭕ أو مسودة 📝.
  </Step>

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

  <Step title="تعديل قاعدة موجودة">
    انقر على أيقونة تعديل ✏️ بجانب القاعدة لفتح نافذة التعديل. بعد الانتهاء، احفظ التغييرات وستسري على التنفيذات التالية.
  </Step>

  <Step title="حذف قاعدة نهائياً">
    انقر على أيقونة الحذف 🗑️ بجانب القاعدة واضغط **تأكيد الحذف**. هذه العملية لا يمكن التراجع عنها، لذا تأكد من رغبتك قبل المتابعة.
  </Step>
</Steps>

***

## سيناريوهات الأتمتة العملية

<AccordionGroup>
  <Accordion title="السيناريو الأول: مزامنة فورية للطلبات الجديدة">
    **الهدف**: مزامنة كل طلب جديد من سلة إلى زد في أقل من دقيقة.

    **الإعداد**:

    * المُحفِّز: طلب جديد
    * الشرط: لا يوجد (جميع الطلبات)
    * الإجراء: مزامنة فورية ← الطلبات

    **الفائدة**: يضمن أن فريق الشحن في المنصة الأخرى يرى الطلب فوراً دون انتظار دورة المزامنة المجدولة.
  </Accordion>

  <Accordion title="السيناريو الثاني: تنبيه نفاد المخزون">
    **الهدف**: إرسال بريد إلكتروني فوري عند وصول أي منتج إلى أقل من 5 وحدات.

    **الإعداد**:

    * المُحفِّز: تغيير المخزون
    * الشرط: الكمية المتوفرة أقل من 5
    * الإجراء: إرسال بريد إلكتروني إلى مدير المخزون

    **الفائدة**: تتمكن من إعادة الطلب من المورد قبل نفاد الكميات الكلي.
  </Accordion>

  <Accordion title="السيناريو الثالث: تحديث حالة الطلب تلقائياً">
    **الهدف**: تحديث حالة الطلب في سلة إلى "قيد الشحن" عندما تتغير حالته في زد إلى "تم الشحن".

    **الإعداد**:

    * المُحفِّز: تغيير حالة طلب
    * الشرط: الحالة الجديدة = "تم الشحن" في زد
    * الإجراء: تحديث حالة الطلب المقابل في سلة إلى "قيد الشحن"

    **الفائدة**: عملاؤك يرون حالة طلبهم محدّثة في كلتا المنصتين دون تدخل يدوي.
  </Accordion>
</AccordionGroup>

<Warning>
  تجنّب إنشاء قواعد تُشكّل حلقات مترابطة: مثلاً قاعدة تُحدِّث منتجاً في سلة، وقاعدة أخرى تُحدِّث نفس المنتج في زد عند تغييره في سلة، مما يُسبب مزامنة لانهائية. تحقق دائماً من أن إجراءات قواعدك لا تُطلق مُحفِّزات قواعد أخرى.
</Warning>

***

## النتيجة المتوقعة

بعد إعداد قواعد الأتمتة وتفعيلها، ستلاحظ:

* تنفيذ المهام الروتينية تلقائياً دون أي تدخل يدوي منك
* تزامن سريع وفوري للأحداث الحرجة (طلبات، مخزون، حالات)
* سجل شفاف لكل إجراء تلقائي نُفِّذ مع التوقيت والنتيجة
* تحرير وقتك للتركيز على تطوير متجرك بدلاً من المهام الدورية المتكررة

***

## استكشاف الأخطاء

**القاعدة لا تُشغَّل رغم تحقق المُحفِّز**
تحقق من أن القاعدة بحالة "نشطة" وليس "مسودة" أو "معطّلة". تحقق أيضاً من شروط القاعدة — قد يكون الشرط دقيقاً جداً بحيث لا تستوفيه الأحداث الفعلية. راجع سجل الأتمتة لمعرفة ما إذا كانت القاعدة تُشغَّل لكن يُخفق إجراؤها.

**القاعدة تُشغَّل بشكل متكرر وغير متوقع**
راجع تعريف المُحفِّز والشروط للتأكد من دقتها. قد يكون الحدث نفسه يتكرر في النظام أكثر مما تتوقع. انظر أيضاً في احتمال وجود قاعدتين تُطلق إحداهما الأخرى في حلقة.

**إجراء إرسال البريد الإلكتروني لا يعمل في القاعدة**
تحقق من أن عنوان البريد المحدد في إعدادات الإجراء صحيح. تحقق أيضاً من أن إشعارات البريد الإلكتروني مفعّلة في **الإعدادات ← الإشعارات**. راجع [إعداد الإشعارات](/using-app/notifications) للتأكد من صحة الإعداد.

***

## الأسئلة الشائعة

<AccordionGroup>
  <Accordion title="كم عدد قواعد الأتمتة التي يمكنني إنشاؤها؟">
    يعتمد الحد الأقصى لعدد القواعد على خطة اشتراكك. الخطة الأساسية تتيح حتى 5 قواعد نشطة، بينما الخطط المتقدمة تتيح قواعد غير محدودة. تحقق من صفحة **الاشتراك** لمعرفة حدود خطتك الحالية.
  </Accordion>

  <Accordion title="هل يمكنني إنشاء قاعدة تُشغَّل في وقت محدد من اليوم؟">
    نعم، يمكنك استخدام مُحفِّز **الجدول الزمني (Schedule)** لإنشاء قاعدة تعمل في وقت ويوم محددين. مثلاً، يمكنك إعداد قاعدة لتشغيل مزامنة كاملة كل يوم أحد في منتصف الليل. هذا الخيار متاح في الخطط المتوسطة والمتقدمة.
  </Accordion>

  <Accordion title="كيف أُراجع سجل تنفيذات القواعد؟">
    انتقل إلى **الأتمتة ← سجل التنفيذات**. ستجد جدولاً يعرض كل تنفيذ بتاريخه ووقته واسم القاعدة والحالة (ناجح / فاشل) وتفاصيل الحدث. يمكنك تصفية السجل حسب القاعدة أو الفترة الزمنية أو الحالة.
  </Accordion>
</AccordionGroup>

***

## المقالات ذات الصلة

<CardGroup cols={2}>
  <Card title="إعداد الإشعارات والتنبيهات" icon="bell" href="/using-app/notifications">
    اجعل قواعد أتمتتك أكثر فاعلية بإضافة إشعارات فورية لكل حدث مهم في متجرك.
  </Card>

  <Card title="مزامنة المنتجات" icon="box" href="/using-app/product-sync">
    تعرّف على آلية مزامنة المنتجات وكيف يمكن للأتمتة تسريع تحديثاتها عبر المنصتين.
  </Card>
</CardGroup>

***

## تواصل مع الدعم

<Note>
  هل تحتاج مساعدة في تصميم قاعدة أتمتة لحالة استخدام خاصة بمتجرك؟ فريقنا يسعد بمساعدتك في بناء قواعد مخصصة تتناسب مع سير عمل متجرك. تفضّل بالتواصل معنا عبر [صفحة تواصل مع الدعم](/support/contact-support).
</Note>