واکنشها: مقدمات
بات را برای پاسخ به دستور، دکمه یا رویداد دیگر تنظیم کنید؛ ساخت واکنش، ترتیب بررسی و پیوند میان واکنشها.
در این صفحه
واکنش یک قانون برای رفتار بات است. برای نمونه: «وقتی کسی /price نوشت، فهرست قیمت را بفرست» یا «وقتی سفارش را پرداخت کرد، برچسب پرداختشده را اضافه کن و دسترسی بده».
در بخش واکنشها، رویداد، شرطهای اضافی و اقدامها را تنظیم کنید. بات قانونها را از بالا به پایین بررسی میکند و اولین مورد مناسب را اجرا میکند. بنابراین قانونهای خاص را معمولاً بالاتر از پاسخ عمومی به همهٔ پیامها قرار دهید.
اجزای واکنش
برای نمونهٔ فهرست قیمت، انتخاب دستور /price و نوشتن پاسخ کافی است. تنظیمات دیگر زمانی لازماند که قانون فقط برای افراد یا چتهای خاص کار کند. ویرایشگر چهار بخش دارد:
| بخش | کار آن | نمونه |
|---|---|---|
| ماشه | زمان اجرا: متن، دستور، رسانه، دکمه، رویداد یا زمانبندی | فرد /price نوشت |
| در چتها | محل اجرا: گفتوگوی خصوصی، خطاب به بات در گروه یا چتهای مشخص؛ با توجه به وضعیت کاربر | فقط گفتوگوی خصوصی |
| شرطها | بررسی بیشتر: برچسب، پارامتر، زمان یا تعداد پیام | فرد برچسب «پرداختشده» دارد |
| اقدامات | کار بات: پیام، تغییر برچسب، ثبت داده یا فراخوانی هوش مصنوعی | فرستادن فهرست قیمت |
ایجاد و ویرایش
ایجاد واکنش را بزنید یا واکنشی موجود را باز کنید. بالای ویرایشگر نام اجباری، شمارهٔ #N، توضیحات و گزینهٔ فعال قرار دارد. بخشهای ماشه / در چتها / شرطها / اقدامات در سمت چپاند، فرم در میانه و پیشنمایش پیام Telegram با بلوکها، دکمهها و منو در سمت راست است. در پایان ذخیره را بزنید.
پس از ذخیره، ویرایشگر تعداد اجراها، نمودار و رویدادهای اخیر را نیز نشان میدهد.
تاریخچهٔ تغییرات و بازیابی
در واکنش ذخیرهشده، Change history را باز کنید. ۲۰ تغییر آخر، زمان، نویسنده، منبع تغییر و تفاوتهای Before / After دیده میشوند. میتوانید وضعیت واکنش را به پیش از تغییر انتخابشده برگردانید: ابتدا تفاوتها را ببینید و سپس بازیابی را تأیید کنید.
بازیابی، ویرایشهای ذخیرهنشده را جایگزین میکند و خودش در تاریخچه ثبت میشود. فقط تنظیمات واکنش را برمیگرداند، نه پیامهایی را که قبلاً فرستاده شدهاند یا دادههایی را که تغییر کردهاند. اگر همکار دیگری پس از پیشنمایش واکنش را تغییر داده باشد، تفاوتها را دوباره بارگیری کنید.
ترتیب و اولویت
در نمای ترتیب دستی، بدون جستوجو، فیلتر یا پوشهٔ انتخابشده، میتوانید واکنشها را در فهرست جابهجا کنید. ترتیب، اولویت را تعیین میکند: برای هر رویداد، اولین واکنش مناسب اجرا میشود و بررسی متوقف میگردد. برای ادامهٔ بررسی و اجرای واکنشهای مناسب بعدی، اقدام واکنش بعدی (goto_next) را اضافه کنید.
جستوجو، فیلتر و گروهبندی
بالای فهرست میتوانید با نام یا شمارهٔ واکنش جستوجو کنید و این فیلترها را به کار ببرید:
- وضعیت: همه، فقط فعال یا فقط غیرفعال.
- ایجادشده از / ایجادشده تا: روزهای تقویمی در منطقهٔ زمانی شما؛ هر دو روز ابتدا و انتها شامل میشوند.
- ترتیب: دستی، تازهترینها اول یا قدیمیترینها اول.
- گروهبندی: بر اساس روز یا ماه ایجاد. گروهبندی فقط با ترتیب زمانی کار میکند. اگر آن را در ترتیب دستی روشن کنید، فهرست به «تازهترینها اول» میرود. ترتیب زمانی انتخابشده حفظ میشود و بازگشت به ترتیب دستی، گروهبندی را خاموش میکند.
فیلترها روی همهٔ واکنشها اعمال میشوند، نه فقط صفحهٔ باز. میتوانید آنها را با جستوجو و پوشهها ترکیب کنید. شمارنده تعداد نتیجهها را نشان میدهد. وضعیت فیلترها در نشانی صفحه میماند؛ میتوانید صفحه را تازه کنید، پیوندش را بفرستید یا با دکمهٔ «بازگشت» به آن برگردید. بازنشانی فیلترها جستوجو، فیلتر، ترتیب و گروهبندی را پاک میکند، اما پوشهٔ انتخابشده را نگه میدارد.
فیلتر و مرتبسازی فقط نمایش فهرست را تغییر میدهند؛ ترتیب واقعی بررسی واکنشها توسط بات ثابت میماند.
فعال و غیرفعال کردن
گزینهٔ روی ردیف فهرست یا فعال در ویرایشگر، واکنش را بدون حذف کردن روشن یا خاموش میکند. واکنش خاموش هنگام بررسی نادیده گرفته میشود.
تکثیر و حذف
روی هر ردیف، تکثیر یک کپی میسازد و حذف واکنش را پاک میکند. تکثیر برای ساخت قانون مشابه با چند تغییر کوچک مفید است.
درونریزی و خروجی گرفتن
از خروجی گرفتن در ویرایشگر میتوانید واکنش را به JSON تبدیل کنید و با درونریزی واکنش در فهرست، آن را دوباره وارد کنید. به این ترتیب واکنش را میان باتها جابهجا میکنید یا نسخهای بیرون از پلتفرم نگه میدارید.
ارسال همگانی واکنش
دکمهٔ همهرسانی روی ردیف واکنش، با نماد ارسال، واکنش را برای همهٔ مشترکان فعال بات اجرا میکند. برای اطلاعیهها مناسب است و میتوانید مخاطبان را با برچسبها محدود کنید. ارسال همگانی را ببینید.
زنجیرهها و گفتوگوها
برای مثال، واکنش اول فهرست کالاها را نشان میدهد، دکمه واکنش دوم را با کارت کالا باز میکند و واکنش دوم نشانی تحویل را میپرسد. راههای پیوند دادن واکنشها:
- واکنش زنجیری (
chain): در میانهٔ اجرا واکنش دیگری را راه میاندازد. - واکنش بعدی (
goto_next): بررسی را به واکنش مناسب بعدی در فهرست میسپارد. - گامهای گفتوگو: بلوک پیام میتواند منتظر پاسخ بماند، پاسخ را بررسی کند و مسیر را موقتاً نگه دارد. پیامها و دکمهها.
- شاخهٔ «در غیر این صورت»: اگر شرطهای واکنش برقرار نباشند، واکنش دیگری را از بخش «شرطها» اجرا کنید.
- انتخاب گام بعدی (
branch_result): نتیجهٔ جستوجوی خالی، تکی، چندتایی یا ناقص را جداگانه مدیریت کنید. - انتخاب گام بر اساس مقدار (
branch_value): مثلاً برایupdatedثبت درخواست را تأیید کنید و برایconflictبخواهید وضعیت دوباره خوانده شود. - نتیجهٔ اقدام: اگر اقدام پشتیبانی کند، برای موفقیت، تعارض، نبود رکورد یا خطا به واکنش جداگانه بروید. انتخاب شاخهها.
- Call block (
call_block): ورودیها را به یک محاسبهٔ مشترک بدهید و خروجیهای تعریفشده را در واکنش فعلی بگیرید. کتابخانهٔ بلوکها و نسخهها.
برای دادهها میتوانید مسیر جستجو در مجموعه → انتخاب گام بعدی → دکمهها → یافتن رکوردهای مرتبط را بسازید. اگر فهرست از سرویس بیرونی آمده است، از پردازش فهرست → گروهها و مجموعها استفاده کنید. برای نتیجهٔ هر اقدام نامی تعیین کنید و همان را در اقدام بعدی انتخاب کنید.
تمرینهای کاربردی هر دو مسیر را با نمونهٔ کلاس و درخواست نشان میدهند.
هنگام تنظیم از دادههای گامهای قبلی انتخاب کنید تا لازم نباشد مسیرها را حفظ کنید. پیش از ذخیره، پیشنویس را با دادهٔ آزمایشی بررسی کنید و شاخهها و پیامهای احتمالی را ببینید. پس از ذخیره، مسیر کاربر را جداگانه در بات و کانال متصل امتحان کنید؛ آن آزمایش اقدامهای واقعی را اجرا میکند.
مراحل بعدی
- ماشهها: انواع رویداد شروعکننده.
- شرایط و چتها: فیلترها و محل اجرا.
- اقدامات: فهرست اقدامها.
- پیامها و دکمهها: ساخت پاسخ.