واکنشها: مقدمات
واکنش — بلوک اصلی سازنده بات است: قانونی که توصیف میکند چه زمانی فعال شود، تحت چه شرایطی و چه کاری انجام دهد. بات یک لیست مرتب از واکنشهاست؛ برای هر رویداد ورودی، پلتفرم لیست را از بالا به پایین میپیماید و اولین واکنش مناسب را اعمال میکند. بخش — واکنشها در منوی چپ.
اجزای یک واکنش
یک واکنش چهار بخش دارد (تبهای ویرایشگر):
- ماشه — رویداری که واکنش به آن پاسخ میدهد: متن، دستور، رسانه، فشار دکمه، رویداد سیستمی، برنامهریزی زمانی و غیره. ببینید ماشهها.
- در چتها — کجا واکنش فعال است: چت شخصی، گروهها هنگام خطاب به بات، چتهای خاص؛ به اضافه فیلترهایی بر اساس وضعیت کاربر.
- شرایط — فیلترهای اضافی (برچسبها، پارامترها، زمان، تعداد پیامها و غیره). ببینید شرایط و چتها.
- اقدامات — آنچه بات هنگام فعال شدن انجام میدهد: ارسال پیام، اضافه کردن برچسب، نوشتن در مجموعه، فراخوانی هوش مصنوعی و غیره. ببینید اقدامات.
ایجاد و ویرایش
روی ایجاد واکنش کلیک کنید (یا یک واکنش موجود را باز کنید). در سرتیتر ویرایشگر: نام (الزامی)، شماره #N، توضیحات و کلید فعال. در سمت چپ — ناوبری بین بخشهای ماشه / در چتها / شرایط / اقدامات، در مرکز — فرم، در سمت راست — پیشنمایش Telegram که نشان میدهد پیام با بلوکها، صفحهکلید و منو چگونه به نظر میرسد. با دکمه ذخیره ذخیره کنید.
برای واکنش ذخیرهشده، ویرایشگر یک پنل آمار نشان میدهد: تعداد فعالسازیها، نمودار و آخرین رویدادها.
ترتیب و اولویت
واکنشها در لیست قابل جابجایی هستند — ترتیب، اولویت را تعیین میکند. برای یک رویداد، اولین واکنش مناسب فعال میشود و سپس پردازش متوقف میشود. برای ادامه پردازش و اجازه به فعال شدن واکنشهای مناسب بعدی، اقدام واکنش بعدی (goto_next) را اضافه کنید.
فعال و غیرفعال کردن
کلید در ردیف لیست (یا فعال در ویرایشگر) واکنش را روشن یا خاموش میکند، بدون حذف آن. واکنشهای غیرفعال در پردازش نادیده گرفته میشوند.
تکراربرداری و حذف
در ردیف لیست دکمههای تکراربرداری (ایجاد نسخه کپی) و حذف وجود دارند. تکراربرداری زمانی مفید است که میخواهید واکنشی مشابه با تفاوتهای جزئی ایجاد کنید.
وارد و صادر کردن
میتوان واکنش را به JSON صادر کرد (دکمه صادر کردن در ویرایشگر) و دوباره وارد کرد (وارد کردن در لیست). این امکان انتقال واکنش بین باتها و ذخیره نسخهها خارج از پلتفرم را فراهم میکند.
همهرسانی واکنش
دکمه همهرسانی در ردیف واکنش (آیکون «ارسال») این واکنش را به تمام مشترکان فعال بات ارسال میکند — برای اطلاعیهها و اعلانها مناسب است. مخاطبان را میتوان بر اساس برچسبها محدود کرد. جزئیات بیشتر — همهرسانیها.
زنجیرهها و مکالمات
از چندین واکنش میتوان سناریو ساخت:
- واکنش زنجیری (
chain) — اقدامی که یک واکنش دیگر را در حین اجرا راهاندازی میکند. - واکنش بعدی (
goto_next) — کنترل را به واکنش مناسب بعدی در لیست منتقل میکند. - مراحل مکالمه — یک بلوک پیام میتواند منتظر پاسخ کاربر بماند (با بررسی فرمت)، و سناریو را متوقف کند. ببینید پیامها و دکمهها.
- شاخه «در غیر این صورت» — اگر شرایط واکنش برقرار نشدند، میتوان واکنش دیگری راهاندازی کرد (فیلد در بخش «شرایط»).
مراحل بعدی
- ماشهها — تمام انواع فعالسازی.
- شرایط و چتها — فیلترها و محدوده اجرا.
- اقدامات — لیست کامل اقدامات.
- پیامها و دکمهها — سازنده پاسخها.