التفاعلات: الأساسيات
التفاعل هو اللبنة الأساسية للبوت: قاعدة تصف متى يُفعَّل، وفي أي ظروف، وماذا يفعل. البوت قائمة مرتّبة من التفاعلات؛ لكل حدث وارد تسير المنصة في القائمة من الأعلى للأسفل وتطبّق أول تفاعل مناسب. القسم — التفاعلات في القائمة اليسرى.
مكونات التفاعل
للتفاعل أربعة أجزاء (علامات تبويب المحرر):
- المُشغِّل — الحدث الذي يستجيب له التفاعل: نص، أمر، وسائط، نقرة زر، حدث نظامي، جدولة، إلخ. انظر المُشغِّلات.
- في المحادثات — أين يعمل التفاعل: محادثة خاصة، مجموعات عند مخاطبة البوت، محادثات محددة؛ إضافة فلاتر حالة المستخدم.
- الشروط — فلاتر إضافية (التسميات، المعاملات، الوقت، عدد الرسائل، إلخ). انظر الشروط والمحادثات.
- الأفعال — ما يفعله البوت عند التفعيل: إرسال رسالة، وضع تسميات، الكتابة في مجموعة، استدعاء الذكاء الاصطناعي، إلخ. انظر الأفعال.
الإنشاء والتحرير
انقر إنشاء تفاعل (أو افتح تفاعلاً موجوداً). في رأس المحرر: الاسم (إلزامي)، رقم #N، الوصف، ومفتاح نشط. على اليسار — تنقل بين الأقسام المُشغِّل / في المحادثات / الشروط / الأفعال، في الوسط — النموذج، على اليمين — معاينة Telegram التي تُظهر كيف ستبدو الرسالة مع البلوكات ولوحة المفاتيح والقوائم. احفظ بزر حفظ.
يعرض محرر التفاعل المحفوظ لوحة الإحصائيات: عدد مرات التفعيل، والرسم البياني، وآخر الأحداث.
الترتيب والأولوية
يمكن سحب التفاعلات في القائمة — الترتيب يحدد الأولوية. يُفعَّل أول تفاعل مناسب للحدث، ثم يتوقف الفرز. لمواصلة الفرز وإتاحة تفعيل التفاعلات المناسبة التالية، أضف فعل التفاعل التالي (goto_next).
التشغيل والإيقاف
مفتاح التبديل في سطر القائمة (أو نشط في المحرر) يُشغّل ويوقف التفاعل دون حذفه. التفاعلات الموقوفة تُتخطى في الفرز.
التكرار والحذف
في سطر القائمة أزرار تكرار (ينشئ نسخة) وحذف. التكرار مفيد عند الحاجة إلى تفاعل مشابه بفروق طفيفة.
الاستيراد والتصدير
يمكن تصدير التفاعل بصيغة JSON (زر تصدير في المحرر) وإعادة تحميله (استيراد في القائمة). هذا ينقل التفاعل بين البوتات ويتيح حفظ الإصدارات خارج المنصة.
بث التفاعل
زر البث في سطر التفاعل (أيقونة «إرسال») يرسل هذا التفاعل لجميع المشتركين النشطين في البوت — مناسب للإعلانات والإشعارات. يمكن تضييق الجمهور بالتسميات. مزيد من التفاصيل — البث الجماعي.
السلاسل والمحادثات
من عدة تفاعلات تُبنى سيناريوهات:
- التفاعل المتسلسل (
chain) — فعل يُشغِّل تفاعلاً آخر أثناء التنفيذ. - التفاعل التالي (
goto_next) — ينقل التحكم إلى التفاعل المناسب التالي في القائمة. - خطوات المحادثة — يمكن لبلوك الرسالة انتظار رد المستخدم (مع التحقق من التنسيق)، مما يوقف السيناريو مؤقتاً. انظر الرسائل والأزرار.
- فرع «وإلا» — إذا لم تتحقق شروط التفاعل، يمكن تشغيل تفاعل آخر (حقل في قسم «الشروط»).
ما التالي
- المُشغِّلات — جميع أنواع التفعيل.
- الشروط والمحادثات — الفلاتر ونطاق العمل.
- الأفعال — القائمة الكاملة للأفعال.
- الرسائل والأزرار — منشئ الردود.