תגובות: יסודות
איך מלמדים את הבוט להגיב לפקודה, ללחיצה על כפתור או לאירוע אחר, ואיך מסדרים ומקשרים תגובות.
בעמוד זה
תגובה היא כלל פעולה אחד של הבוט. למשל: ״אם אדם כותב /price, שלח מחירון״, או ״לאחר תשלום, הוסף את התווית ‘שילם’ ותן גישה״.
את האירוע, התנאים והפעולות מגדירים באזור תגובות. הבוט בודק את הכללים מלמעלה למטה ומבצע את הראשון שמתאים. לכן כדאי למקם כלל ממוקד מעל כלל כללי שמגיב לכל הודעה.
ממה מורכבת תגובה
כדי לשלוח מחירון, די לבחור בפקודה /price ולהוסיף הודעה עם מחירים. שאר ההגדרות נחוצות אם הכלל מיועד לאנשים או לצ'אטים מסוימים. בעורך יש ארבע לשוניות:
| לשונית | מה מגדירים בה | דוגמה |
|---|---|---|
| טריגר | מתי להפעיל: טקסט, פקודה, מדיה, כפתור, אירוע או מועד | אדם כתב /price |
| בצ'אטים | היכן התגובה פועלת: שיחה פרטית, פנייה לבוט בקבוצה או צ'אטים מסוימים; אפשר להתחשב במצב המשתמש | רק בצ'אט פרטי |
| תנאים | מה עוד צריך לבדוק: תוויות, פרמטרים, זמן או מספר הודעות | לאדם יש תווית ״שילם״ |
| פעולות | מה הבוט עושה: שולח הודעה, משנה תוויות, שומר נתונים או מפעיל AI | שולח מחירון |
יצירה ועריכה
לחצו צור תגובה או פתחו תגובה קיימת. בראש העורך הזינו שם חובה, מספר #N ותיאור, והגדירו את המתג פעיל. משמאל בוחרים טריגר / בצ'אטים / תנאים / פעולות, במרכז ממלאים את הטופס, ומימין רואים תצוגה מקדימה של הודעת Telegram עם הבלוקים, הכפתורים והתפריט. לסיום לחצו שמור.
בתגובה שמורה מופיעים מספר ההפעלות, תרשים והאירועים האחרונים.
היסטוריית שינויים ושחזור
בתגובה שמורה פתחו Change history. מוצגים 20 השינויים האחרונים, כולל זמן, עורך, מקור השינוי וההבדלים בין ״Before / After״. אפשר לשחזר את המצב שהיה לפני שינוי מסוים: בדקו תחילה את ההבדלים ואשרו את השחזור.
השחזור מחליף עריכות שלא נשמרו ונרשם בעצמו בהיסטוריה. הוא משחזר את הגדרות התגובה, אך אינו מבטל הודעות שכבר נשלחו או נתונים שכבר השתנו. אם מישהו אחר ערך את התגובה בזמן הבדיקה, רעננו את ההשוואה. הסבר ותרגול.
סדר ועדיפות
אפשר לגרור תגובות לסדר ידני כאשר החיפוש והמסננים כבויים ולא נבחרה תיקייה. הסדר קובע את העדיפות: לאירוע אחד תתבצע התגובה המתאימה הראשונה, ואז הבדיקה תיעצר. כדי להמשיך ולבדוק תגובות מתאימות נוספות, הוסיפו את הפעולה תגובה הבאה (goto_next).
חיפוש, מסננים וקיבוץ
מעל הרשימה אפשר לחפש לפי שם ומספר, ולהפעיל מסננים:
- מצב: כל התגובות, רק פעילות או רק לא פעילות.
- נוצרה מ־ / עד: ימים קלנדריים לפי אזור הזמן שלכם, כולל שני התאריכים.
- סדר: ידני (סדר הבדיקה של הבוט), החדשות תחילה או הישנות תחילה.
- קיבוץ: לפי יום או חודש יצירה, רק במיון לפי תאריך. הפעלת קיבוץ בסדר ידני מעבירה את התצוגה ל״החדשות תחילה״. מיון קיים לפי תאריך נשמר; חזרה לסדר ידני מבטלת את הקיבוץ.
המסננים חלים על כל התגובות, לא רק על הדף הנוכחי, ופועלים יחד עם החיפוש והתיקיות. המונה מציג כמה תגובות נמצאו. הגדרות המסננים נשמרות בכתובת הדף, ולכן אפשר לרענן, לשתף קישור או לחזור עם כפתור ״אחורה״. איפוס מסננים מנקה חיפוש, מסננים, מיון וקיבוץ, אך משאיר את התיקייה שנבחרה.
המסננים והמיון משנים את תצוגת הרשימה בלבד. סדר הבדיקה של הבוט אינו משתנה.
הפעלה וכיבוי
המתג בשורת הרשימה או פעיל בעורך מפעיל ומכבה תגובה בלי למחוק אותה. הבוט מדלג על תגובות כבויות.
שכפול ומחיקה
בשורת התגובה נמצאים שכפל ליצירת עותק ומחק. שכפול מתאים כשרוצים כלל דומה עם שינוי קטן.
ייבוא וייצוא
אפשר להוריד תגובה כקובץ JSON באמצעות ייצוא בעורך, ואז להעלות אותה דרך ייבוא תגובה ברשימה. כך אפשר להעביר תגובות בין בוטים ולשמור גרסאות מחוץ למערכת.
שליחה המונית של תגובה
הכפתור שליחה… עם סמל השליחה בשורת התגובה מפעיל אותה עבור כל המנויים הפעילים של הבוט. אפשר לצמצם את הקהל לפי תוויות. ראו שליחה המונית.
שרשראות ודיאלוגים
למשל, התגובה הראשונה מציגה קטלוג, כפתור מפעיל תגובה שנייה עם פרטי מוצר, וזו מבקשת כתובת למשלוח. אפשר לקשר תגובות בדרכים שונות:
- תגובת שרשרת (
chain): מפעילה תגובה אחרת תוך כדי ביצוע התגובה הנוכחית. - תגובה הבאה (
goto_next): ממשיכה לתגובה המתאימה הבאה ברשימה. - שלבי דיאלוג: בלוק הודעה יכול להמתין לתשובת המשתמש ולבדוק את סוגה, ובינתיים לעצור את התהליך. ראו הודעות וכפתורים.
- ענף ״אחרת״: אם תנאי התגובה לא התקיימו, אפשר להפעיל תגובה אחרת מתוך תנאים.
- בחירת השלב הבא (
branch_result): מטפלת בתוצאת חיפוש ריקה, יחידה, מרובה או לא מלאה. - בחירת שלב לפי ערך (
branch_value): למשל, לאשר הזמנה ב־updatedאו להציע לבדוק שוב את מצבה ב־conflict. - תוצאת פעולה: לעבור לתגובה נפרדת אחרי הצלחה, התנגשות, היעדר רשומה או שגיאה, אם הפעולה תומכת בכך. ראו מסלולי תוצאה.
- Call block (
call_block): מעבירה נתוני קלט לחישוב משותף ומקבלת את הפלטים שהוגדרו בתגובה הנוכחית. ראו ספריית בלוקים וגרסאות.
לעבודה עם נתונים אפשר ליצור רצף חיפוש באוסף → בחירת השלב הבא → כפתורים → מציאת רשומות קשורות. אם הרשימה הגיעה משירות חיצוני, השתמשו בעיבוד רשימה → קבוצות וסיכומים. תנו שם לתוצאה של כל פעולה ובחרו אותה בפעולה הבאה. תרגילים מעשיים מדגימים את שני הרצפים עם שיעורים ובקשות.
בזמן ההגדרה השתמשו בבחירת נתונים מצעדים קודמים, במקום לזכור נתיבי שדות. לפני השמירה בדקו את הטיוטה על נתוני אימון והשוו ענפים והודעות צפויות. אחרי השמירה עברו גם את המסלול דרך הבוט והערוץ המחוברים, שבהם הפעולות מתבצעות בפועל.
המשך מכאן
- טריגרים: כל סוגי ההפעלה.
- תנאים וצ'אטים: מסננים ותחום פעולה.
- פעולות: הפעולות הזמינות.
- הודעות וכפתורים: יצירת תשובות.