ماشه‌ها

ماشه رویدادی است که واکنش به آن پاسخ می‌دهد. در بخش ماشه ویرایشگر می‌توان چندین نوع را همزمان فعال کرد: آن‌ها با «یا» ترکیب می‌شوند — واکنش فعال می‌شود اگر هر کدام از ماشه‌های فعال‌شده برقرار باشد. محدودیت‌های اضافی (برچسب‌ها، پارامترها، چت‌ها) به‌طور جداگانه در شرایط تعریف می‌شوند.

پیام متنی

در صورت دریافت متن یا زیرنویس رسانه فعال می‌شود. در فیلد «چه چیزی را جستجو کنیم» حالت انتخاب می‌شود:

  • کلمات کلیدی — لیستی از کلمات/عبارات. پارامتر «تطابق»: شامل می‌شود، تطابق دقیق، شروع می‌شود با، عبارت منظم؛ به اضافه چک‌باکس «تمایز حروف بزرگ و کوچک».
  • لینک — پیام حاوی URL است.
  • ایمیل — حاوی آدرس ایمیل است.
  • اشاره (@username) — حاوی اشاره است.
  • هر متنی — هر پیام متنی.

دستور

در صورت دریافت slash-دستورات فعال می‌شود. در فیلد «دستورات (بدون «/»)» نام‌ها را وارد کنید، مثلاً help، menu. بات به /help و /menu پاسخ می‌دهد.

دستور /start

یک ماشه جداگانه برای /start. فیلد Payload پارامتر deep-link (/start <payload>) را می‌گیرد؛ مقدار خالی — هر /start. این پایه لینک‌های ارجاعی و کمپین‌هاست.

فشار دکمه inline (callback)

در صورت فشار دکمه inline فعال می‌شود. فیلد «داده دکمه (callback_data)» و «تطابق» (دقیق، شروع می‌شود با، شامل می‌شود، عبارت منظم) تعیین می‌کنند کدام دکمه‌ها ضبط شوند.

رسانه

در صورت دریافت پیوست‌های انواع انتخاب‌شده فعال می‌شود: عکس، ویدیو، ویدیوپیام، سند، صوت، صوت‌پیام، GIF، استیکر، تاس، بازی، نظرسنجی، مخاطب، موقعیت مکانی، مکان، آلبوم.

رویداد سیستمی

در رویدادهای چت فعال می‌شود: پیوستن از طریق لینک، اضافه شدن به چت، ترک چت، حذف از چت، تغییر وضعیت، درخواست عضویت، واکنش به پیام، شمارنده واکنش‌ها. برای خوش‌آمدگویی، مدیریت و پذیرش درخواست‌ها مفید است.

پاسخ و فوروارد

  • پاسخ (reply) به پیام — فعال می‌شود وقتی پیام پاسخ به پیام دیگری است.
  • پیام فوروارد شده — در صورت دریافت forward فعال می‌شود.

هر N-امین پیام

در صورت دریافت N-امین پیام کاربر فعال می‌شود (فیلد «هر پیام شماره»). برای یادآوری‌های دوره‌ای یا ضد هرزنامه مناسب است.

طبق برنامه‌ریزی (تاریخ‌ها)

در زمان‌های مشخص‌شده فعال می‌شود (لیست تاریخ‌ها). واکنش برنامه‌ریزی‌شده با رسیدن موعد برای مشترکان فعال ارسال می‌شود — ببینید همه‌رسانی‌ها.

درخواست وب ورودی (webhook)

در صورت دریافت درخواست HTTP از خارج فعال می‌شود. مسیر (URL کامل از آدرس بات و مسیر تشکیل می‌شود)، توکن مخفی (برای حفاظت) و روش (POST / GET / PUT / ANY) تعریف می‌شوند. داده‌های درخواست وارد زمینه اجرا می‌شوند و از طریق {{ctx.field}} در اقدامات در دسترس هستند. جزئیات بیشتر — درخواست‌های وب و webhook‌ها.

مراحل بعدی