اقدامات
اقدامات آن چیزی هستند که بات هنگام فعال شدن واکنش اجرا میکند. یک واکنش میتواند چندین اقدام داشته باشد که به ترتیب از بالا به پایین اجرا میشوند. با دکمه افزودن اقدام در بخش اقدامات ویرایشگر اضافه میشوند. اقدامات از طریق زمینه اجرا (ctx) و پارامترهای کاربر داده تبادل میکنند — ببینید جایگزینیها و فرمولها.
پیامها و پاسخها
- ارسال پیام — اقدام اصلی: پاسخ را از بلوکها (متن، عکس، فایل، تأخیر، هوش مصنوعی، فراخوانی واکنش) میسازد، دکمههای inline، منو و مراحل مکالمه اضافه میکند. جزئیات — پیامها و دکمهها.
- ذخیره پیام — متن پیام ورودی را در پارامتر کاربر مینویسد.
- فوروارد — پیام ورودی را به چتهای مشخصشده فوروارد میکند (با شناسه موضوع اختیاری).
- اعلان — اعلانی با دادههای کاربر، چت و متن به چتهای سرویس ارسال میکند.
کاربر: برچسبها و پارامترها
- تغییر برچسبها — برچسبهایی به مشترک اضافه یا از او حذف میکند.
- تغییر پارامترها — مقادیر پارامترهای کاربر را تعیین، حذف یا افزایش میدهد.
مدیریت
- حذف دریافتی — پیام ورودی را حذف میکند (به صورت اختیاری — همه پیامهای کاربر، با تأخیر).
- حذف ارسالشده — پیامهای بات را حذف میکند (این واکنش یا همه در چت، با تأخیر).
- تغییر دسترسیها — بیصدا کردن / برداشتن بیصدا / مسدود کردن / رفع مسدودی / محدود کردن دسترسیها عضو، موقت یا دائمی؛ برای محدودیت، دسترسیهای خاص انتخاب میشوند.
- واکنش مهم (رنگ) — مکالمه را برای اپراتور با رنگ علامتگذاری میکند.
دادهها و مجموعهها
- ایجاد رکورد — یک ردیف به مجموعه اضافه میکند؛ با «کلید بیتکراری» به عنوان 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 و اقدام درخواست وب در دسترس است.
مراحل بعدی
- پیامها و دکمهها — سازنده پاسخها و مکالمات.
- جایگزینیها و فرمولها — متغیرها در متنها و منطق.