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

# عند تلقي حدث من الموصِّل

> تشغيل سير العمل عندما يُبلغ تطبيق خارجي متصل عن حدث

<Note>متاح في جميع خطط السحابة؛ أما الاستضافة الذاتية فتتطلّب خطة الأعمال أو أعلى، مع تفعيل أحداث الموصِّل من قِبل مَن يدير عملية النشر.</Note>

ابدأ سير العمل انطلاقًا مما يحدث داخل تطبيق متصل مثل GitHub أو Gmail أو Slack: وصول رسالة بريد جديدة، أو فتح مشكلة، أو نشر رسالة. يسلّم التطبيق الحدث إلى Teable مباشرة، فلا تحتاج إلى استضافة عنوان Webhook ولا إلى الاستعلام الدوري عن التغييرات.

## الإنشاء بالذكاء الاصطناعي

افتح محادثة الذكاء الاصطناعي في الشريط الجانبي الأيمن لأي جدول واشرح ما تحتاج إليه.

يتولّى الذكاء الاصطناعي كل شيء: يختار المُشغِّل المناسب، ويربط الحقول ذات الصلة، ويُعدّ الإجراءات.

اشرح الهدف مرة واحدة ليصبح سير العمل جاهزًا من دون إعداد يدوي.

**مثال:** *"عند فتح مشكلة جديدة في مستودع GitHub، أنشئ سجلًا في جدول المهام"*

## كيفية الإعداد

<Steps>
  <Step title="اختيار المُشغِّل">
    أنشئ سير عمل واختر **عند تلقي حدث من الموصِّل** مُشغِّلًا له.
  </Step>

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

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

  <Step title="تعبئة المعلمات">
    عبّئ **المعلمات** التي يطلبها الحدث، مثل مستودع أو قناة أو وسم. والحقول المعلّمة بـ \* إلزامية. ثم انقر **حفظ**.
  </Step>

  <Step title="التفعيل">
    أضف الإجراءات التالية ثم شغّل سير العمل. يُنشأ الاشتراك عند التفعيل، لذا لا تستقبل المسودّة شيئًا.
  </Step>
</Steps>

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

## شارات الأحداث

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

## البيانات المتاحة بعد الاستثارة

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

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

## عند انقطاع الاتصال

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

ويُرسل Teable إشعارًا إلى العضو الذي عدّل سير العمل آخر مرة، وتعرض لوحة المُشغِّل **غير متصل — أعد توصيل الحساب أو اختر حسابًا آخر**. وتختلف المعالجة بحسب السبب:

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

## بعد النسخ أو الاستيراد

لا تنتقل بيانات الاعتماد مع سير العمل. فبعد نسخ سير عمل، أو استيراد مشروع أو نسخه، يعرض المُشغِّل **الحساب غير مصرح به**: اختر حسابًا من حساباتك واحفظ ليتمكّن سير العمل من الاشتراك من جديد.

## مستندات ذات صلة

* [بيانات الاعتماد وعمليات التكامل](/ar/basic/credential)
* [روتين](/ar/basic/ai/routine)