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

# خيارات المشغّل وكيف يعمل

> شرح حقول المشغّل المشتركة — نشط، النوع، الحدث، التكاملات، الشروط، ربط المخرجات — ودورة العمل من الحدث حتى التشغيلة.

كل مشغّل يُضبط من لوحة جانبية واحدة. الحقول التالية مشتركة في معظم الأنواع؛ فهم أثر الخطأ فيها أغنى من حفظ أسماء الأحداث.

## الحقول المشتركة

| الحقل                  | ماذا يفعل                                   | أثر الخطأ فيه                                                          |
| ---------------------- | ------------------------------------------- | ---------------------------------------------------------------------- |
| **نشط**                | يفعّل أو يعطّل استقبال الأحداث لهذا المشغّل | المعطّل يظهر على اللوحة لكن لا يبدأ شيئاً — حتى لو كانت الأتمتة منشورة |
| **نوع المشغّل**        | مصدر الأحداث (محادثة، شريحة، سلوك، تطبيق…)  | نوع خاطئ = قائمة أحداث مختلفة تماماً                                   |
| **الحدث**              | اللحظة المحددة داخل النوع                   | المسار يبدأ في الوقت الخطأ أو لا يبدأ                                  |
| **التكاملات / السياق** | يقيّد أو يوجّه حسب حساب القناة (انظر أدناه) | ترحيب مخصّص لقناة يصل عملاء قنوات أخرى — أو العكس: تقييد بلا أثر       |
| **شروط المشغّل**       | فلاتر إضافية قبل بدء التشغيلة               | بلا شروط: تشغيلات كثيرة وضجيج في السجل                                 |
| **ربط مخرجات المشغّل** | تمرير بيانات الحدث لمتغيرات المسار          | خطوات لاحقة بلا القيم التي تعتمد عليها                                 |

<Info>
  **وسائط مطلوبة:** لوحة إعداد مشغّل تعرض الحقول: نشط، نوع المشغّل، الحدث، التكاملات، شروط المشغّل.\
  المسار المقترح: `/images/help/automations/trigger-options-panel.webp`\
  **فيديو (مستحسن):** 25 ثانية: تفعيل المشغّل، اختيار حدث، ثم إضافة شرط واحد.
</Info>

## التكاملات والسياق: متى يقيّد ومتى لا؟

سلوك هذا الحقل **يتغيّر حسب نوع المشغّل** — وهذا أكثر ما يُخطَأ فيه:

| السياق                            | السلوك العملي                                                                                                                                               |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **أحداث المحادثة المرتبطة بقناة** | فلتر حقيقي على **حساب القناة** (تكامل معيّن: رقم واتساب، صفحة، صندوق بريد…) لا على «نوع القناة» عامة. **فارغ** = كل الحسابات المرتبطة الآن وما يُربط لاحقاً |
| **الشريحة والعميل**               | غالباً لا يوجد فلتر قنوات متعدد. إن ظهر تكامل واحد فهو **سياق تنفيذ لاحق** (مثلاً أي حساب تُرسل منه رسالة) لا مانع لوقوع المشغّل                            |
| **الأحداث السلوكية (البكسل)**     | الحقل غالباً **شكلي**: الحدث لا يحمل معلومة قناة كافية للمطابقة. التقييد الحقيقي عبر **شروط المشغّل** (صفحة، تكرار، نوع زائر…)                              |
| **بعض أحداث القنوات المتخصصة**    | قد يتجاوز الفلتر إن لم يحمل الحدث هوية تكامل واضحة                                                                                                          |

<Warning>
  إن حدّدت قناة واحدة وما زال المسار يعمل على قنوات أخرى، لا تفترض فوراً خللاً في النشر — تحقق هل نوع الحدث يحمل معلومة قناة أصلاً، وراجع [سجل التنفيذ](/ar/help-center/guides/automations/execution-history).
</Warning>

