> ## 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.

# سجل التنفيذ واستكشاف الأخطاء

> اقرأ سجل التنفيذ داخل المحرر: حالات التشغيلة الست، الفلاتر، تفاصيل الخطوات، وطريقة منهجية لتشخيص «الأتمتة لا تعمل».

عندما يقول أحدهم «الأتمتة لا تعمل»، الجواب موجود دائماً في مكان واحد: **سجل التنفيذ**. هذه الصفحة تعلّمك قراءته، ثم تعطيك مساراً منهجياً للتشخيص بدل التخمين.

تفتحه من شريط أدوات المحرر: **سجل التنفيذ**.

## ما هي «التشغيلة»؟

كل مرة يقع فيها حدث يطابق مشغّلك، يبدأ كرزون **تشغيلة** مستقلة لذلك العميل. مئة عميل راسلوك = مئة تشغيلة، لكل واحدة مسارها وحالتها وخطواتها.

هذا يعني أن الأتمتة لا «تنجح» أو «تفشل» ككل، بل تنجح أو تفشل **لكل عميل على حدة**. لذلك لا تحكم من تجربة واحدة.

## حالات التشغيلة

| الحالة           | معناها                                                 | هل تحتاج تدخلاً؟                   |
| ---------------- | ------------------------------------------------------ | ---------------------------------- |
| **قيد التشغيل**  | تُنفَّذ الآن                                           | لا                                 |
| **قيد الانتظار** | متوقفة عند انتظار: تأخير، متابعة، أو انتظار إجابة سؤال | لا — إلا إن كان الانتظار غير مقصود |
| **مكتملة**       | أنهت المسار حتى نهايته                                 | لا                                 |
| **فشلت**         | خطوة لم تُنفَّذ                                        | **نعم** — افتح التفاصيل            |
| **فات موعدها**   | الوقت المجدول مرّ دون تنفيذ                            | **نعم** — راجع النافذة الزمنية     |
| **تم تخطيها**    | خطوة أُلغيت عمداً، مثل متابعة أُلغيت لأن العميل رد     | لا — غالباً السلوك المطلوب         |

<Note>
  كثرة **قيد الانتظار** ليست مشكلة في المسارات التي تحتوي تأخيراً أو متابعة — بل هي الوضع الطبيعي. المشكلة تبدأ عندما تجد تشغيلات منتظرة عند خطوة لا يفترض أن تنتظر.
</Note>

<Info>
  **وسائط مطلوبة:** لوحة سجل التنفيذ مفتوحة وفيها تشغيلات بحالات مختلفة (مكتملة، فشلت، قيد الانتظار، تم تخطيها).\
  المسار المقترح: `/images/help/automations/execution-history-list.webp`\
  **فيديو (مستحسن):** 30 ثانية: فتح السجل، الفلترة على «فشلت»، ثم فتح تفاصيل تشغيلة.
</Info>

## الفلاتر

| الفلتر           | استخدامه                                      |
| ---------------- | --------------------------------------------- |
| **الحالة**       | ابدأ دائماً بـ**فشلت** — أسرع طريق للمشكلة    |
| **نوع المشغّل**  | عزل مصدر واحد عندما تحتوي الأتمتة عدة مشغّلات |
| **نطاق التاريخ** | حصر الفحص حول وقت الشكوى أو بعد نشرة جديدة    |

كل صف يعرض: شارة مصدر البدء (**مشغّل** · **ماكرو** · **رسالة عميل**)، الهدف (العميل/المحادثة)، **المدة**، الحالة، والوقت النسبي.

## تفاصيل التشغيلة

انقر أي صف لفتح **تفاصيل التشغيلة**، وفيها:

* **الخطوات**: كل خطوة نُفِّذت بالترتيب وحالتها — هنا ترى بالضبط **أين توقف المسار**.
* **السياق**: العميل، المحادثة، ونتيجة السؤال إن وُجد.
* **البيانات الخام**: تفاصيل تقنية تفيد عند تصعيد المشكلة للدعم.

القاعدة: **لا تشخّص من قائمة السجل، شخّص من الخطوات.** القائمة تخبرك أن هناك مشكلة؛ الخطوات تخبرك أين.

<Info>
  **وسائط مطلوبة:** تفاصيل تشغيلة فاشلة مع تمييز الخطوة التي توقف عندها المسار.\
  المسار المقترح: `/images/help/automations/execution-detail-failed-step.webp`
