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

# استخدام التطبيقات في الأتمتات

> أضف إجراء تطبيق داخل عقدة الإجراء، اضبط معاملاته واختبره قبل النشر، واستخدم أحداث التطبيقات كمشغّلات — مع أمثلة عملية.

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

## الطريقة ١: إجراء تطبيق داخل المسار

<Steps>
  <Step title="أضف عقدة إجراء">
    من لوحة العُقد، فئة **التكاملات**.
  </Step>

  <Step title="اختر التطبيق">
    من منتقي الإجراءات، ابحث بالاسم أو تصفّح فئة **تكاملات**. تظهر التطبيقات المتصلة فقط.
  </Step>

  <Step title="اختر الإجراء">
    كل تطبيق يوفّر مجموعة إجراءات خاصة به: إضافة صف، إنشاء سجل، تحديث حالة، إرسال إشعار…
  </Step>

  <Step title="املأ المعاملات">
    الحقول تتغيّر حسب الإجراء. بعضها قوائم تُحمَّل مباشرة من حسابك — مثل اختيار جدول وورقة في Google Sheets.
  </Step>

  <Step title="اختبر الإجراء">
    استخدم زر الاختبار في نموذج الإجراء للتأكد أنه يعمل قبل النشر.
  </Step>

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

<Info>
  **وسائط مطلوبة:** منتقي إجراءات التطبيقات مع البحث والفئات، ثم نموذج إجراء Google Sheets مع منتقي الجدول والورقة.\
  المسار المقترح: `/images/help/automations/apps-action-picker-and-form.webp`\
  **فيديو (مستحسن):** 40 ثانية: إضافة إجراء «إضافة صف» واختباره.\
  **عرض تفاعلي (مستحسن):** اختبار إجراء بنتيجة ناجحة ثم بأخرى فاشلة وقراءة الرسالة.
</Info>

### اختبر قبل النشر دائماً

زر الاختبار داخل نموذج الإجراء يوفّر عليك اكتشاف الخلل من شكوى عميل. الاختبار يكشف:

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

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

### ترتيب الإجراءات داخل العقدة

عقدة الإجراء تنفّذ بالترتيب من الأعلى للأسفل. عندما يعتمد إجراء على نتيجة سابقه، الترتيب ليس تفصيلاً شكلياً. رتّب دائماً حسب الاعتماد المنطقي: اجمع البيانات ← سجّلها ← بلّغ الفريق ← ردّ على العميل.

## الطريقة ٢: مشغّل من التطبيق

بعض التطبيقات ترسل أحداثها إلى كرزون فتبدأ مساراً: طلب جديد في متجرك، موعد محجوز في Calendly، أو حدث آخر يوفّره التطبيق.

الإعداد كأي مشغّل: اختر النوع الخاص بالتطبيق، ثم الحدث، ثم اضبط الشروط ومفتاح **نشط**. الحقول المشتركة مشروحة في [خيارات المشغّل وكيف يعمل](/ar/help-center/guides/automations/triggers/options)، وعائلة التطبيقات ضمن [أنواع المشغّلات بالأمثلة](/ar/help-center/guides/automations/triggers/types).

الأحداث المتاحة تختلف بين تطبيق وآخر لأنها تتبع ما يرسله المزوّد. افتح منتقي المشغّل بعد الربط لترى ما يدعمه تطبيقك فعلاً.

## أمثلة عملية

### تسجيل كل استفسار في جدول

مشغّل: **محادثة جديدة** ← سؤال يفرز نوع الطلب ← إجراء **Google Sheets: إضافة صف** بالتاريخ والقناة ونوع الطلب واسم العميل.

النتيجة: تقرير حي عن أنواع الاستفسارات بلا عمل يدوي.

### تنبيه الفريق على Slack

مشغّل: **إضافة تقييم** بشرط التقييم المنخفض ← إجراء Slack: رسالة لقناة الجودة ← عقدة إجراء: وسم + إسناد للمشرف.

### حجز موعد

مشغّل: حدث Calendly (موعد محجوز) ← رسالة تأكيد للعميل ← تأخير حتى قبل الموعد بيوم ← تذكير ← تأخير حتى قبله بساعتين ← تذكير أخير.

### تأكيد طلب من المتجر

مشغّل: طلب جديد ← رسالة تأكيد ← إجراء تحديث بيانات العميل ← وسم «مشترٍ». راجع [تطبيقات المتاجر](/ar/help-center/guides/automations/apps/ecommerce).

## ماذا يحدث إن كان التطبيق غير متصل؟

الخطوة **تفشل** وتظهر التشغيلة في [سجل التنفيذ](/ar/help-center/guides/automations/execution-history) بحالة **فشلت** عند تلك الخطوة تحديداً.

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

## عادات جيدة

* ضع **ملاحظة لاصقة** بجانب عقد التطبيقات تشرح الوجهة الخارجية (اسم الجدول، القناة، الحساب).
* تجنّب سلسلة طويلة من إجراءات التطبيقات في عقدة واحدة؛ فشل واحد يوقف الباقي.
* عند تغيير أي شيء في النظام الخارجي (حذف ورقة، إعادة تسمية قناة)، راجع الأتمتات المرتبطة به.
* راقب سجل التنفيذ بعد كل ربط جديد لمدة يوم.
* سجّل من ربط التطبيق ومتى؛ الاتصالات المرتبطة بحسابات شخصية تنقطع عند مغادرة أصحابها.

## أخطاء شائعة

| الخطأ                       | النتيجة                            | الصواب                         |
| --------------------------- | ---------------------------------- | ------------------------------ |
| بناء الإجراء قبل الربط      | التطبيق لا يظهر في المنتقي         | اربطه أولاً                    |
| النشر بلا اختبار            | فشل يكتشفه العميل                  | اختبر داخل النموذج             |
| الاختبار على بيانات إنتاجية | صفوف وسجلات وهمية في نظامك         | استخدم وجهة تجريبية            |
| ترتيب إجراءات معكوس         | إجراء يعتمد على نتيجة لم تُنتج بعد | رتّب حسب الاعتماد              |
| حذف الوجهة الخارجية         | فشل صامت في مسار حي                | راجع الأتمتات عند أي تغيير     |
| تجاهل شارة الحالة           | أتمتة معطلة بلا سبب واضح           | افحص **متصل** أولاً عند أي عطل |

## ذات صلة

* [نظرة عامة على التطبيقات](/ar/help-center/guides/automations/apps/overview)
* [تثبيت تطبيق وربطه](/ar/help-center/guides/automations/apps/install-connect)
* [استكشاف أخطاء الربط](/ar/help-center/guides/automations/apps/troubleshooting)
* [سجل التنفيذ واستكشاف الأخطاء](/ar/help-center/guides/automations/execution-history)


## Related topics

- [تثبيت التطبيقات](/ar/help-center/guides/store/install-apps.md)
- [نظرة عامة على التطبيقات](/ar/help-center/guides/automations/apps/overview.md)
- [تثبيت تطبيق وربطه](/ar/help-center/guides/automations/apps/install-connect.md)
- [استكشاف أخطاء الربط](/ar/help-center/guides/automations/apps/troubleshooting.md)
- [تطبيقات المتاجر](/ar/help-center/guides/automations/apps/ecommerce.md)