<Tip>
  عند ربط قناة جديدة لاحقاً، راجع المشغّلات ذات فلتر التكاملات **الفارغ**. قد تبدأ أتمتات قديمة بالعمل على القناة الجديدة دون قصد.
</Tip>

## شروط المشغّل أهم من تعداد الأحداث

الشروط تضيّق من يدخل المسار **قبل** أي عقدة — أنظف من شرط داخل المسار لأنها تمنع تشغيلات بلا فائدة.

أمثلة عملية (لا قائمة أحداث):

* وسم عميل معيّن فقط
* تقييم أقل من حدّ
* صفحة أو مسار URL محدد في حدث سلوكي
* استبعاد من هم في محادثة مفتوحة أصلاً

القاعدة: **ما يمكن استبعاده في المشغّل لا تفحصه داخل المسار.**

## ربط مخرجات المشغّل

عند وقوع الحدث تصل معه بيانات (محادثة، عميل، خصائص حدث…). **ربط المخرجات** يجعل هذه القيم متاحة كمتغيرات في الرسائل والشروط والإجراءات.

إن تخطّيت الربط أو ربطت حقولاً خاطئة، المسار قد يبدأ لكن الخطوات التالية تعمل بقيم فارغة أو قديمة.

## دورة العمل من الحدث إلى التشغيلة

```
حدث في المصدر
    → مطابقة نوع المشغّل والحدث
    → فلتر تكامل إن وُجد ويُطبَّق
    → شروط المشغّل
    → بدء تشغيلة جديدة
    → المتغيرات متاحة لخطوات المسار
```

أي حلقة تفشل بصمت تبدو كـ«الأتمتة لا تعمل». ابدأ من المصدر (هل وقع الحدث؟) ثم المشغّل (نشط؟ نوع؟ شروط؟) ثم النشر.

## أكثر من مشغّل على مسار واحد

يمكنك ربط عدة مشغّلات بنفس المسار — مثلاً افتتاح محادثة وإعادة فتحها لمسار فرز مشترك. انتبه:

1. نص المسار يجب أن يناسب الحالتين.
2. عند التشخيص استخدم فلتر نوع المشغّل في سجل التنفيذ.

## تشخيص سريع

| العَرَض                    | ابحث هنا أولاً                                                                                                                              |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **لا تشغيلات**             | مشغّل غير نشط · أتمتة مسودة · الحدث لا يقع في المصدر (بكسل غير موثّق، شريحة لا يدخلها أحد) · شروط أضيق من الواقع · فلتر تكامل يستبعد القناة |
| **تشغيلات كثيرة**          | شروط المشغّل غائبة أو فضفاضة · فلتر تكاملات فارغ بلا قصد · حدث عالي التكرار (تصفّح) بلا تقييد صفحة                                          |
| **تعمل على قناة دون أخرى** | فلتر تكاملات يقيّد حساباً واحداً · أو العكس: حدث لا يحمل قناة فيتجاوز الفلتر · قناة جديدة لم تُراجع بعد ربطها                               |

## ذات صلة

* [نظرة عامة على المشغّلات](/ar/help-center/guides/automations/triggers/overview)
* [أنواع المشغّلات بالأمثلة](/ar/help-center/guides/automations/triggers/types)
* [سجل التنفيذ واستكشاف الأخطاء](/ar/help-center/guides/automations/execution-history)


## Related topics

- [أنواع المشغّلات بالأمثلة](/ar/help-center/guides/automations/triggers/types.md)
- [نظرة عامة على المشغّلات](/ar/help-center/guides/automations/triggers/overview.md)
- [الأتمتة على الأحداث السلوكية](/ar/help-center/guides/pixel/with-automations.md)
- [استخدام التطبيقات في الأتمتات](/ar/help-center/guides/automations/apps/use-in-automations.md)
- [خيارات النافذة](/ar/help-center/guides/popups/options.md)