טריגרים
טריגר הוא האירוע שאליו ריאקציה מגיבה. בסעיף טריגר בעורך ניתן להפעיל מספר סוגים בו-זמנית: הם מאוחדים לפי "או" — הריאקציה תופעל אם מתקיים כל אחד מהטריגרים המופעלים. הגבלות נוספות (תוויות, פרמטרים, צ'אטים) מוגדרות בנפרד בתנאים.
הודעת טקסט
מופעל על טקסט או כיתוב למדיה. בשדה "מה לחפש" בוחרים מצב:
- מילות מפתח — רשימת מילים/ביטויים. פרמטר "התאמה": מכיל, התאמה מדויקת, מתחיל ב-, ביטוי רגולרי; בנוסף תיבת סימון "תלוי רישיות".
- קישור — ההודעה מכילה URL.
- דוא"ל — מכילה כתובת דוא"ל.
- אזכור (@username) — מכילה אזכור.
- כל טקסט — כל הודעת טקסט.
פקודה
מופעל על פקודות slash. בשדה "פקודות (ללא '/')" פרטו שמות, לדוגמה help, menu. הבוט יגיב ל-/help ול-/menu.
פקודה /start
טריגר נפרד ל-/start. השדה Payload לוכד את פרמטר ה-deep-link (/start <payload>); ערך ריק — כל /start. זוהי הבסיס לקישורי הפניה וקמפיינים.
לחיצת כפתור inline (callback)
מופעל על לחיצת כפתור inline. השדה "נתוני כפתור (callback_data)" ו**"התאמה"** (מדויק, מתחיל ב-, מכיל, ביטוי רגולרי) קובעים אילו כפתורים ללכוד.
מדיה
מופעל על קבצים מסוגים נבחרים: תמונה, וידאו, וידאו עגול, מסמך, אודיו, קולי, GIF, מדבקה, קובייה, משחק, סקר, איש קשר, מיקום, מקום, אלבום.
אירוע מערכת
מופעל על אירועי צ'אט: הצטרף דרך קישור, נוסף לצ'אט, עזב צ'אט, הוסר מצ'אט, שינה סטטוס, בקשת הצטרפות, ריאקציה להודעה, מונה ריאקציות. שימושי לברכות, מודרציה וקבלת בקשות.
תשובה ומועבר
- תשובה (reply) להודעה — מופעל כאשר ההודעה היא תשובה להודעה אחרת.
- הודעה מועברת — מופעל על forwards.
כל הודעה ה-N
מופעל על כל הודעה ה-N של המשתמש (שדה "כל הודעה מספר"). מתאים לרמזים תקופתיים או אנטי-ספאם.
לפי לוח זמנים (תאריכים)
מופעל ברגעי הזמן שצוינו (רשימת תאריכים). ריאקציה מתוזמנת נשלחת למנויים פעילים עם הגעת המועד — ראו שידורים.
בקשת ווב נכנסת (webhook)
מופעל על בקשת HTTP מבחוץ. מוגדרים נתיב (ה-URL המלא נוצר מכתובת הבוט והנתיב), טוקן סודי (להגנה) ושיטה (POST / GET / PUT / ANY). נתוני הבקשה נכנסים להקשר הביצוע וזמינים בפעולות דרך {{ctx.שדה}}. מידע נוסף — בקשות ווב ו-webhooks.
המשך מכאן
- תנאים וצ'אטים — צמצמו את ההפעלה לפי קהל ומיקום.
- פעולות — מה הבוט עושה בתגובה.