المُشغِّلات

المُشغِّل هو الحدث الذي يستجيب له التفاعل. في قسم المُشغِّل في المحرر يمكنك تفعيل عدة أنواع في آنٍ واحد: تُجمَّع بـ**«أو»** — يُفعَّل التفاعل إذا تحقق أي من المُشغِّلات المفعَّلة. القيود الإضافية (التسميات، المعاملات، المحادثات) تُضبط منفصلةً في الشروط.

رسالة نصية

يُفعَّل على نص أو تعليق على وسائط. في حقل «ما الذي أبحث عنه» يتم اختيار الوضع:

  • كلمات مفتاحية — قائمة كلمات/عبارات. معامل «التطابق»: يحتوي، تطابق تام، يبدأ بـ، تعبير نظامي؛ إضافة علامة «مراعاة حالة الأحرف».
  • رابط — الرسالة تحتوي على URL.
  • بريد إلكتروني — تحتوي على عنوان بريد.
  • إشارة (@username) — تحتوي على إشارة.
  • أي نص — أي رسالة نصية.

أمر

يُفعَّل على الأوامر التي تبدأ بـ slash. في حقل «الأوامر (بدون «/»)» أدرج الأسماء، مثلاً help، menu. سيستجيب البوت لـ /help و/menu.

أمر /start

مُشغِّل مخصص لـ /start. حقل Payload يلتقط معامل deep-link (/start <payload>)؛ القيمة الفارغة — أي /start. هذا هو الأساس للروابط المرجعية وروابط الحملات.

نقرة زر مضمّن (callback)

يُفعَّل عند نقر زر مضمّن. حقل «بيانات الزر (callback_data)» و**«التطابق»** (تام، يبدأ بـ، يحتوي، تعبير نظامي) تحدد الأزرار التي تُلتقط.

وسائط

يُفعَّل على المرفقات من الأنواع المختارة: صورة، فيديو، رسالة فيديو، مستند، صوت، رسالة صوتية، GIF، ملصق، نرد، لعبة، استطلاع، جهة اتصال، موقع جغرافي، مكان، ألبوم.

حدث نظامي

يُفعَّل على أحداث المحادثة: انضم عبر رابط، أُضيف إلى المحادثة، غادر المحادثة، أُزيل من المحادثة، غيّر الحالة، طلب انضمام، ردّ فعل على رسالة، عدّاد ردود الأفعال. مفيد للترحيب والإشراف وقبول الطلبات.

الرد والمُعاد توجيهه

  • رد (reply) على رسالة — يُفعَّل عندما تكون الرسالة رداً على رسالة أخرى.
  • رسالة مُعاد توجيهها — يُفعَّل على الرسائل المُعادة توجيهها.

كل رسالة N

يُفعَّل على كل رسالة رقم N من المستخدم (حقل «كل رسالة رقم»). مناسب للتلميحات الدورية أو مكافحة السبام.

وفق جدول (تواريخ)

يُفعَّل في لحظات زمنية محددة (قائمة تواريخ). يُرسَل التفاعل المُجدوَل للمشتركين النشطين عند حلول الموعد — انظر البث الجماعي.

طلب ويب وارد (webhook)

يُفعَّل على طلب HTTP من الخارج. تُضبط المسار (يتكوّن URL الكامل من عنوان البوت والمسار)، الرمز السري (للحماية)، والطريقة (POST / GET / PUT / ANY). تدخل بيانات الطلب في سياق التنفيذ وتكون متاحة في الأفعال عبر {{ctx.field}}. مزيد من التفاصيل — طلبات الويب والـ webhooks.

ما التالي