الأفعال

الأفعال هي ما ينفّذه البوت عند تفعيل التفاعل. يمكن أن يحتوي التفاعل على عدة أفعال تُنفَّذ بالترتيب من الأعلى للأسفل. تُضاف بزر إضافة فعل في قسم الأفعال في المحرر. تتبادل الأفعال البيانات عبر سياق التنفيذ (ctx) ومعاملات المستخدم — انظر المتغيرات والصيغ.

الرسائل والردود

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

المستخدم: التسميات والمعاملات

  • تعديل التسميات — يضيف و/أو يزيل تسميات المشترك.
  • تعديل المعاملات — يضبط قيم معاملات المستخدم أو يحذفها أو يزيدها.

الإشراف

  • حذف المُستلَمة — يحذف الرسالة الواردة (اختيارياً — جميع رسائل المستخدم، مع تأخير).
  • حذف المُرسَلة — يحذف رسائل البوت (لهذا التفاعل أو جميعها في المحادثة، مع تأخير).
  • تعديل الصلاحيات — كتم / رفع الكتم / حظر / رفع الحظر / تقييد الصلاحيات للعضو، لمدة محددة أو للأبد؛ تُختار الصلاحيات المحددة للتقييد.
  • تفاعل مهم (لون) — يُعلّم المحادثة بلون للمشغّل.

البيانات والمجموعات

  • إنشاء سجل — يضيف صفاً إلى المجموعة؛ مع «مفتاح إزالة التكرار» يعمل كـ upsert (بدون تكرار).
  • تحديث السجلات — يعدّل الصفوف المطابقة للفلتر.
  • البحث في السجلات — يقرأ الصفوف في السياق كمصفوفة (للتكرار).
  • حذف السجلات — يحذف الصفوف وفق الفلتر.
  • حلقة على القائمة — يكرر المصفوفة من ctx وينفّذ الأفعال المتداخلة لكل عنصر (مثلاً بث لقائمة).

مزيد من التفاصيل عن المجموعات — المجموعات والبيانات.

الطلبات الخارجية

  • طلب ويب — طلب HTTP (GET/POST/PUT/DELETE) مع رؤوس وجسم ورموز نجاح ومهلة وإعادة محاولة؛ يُحفظ الرد في معامل أو ctx عبر JSONPath؛ يمكن تنفيذه بشكل غير متزامن وتشغيل تفاعلات عند النجاح/الخطأ.
  • تحميل URL — ينزّل الصفحة ويحفظ نصها المقروء في ctx (للمعالجة اللاحقة أو الذكاء الاصطناعي).
  • طلب إلى مصدر — يقرأ بيانات من موصّل مُتصل (REST / OzmaDB) في ctx.
  • كتابة في مصدر — يكتب بيانات في الموصّل (POST/PUT/DELETE).

عن المصادر والمفاتيح — المصادر والمفاتيح.

الذكاء الاصطناعي والحسابات

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

المنطق والسيناريوهات

  • تفاعل متسلسل — يُشغِّل تفاعلاً آخر باسمه.
  • التفاعل التالي — ينقل التحكم إلى التفاعل المناسب التالي في القائمة.
  • تشغيل سيناريو — يُطلق معالجاً خطوة بخطوة (flow). انظر السيناريوهات.
  • طلب تأكيد — يرسل بطاقة إلى المعتمِد؛ أزرار «تأكيد»/«رفض» تُشغِّل التفاعلات المحددة.
  • تحويل إلى مشغّل — ينقل المحادثة إلى صندوق البريد الوارد للمشغّل. انظر المحادثات والمشغّلون.

التكاملات

أفعال GetCourse وGoogle Sheets وGoogle Drive تتصل عبر التكاملات المقابلة (انظر التكاملات). في منشئ التفاعلات هذه الأفعال مُعلَّمة بـ«قريباً» — في الوقت الحالي استخدمها عبر إعداد التكامل أو طلبات الويب أو الذكاء الاصطناعي. الإرسال العام إلى خدمة خارجية متاح عبر تكامل Webhook وفعل طلب ويب.

ما التالي