قاعدة معرفة GetMyBot

التفاعلات: الأساسيات

كيف تجعل البوت يردّ على أمر أو زر أو حدث آخر، وكيف ترتّب التفاعلات وتربطها.

في هذه الصفحة

التفاعل قاعدة واحدة لسلوك البوت. مثال: «إذا كتب شخص /price، فأرسل قائمة الأسعار»، أو «بعد دفع الطلب، أضف تصنيف “دفع” وامنح حق الوصول».

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

ممّ يتكون التفاعل؟

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

علامة التبويبما الذي تحدده؟مثال
المُشغِّلمتى يبدأ التفاعل: نص، أمر، وسائط، زر، حدث أو موعدكتب الشخص /price
في المحادثاتأين يعمل: في المحادثة الخاصة، عند مخاطبة البوت في المجموعة، أو في محادثات محددة؛ مع مراعاة حالة المستخدمفي المحادثة الخاصة فقط
الشروطما الذي يُفحص أيضًا: التسميات، المعاملات، الوقت أو عدد الرسائللدى الشخص تسمية «دفع»
الإجراءاتما الذي يفعله البوت: يرسل رسالة، يغير التسميات، يسجل بيانات أو يستدعي الذكاء الاصطناعييرسل قائمة الأسعار

الإنشاء والتحرير

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

يعرض محرر التفاعل المحفوظ عدد مرات تشغيله ورسمًا بيانيًا وآخر الأحداث.

سجل التغييرات والاستعادة

افتح Change history للتفاعل المحفوظ. سترى آخر 20 تغييرًا مع الوقت وصاحب التغيير ومصدره والاختلافات بين «Before / After». يمكنك استعادة الحالة التي كانت قبل تغيير محدد: راجع الفرق أولًا ثم أكد الاستعادة.

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

الترتيب والأولوية

يمكن سحب التفاعلات لإعادة ترتيبها يدويًا عندما يكون البحث والفلاتر متوقفين ولا يوجد مجلد محدد. الترتيب يحدد الأولوية: يُنفذ أول تفاعل مناسب للحدث ثم يتوقف الفحص. إذا أردت متابعة الفحص وتشغيل التفاعلات المناسبة التالية، أضف فعل التفاعل التالي (goto_next).

البحث والفلاتر والتجميع

فوق القائمة بحث بالاسم والرقم، وهذه الفلاتر:

  • الحالة: الكل، النشطة فقط أو غير النشطة فقط.
  • أُنشئ من / إلى: أيام تقويمية وفق منطقتك الزمنية، مع شمول التاريخين.
  • الترتيب: يدوي (وهو ترتيب فحص البوت)، الأحدث أولًا أو الأقدم أولًا.
  • التجميع: بحسب يوم الإنشاء أو شهره، ويعمل مع الترتيب بالتاريخ فقط. إذا فعّلته أثناء الترتيب اليدوي تنتقل القائمة إلى «الأحدث أولًا». يحتفظ المحرر بالترتيب السابق إذا كان بالتاريخ، وتؤدي العودة للترتيب اليدوي إلى إيقاف التجميع.

تُطبَّق الفلاتر على جميع التفاعلات، لا الصفحة المفتوحة فقط، ويمكن جمعها مع البحث والمجلدات. يعرض العداد عدد النتائج. تُحفظ خيارات الفلاتر في عنوان الصفحة، فتستطيع تحديثها أو مشاركة الرابط أو الرجوع بزر «رجوع». يمحو إعادة ضبط الفلاتر البحث والفلاتر والترتيب والتجميع، لكنه يبقي المجلد المحدد.

تغير الفلاتر والترتيب المعروض شكل القائمة فقط، ولا تغير ترتيب فحص البوت للتفاعلات.

التفعيل والإيقاف

يشغّل المفتاح في سطر القائمة، أو مفتاح نشط في المحرر، التفاعل ويوقفه دون حذفه. يتجاهل البوت التفاعلات المتوقفة.

النسخ والحذف

في سطر التفاعل زرا تكرار لإنشاء نسخة وحذف. التكرار مفيد إذا أردت تفاعلًا مشابهًا مع تعديل بسيط.

الاستيراد والتصدير

يمكن تنزيل التفاعل ملف JSON بزر تصدير في المحرر، ثم تحميله عبر استيراد تفاعل في القائمة. يفيد ذلك في نقله بين البوتات وحفظ نسخ خارج المنصة.

إرسال التفاعل جماعيًا

زر إرسال… ذي رمز الإرسال في سطر التفاعل يشغّله لكل المشتركين النشطين في البوت. يمكن حصر الجمهور بتصنيفات محددة. انظر الإرسال الجماعي.

السلاسل والحوارات

مثلًا: يعرض التفاعل الأول كتالوجًا، ثم يفتح الزر تفاعلًا ثانيًا فيه بطاقة المنتج، ثم يسأل عن عنوان التسليم. يمكن الربط بين التفاعلات بعدة طرق:

  • التفاعل المتسلسل (chain): يشغّل تفاعلًا آخر أثناء تنفيذ الحالي.
  • التفاعل التالي (goto_next): ينقل التنفيذ إلى التفاعل المناسب التالي في القائمة.
  • خطوات الحوار: يمكن لكتلة الرسالة انتظار رد المستخدم وفحص نوعه، مع إيقاف السيناريو مؤقتًا. انظر الرسائل والأزرار.
  • فرع «وإلا»: إذا لم تتحقق شروط التفاعل، يمكن تشغيل تفاعل آخر من إعدادات الشروط.
  • اختيار الخطوة التالية (branch_result): يتعامل مع نتيجة بحث فارغة أو مفردة أو متعددة أو غير مكتملة.
  • اختيار خطوة حسب القيمة (branch_value): مثل تأكيد الطلب عند updated أو طلب إعادة قراءة حالته عند conflict.
  • نتيجة الفعل: الانتقال إلى تفاعل مختلف عند النجاح أو التعارض أو غياب السجل أو الخطأ، إذا كان الفعل يدعم ذلك. انظر توجيه النتائج.
  • Call block (call_block): يرسل مدخلات إلى عملية مشتركة ويستقبل مخرجاتها المحددة في التفاعل الحالي. انظر مكتبة الكتل والإصدارات.

للتعامل مع البيانات، اربط البحث في المجموعة → اختيار الخطوة التالية → الأزرار → إيجاد السجلات المرتبطة. وإذا كانت القائمة من خدمة خارجية، استخدم معالجة القائمة → المجموعات والنتائج الإجمالية. سمِّ نتيجة كل فعل ثم اخترها في الخطوة التالية. تعرض الدروس العملية هذين المسارين بأمثلة عن الدروس والطلبات.

أثناء الإعداد استخدم اختيار بيانات الخطوات السابقة بدل حفظ مسارات الحقول يدويًا. قبل الحفظ، اختبر المسودة ببيانات تدريبية وافحص الفرع والرسائل المتوقعة. بعد الحفظ، جرّب مسار المستخدم عبر البوت والقناة المتصلين حيث تُنفذ الأفعال فعلًا.

ما التالي؟