</Info>

## تشخيص منهجي: «الأتمتة لا تعمل»

اتبع الترتيب — كل خطوة تستبعد نصف الاحتمالات:

<Steps>
  <Step title="هل توجد تشغيلات أصلاً؟">
    لا تشغيلات = المشكلة في **البدء** لا في المسار. تحقق أن الأتمتة **مفعّلة**، وأن المشغّل **نشط**، وأن الحدث يطابق ما تتوقعه، وأن فلتر **التكاملات** لا يستبعد القناة التي تختبر عليها.
  </Step>

  <Step title="هل التشغيلات تبدأ ثم تتوقف مبكراً؟">
    افتح الخطوات. التوقف عند أول عقدة يعني غالباً عقدة غير موصولة، أو فرعاً غير مربوط (**بدون تطابق** أو **بدون إدخال**).
  </Step>

  <Step title="هل الحالة «فشلت»؟">
    اقرأ الخطوة الفاشلة. الأسباب الشائعة: قناة غير مرتبطة أو معطّلة، تطبيق غير متصل، قسم أو حقل محذوف، أو قيد على القناة (قالب واتساب مطلوب).
  </Step>

  <Step title="هل الحالة «فات موعدها»؟">
    راجع إعدادات التأخير أو المتابعة: النافذة الزمنية، الأيام المسموحة، والمنطقة الزمنية.
  </Step>

  <Step title="هل «تم تخطيها»؟">
    غالباً سلوك صحيح — المتابعة تُلغى عند رد العميل. تأكد فقط أنه ما أردته.
  </Step>

  <Step title="هل تعمل لبعض العملاء دون غيرهم؟">
    شرط في المسار يفرزهم. راجع عقدة **شرط** وتأكد أن مخرج **بدون تطابق** موصول بشيء مفيد.
  </Step>
</Steps>

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

| السبب                     | كيف تعرفه                       | الحل                                                                                |
| ------------------------- | ------------------------------- | ----------------------------------------------------------------------------------- |
| الأتمتة ما زالت **مسودة** | لا تشغيلات إطلاقاً              | **تشغيل مباشر**                                                                     |
| المشغّل **غير نشط**       | لا تشغيلات رغم النشر            | فعّل مفتاح **نشط**                                                                  |
| فلتر تكامل يستبعد قناتك   | تعمل على قناة دون أخرى          | افتح لوحة المشغّل وراجع **التكاملات**                                               |
| عقدة معزولة بلا خط        | المسار يتوقف مبكراً             | اربطها                                                                              |
| فرع غير مربوط             | فئة من العملاء تتوقف صامتة      | اربط **بدون تطابق** و**بدون إدخال**                                                 |
| تطبيق غير متصل            | فشل عند خطوة إجراء تطبيق        | راجع [استكشاف أخطاء الربط](/ar/help-center/guides/automations/apps/troubleshooting) |
| مرجع محذوف (قسم/حقل/قناة) | فشل عند عقدة كانت تعمل سابقاً   | أعد اختيار العنصر ثم **إعادة النشر**                                                |
| قيد قناة (قالب واتساب)    | فشل الإرسال خارج نافذة المحادثة | استخدم قالباً معتمداً                                                               |
| نشرة جديدة كسرت المسار    | الفشل بدأ بعد وقت النشر         | **سجل الإصدارات** ← استعادة آخر إصدار سليم                                          |

## عادات مراقبة تستحق الالتزام

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

## ذات صلة

* [النشر والمسودة والحالات](/ar/help-center/guides/automations/publish-and-status)
* [الانتظار والمتابعة](/ar/help-center/guides/automations/wait-and-follow-up)
* [بناء المسار في المحرر](/ar/help-center/guides/automations/builder)
* [استكشاف أخطاء الربط](/ar/help-center/guides/automations/apps/troubleshooting)


## Related topics

- [عقدة: انتقل إلى](/ar/help-center/guides/automations/nodes/goto.md)
- [عقدة: تقسيم A/B](/ar/help-center/guides/automations/nodes/split.md)
- [نظرة عامة على المشغّلات](/ar/help-center/guides/automations/triggers/overview.md)
- [عقدة: إجراء — نظرة عامة](/ar/help-center/guides/automations/nodes/actions/overview.md)
- [التشغيل من حملة تسويقية](/ar/help-center/guides/automations/with-broadcasts.md)