הודעות וכפתורים
בנו תשובה מטקסט, תמונות וכפתורים, שאלו שאלות ושמרו את תשובות המשתמש.
בעמוד זה
כדי שהבוט ישלח טקסט, תמונה וכפתור ״בחר״, הוסיפו את הפעולה שלח הודעה. התשובה מורכבת מחלקים נפרדים שנקראים בלוקים: למשל תמונת מוצר ואז תיאור עם כפתורים מתחתיו. כפתורים מתחת להודעה נקראים גם כפתורי inline.
באותה פעולה אפשר לשאול שאלה ולהמתין לתשובה, למשל לבקש מספר טלפון ולשמור אותו בכרטיס הלקוח. בהמשך מוסברים הבלוקים, הכפתורים ושלבי השאלות.
בלוקים של הודעה
לחצו הוסף בלוק ובחרו מה לשלוח. אפשר לשלב טקסט פתיחה, תמונה וקובץ עם תוכנית השיעור:
- טקסט: טקסט מעוצב עד 4096 תווים, עם תחליפים וכפתורים.
- תמונה: תמונה עם כיתוב.
- קובץ: מסמך עם כיתוב.
- הודעה קולית: קובץ OGG/OPUS, MP3 או M4A עד 50 MB, ש־Telegram מציגה כהודעה קולית (
sendVoice). - GIF: אנימציה או MP4 ללא קול, עד 50 MB (
sendAnimation). - וידאו עגול: MP4 ריבועי עד 60 שניות (
sendVideoNote), ללא כיתוב. בכל שליחה הקובץ מספריית המדיה מועלה מחדש: Telegram אינה מקבלת ב־sendVoice,sendAnimationאוsendVideoNoteמזההfile_idשהושג בדרך אחרת. - קרוסלה: 2 עד 10 כרטיסים, כל אחד עם תמונה, כיתוב וכפתורים משלו. ב־Telegram עוברים בין הכרטיסים בלחצני ״‹ ›״ בתוך הודעה אחת באמצעות
editMessageMediaרק אם לכל התמונות ישfile_idמתאים – כזה שהוגדר בכרטיס או התקבל לקובץ מספריית המדיה. אם לא הושג מזהה מתאים אפילו לתמונה אחת, כל הכרטיסים יישלחו כהודעות תמונה נפרדות. כך הם נשלחים גם בערוצים אחרים כמו VK. הכיתוב והכפתורים של כל כרטיס נשמרים. - השהיה: עצירה למספר שניות לפני הבלוק הבא.
- בינה מלאכותית: תשובה שהמודל יוצר לפי הנחיה.
- תגובה: הפעלת תגובה אחרת, עם אפשרות להמתין לסיום העיבוד שלה.
בלוקי קול, GIF, וידאו עגול וקרוסלה פועלים בתגובות כמו שאר הבלוקים ונכללים בשליחה ההמונית המהירה של תגובה; ראו שליחה המונית.
אפשר לגרור בלוקים כדי לשנות סדר. בחרו מצב תצוגה לפי הסדר או באקראי לתשובות מגוונות. אפשר להשאיר את התפריט הראשי של הבוט ללא שינוי, לקבוע חדש או להסתיר אותו.
אפשרויות הבלוק
לבלוקי טקסט ומדיה יש אפשרויות נעיצה, ללא צליל, הגנה מהעברה, ספוילר, ללא תצוגה מקדימה לקישורים ומחיקה אוטומטית אחרי N שניות.
כפתורי Inline
בבלוק מגדירים טקסט כפתור וסוג כפתור:
- טקסט: שולח את הכיתוב כתשובה של המשתמש. ב־Telegram וב־VK זו מקלדת תשובה; לחיצה יכולה לענות לשאלה או להפעיל תגובה לפי הטקסט. ב־WhatsApp, Instagram, Messenger ובווידג'ט האתר זהו כפתור תשובה ללא מקלדת קבועה.
- קישור: פותח URL.
- אפליקציית Web: פותח Telegram Mini App. ראו Mini App.
- תגובה: לחיצה מפעילה תגובה אחרת.
- Inline query: מוסיף ״@bot query״ לשדה הכתיבה בצ'אט הנוכחי או מבקש לבחור צ'אט אחר (
switch_inline_query/switch_inline_query_current_chat). זמין רק ב־Telegram לאחר הפעלת מצב inline ב־@BotFather באמצעות/setinline. GetMyBot אינו עונה לשאילתות כאלה (answerInlineQueryלא ממומש), ולכן הכפתור רק מכין את השאילתה ואינו מבצע חיפוש. - Prefilled text: כפתור־קישור ל־
https://t.me/<bot>?text=…שפותח את הצ'אט עם טקסט בשדה הכתיבה, בלי לשלוח דבר (prefill). - Payment link: פותח כתובת תשלום חובה. את התשלום יוצרת פעולת ״צור תשלום״; זהו מעבר לדף תשלום חיצוני, לא חשבון Telegram מקורי.
- התראה: מציג טקסט בלחיצה בלי להפעיל תגובה או להעביר נתוני כפתור שמורים (Carry). ב־Telegram זו התראה קצרה או חלונית עד 200 תווים; ב־VK פס הודעה קצר עד 90 תווים, ללא חלונית.
טקסט או טקסט מוכן
| משימה | סוג הכפתור והגדרתו | תוצאת הלחיצה |
|---|---|---|
| לבחור ״כן״ בשאלון | ״טקסט״ עם הכיתוב ״כן״; ההודעה צריכה להמתין לתשובה | התשובה ״כן״ עוברת לשלב הדיאלוג |
| להכין פנייה לבוט | ״Prefilled text״ עם הכיתוב ״כתוב״ והטקסט ״אני רוצה להזמין״ | הטקסט מופיע כטיוטה בשדה הכתיבה; המשתמש יכול לערוך ולשלוח בעצמו |
הכיתוב על הכפתור והטקסט המוכן הם שדות שונים. טקסט מוכן אינו שולח הודעה או מפעיל תגובה מעצמו.
לחיצה על כפתור תגובה מועברת לבוט כאירוע נפרד שנקרא טכנית callback. כפתורי Inline query ו־Prefilled text פועלים בתוך Telegram ואינם יוצרים אירוע כזה. לכן הם לא תומכים ב־answerCallbackQuery או בהעברת Carry.
סמל וצבע לכפתור
אפשר להציג לפני טקסט הכפתור אימוג'י מיוחד. הזינו את המזהה שלו בשדה Premium emoji ID (icon_custom_emoji_id) כמספר שלם חיובי בן 64 ביט. למשל 007 נחשב 7. אותיות, אפס, מספר שלילי או מספר גדול מדי יידחו, והכפתור יישמר בלי סמל.
Telegram מציגה את הסמל רק לבוט עם הזכויות הדרושות: שם נוסף דרך Fragment, או מנוי Telegram Premium לבעלים בעת שליחה ישירה לצ'אט פרטי או לקבוצה. אחרת Telegram מתעלמת מהסמל ואינה מחליפה אותו באימוג'י רגיל.
סגנון כפתור מגדיר צבע: רגיל ללא צבע, ראשי כחול, הצלחה ירוק, מסוכן אדום. שם השדה הטכני הוא style.
האפשרות חד-פעמי (שרוף לאחר לחיצה) (single_use) מאפשרת להשתמש בנתוני הכפתור השמורים רק פעם אחת, למשל לאישור בחירה. שינוי הכיתוב ומחיקת ההודעה מוגדרים בנפרד בהתנהגות בלחיצה.
דגלי כפתור
דגל הוא אפשרות שמפעילים או מכבים בסימון:
- בשורה חדשה: מעביר את הכפתור לשורה הבאה.
- מתח לכל הרוחב: מציב אותו בשורה משלו; גם הכפתור הבא מתחיל שורה חדשה.
תרשים מקורב; הסוגריים המרובעים מציינים כפתורים:
שורה אחת: [קטלוג] [עזרה]
שורה חדשה: [קטלוג]
[עזרה]
רוחב מלא: [ עזרה ]
שורות וצבעים זמינים ב־Telegram וב־VK. סידור הכפתורים בשורות נשמר בפתיחה חוזרת ובעריכה. אימוג'י מיוחד של Telegram זמין רק בחיבור תואם. אין מתג ״פתח בתוך Telegram״ שמשנה את ההתנהגות הזאת: Bot API אינו מאפשר לשלוט בה באמצעות דגל כזה.
מגבלות ערוצים
בחרו חיבור לבלוק או לכפתור בודד. בבחירה ״כל הערוצים״ העורך משתמש ביכולות המשותפות; אי אפשר לשמור סוג שאינו נתמך:
- Telegram: URL, Mini App, תגובה, התראה/חלונית, שורות, צבעים ואימוג'י מותאם אם לבוט יש הרשאה.
- VK: URL, תגובה, snackbar, שורות וצבעים. VK Mini App ו־VK Pay זמינים רק עם חיבור VK תואם.
- WhatsApp: כפתור URL אחד מסוג CTA, ללא כפתורים אחרים באותה הודעה. עד 3 כפתורי תשובה רגילים; 4 עד 10 מוצגים כרשימה. כיתוב עד 20 תווים. אין שורות, צבעים, Mini App או התראות.
- Instagram / Messenger: המתאם הנוכחי שולח רק כפתורי תשובה (quick replies), כיתוב עד 20 תווים. אין תמיכה ב־URL, Mini App, התראות, שורות או צבעים.
- ווידג'ט אתר: URL וכפתורי תשובה, בלי שורות, צבעים או התראות.
- Email: קישורים, כולל קישור לתשלום; אין כפתורי תשובה או התראות.
בכפתורים שנוצרים מרשימה אפשר לציין מספר עמודות רק לערוצים שתומכים בשורות. בערוצים אחרים הערוץ עצמו בוחר את המיקום. גבולות מספר הכפתורים ואורך הכיתוב נבדקים בזמן השליחה.
התנהגות בעת לחיצה
לכפתורים שמעבירים לחיצה לבוט אפשר להחליף את ההודעה בטקסט או בתוכן תגובה אחרת, למחוק אותה, להוסיף תווית או לשמור פרמטר, אם הערוץ תומך. שינוי הכיתוב של הכפתור עצמו לאחר לחיצה זמין רק ב־Telegram, למשל ״הירשם״ ל״נבחר״. גם אם VK תומכת בעריכת הודעה, היא לא תומכת בשינוי כיתוב הכפתור.
Telegram ממתינה לאישור לחיצה מהבוט דרך answerCallbackQuery. לרוב GetMyBot שולח אותו אוטומטית ומסיר את מחוון הטעינה. דלג על answerCallbackQuery מבטל את האישור.
בשדה Text on press (notification) של כפתור תגובה אפשר לכתוב אישור קצר כגון ״השיעור נבחר״, עד 200 תווים ב־Telegram ועד 90 ב־VK; תחליפים פועלים. Telegram מציגה אותו לרגע מעל הצ'אט. Show as a popup (alert) זמין רק ב־Telegram ופותח חלונית באמצעות answerCallbackQuery עם show_alert. אם הטקסט ריק, הבוט רק מסיר את מחוון הטעינה. כאשר מדלגים על answerCallbackQuery, לא נשלחים הטקסט או החלונית.
נתוני כפתור (Carry)
Carry מאפשר לכפתור לזכור לאיזה פריט הוא שייך. אם גם למעיל וגם לשמלה יש כפתור ״קנה״, שמרו למעיל product_id=101 ולשמלה product_id=102. בלחיצה על השמלה, התגובה הבאה תקבל {{ctx.product_id}} בערך 102.
ההגדרה בעורך נקראת נתונים שנשלחים בלחיצה. המפתח קובע את שם הערך, והערך יכול להיות מספר, טקסט או תחליף. הבוט שומר אותו בעת שליחת ההודעה, ובלחיצה מכניס אותו ל־ctx של התגובה. לכל כפתור ערכים נפרדים.
משך תוקף נתוני הכפתור, בשניות (ttl_seconds, TTL) קובע מתי הנתונים יפוגו: 3600 היא שעה, ו־0 בוחר בברירת המחדל של 30 יום. אחרי הפקיעה הנתונים אינם זמינים. חד-פעמי (שרוף לאחר לחיצה) (single_use) מוחק אותם אחרי הלחיצה הראשונה. מחיר שנשמר אינו מתעדכן כשמשנים את הקטלוג; לפני תשלום בדקו את המחיר הנוכחי לפי מזהה מוצר. ראו כפתורים דינמיים ופרמטרים.
כפתורים דינמיים
אם המוצרים או השיעורים כבר נמצאים ברשימה, אל תיצרו כפתור ידנית לכל אחד. הבלוק כפתורים דינמיים מרשימה יוצר כפתור לכל פריט. ציינו היכן הרשימה ב־ctx, כינוי לפריט, מספר כפתורים בשורה ותבנית טקסט. למשל {{item.name}} מכניס את שם המוצר הנוכחי. ראו כפתורים דינמיים ופרמטרים.
אימוג'י מיוחד בטקסט
כפתור העיצוב אימוג'י מיוחד בבלוק טקסט מוסיף <tg-emoji emoji-id="…">🙂</tg-emoji>. משתמשי Telegram Premium יראו את האימוג'י המותאם, ואחרים את האימוג'י החלופי שבתגית. הוא פועל גם בפורמט HTML וגם ב־Markdown. מזהה האימוג'י הוא מספר של עד 32 ספרות; אפשר לקבלו מ־getCustomEmojiStickers או מהעברת הודעה עם האימוג'י לבוט כמו @idstickerbot.
קישור לבוט וטקסט מוכן
הקישור t.me/<bot>?start=<parameter> מפעיל ב־Telegram את /start <parameter>. אי אפשר לפתוח כך צ'אט עם פרמטר בלי פקודת /start. בחרו באפשרות המתאימה:
- /start שקט: בתגובה לטריגר פקודה /start עם תג בקישור ההפעלה הרצוי, אפשר להשאיר את פעולת ״שלח הודעה״ ללא בלוקים. לא תופיע תשובה על
/startעצמו, אבל ערך התג כבר זמין בהקשר האירוע לתנאים ולפעולות האחרות באותה תגובה. - Prefilled text: הקישור
https://t.me/<bot>?text=<text>, בכפתור ״Prefilled text״ או בכפתור קישור רגיל, פותח את הצ'אט עם טקסט בשדה הכתיבה בלי לשלוח אותו./startאינו מופעל; המשתמש שולח בעצמו. - הודעה אוטומטית ״בשם המשתמש״ בעת פתיחה: Bot API אינו מאפשר זאת; בוט אינו יכול לשלוח הודעה בשם אדם. החלופה הקרובה היא deep-link
?start=ותגובה ששולחת את הטקסט הדרוש בשם הבוט.
תשובה צפויה (שלבי דיאלוג)
בלוק טקסט יכול להמתין לתשובת המשתמש. אז ההודעה הופכת לשלב בדיאלוג, וההמשך נעצר עד לתשובה. כמה שלבים ברצף יוצרים שאלון או אשף בתוך הצ'אט.
סוג התוכן הצפוי
אפשר להמתין לטקסט, בחירה מבין אפשרויות, תמונה, וידאו, וידאו עגול, אודיו, מסמך, הודעה קולית, מיקום, איש קשר, לוח שנה או קובייה. אם המשתמש שולח סוג אחר, התשובה אינה מתקבלת בשלב הזה.
בדיקת טקסט
לתשובת טקסט אפשר להפעיל בדיקת טלפון, דוא"ל, קישור, תאריך, שעה או התאמה לנוסחה. למשל, אם מחכים לטלפון, טקסט אחר יידחה ותוצג הודעת שגיאה. הבדיקה משתמשת בנוסחה המורחבת: היא מחזירה טקסט ריק להצלחה וטקסט שגיאה לדחייה.
שמירת תשובה
אפשר לשמור את תשובת המשתמש בפרמטר. אחר כך היא זמינה בתחליף {{param.key}} ובתנאים. כך שלבי הדיאלוג בונים פרופיל לקוח קטן.
שגיאות, תזכורת וזמן קצוב
- הודעה במקרה של שגיאת בדיקה: מה להציג אם התשובה לא עברה בדיקה.
- תזכורת: מה לשלוח אם המשתמש אינו עונה.
- ביטול המתנה אחרי זמן קצוב: מתי להפסיק להמתין; אפשר להפעיל תגובה כשהזמן נגמר, למשל כדי לסיים שאלון בעדינות. תגובה זו מופיעה בקישורים כ״זמן קצוב להמתנה״, והתגובה לתשובה עצמה כ״תשובה צפויה״.
יציאה משלב באמצעות פקודה
/cancel או המילה הרוסית ״отмена״ מבטלים את ההמתנה ומשיבים ״Отменено.״, או מפעילים תגובת ביטול אם הוגדרה. פקודות אחרות נחשבות כברירת מחדל לתשובה ונבדקות כמו טקסט רגיל, כך שהמשתמש יכול להישאר בשלב עד שיענה. אם מפעילים פקודות בוט (למשל /start) מפסיקות המתנה (escape_on_command), כל פקודה, למשל /start באמצע שאלון, מבטלת את ההמתנה בלי הודעה ומבוצעת כרגיל.
תחליפים
כפתור החלפות מכניס נתוני שולח ({{first_name}}, {{username}}, {{user_id}}), אירוע ({{text}}, {{chat_id}}, {{datetime}}) ופרמטרים ({{param.key}}). הרשימה המלאה בתחליפים ונוסחאות.
כפתור התפריט של הבוט
הפעולה Menu button בוחרת תפריט רגיל, רשימת פקודות או כפתור Mini App עם טקסט ו־URL. אפשר להחיל אותה על הצ'אט הנוכחי או כהגדרת ברירת מחדל של הבוט, למשל Mini App אישית ללקוח מסוים. הזמינות תלויה ביכולות הערוץ.
המשך מכאן
- תחליפים ונוסחאות: ערכים בטקסט ובכפתורים.
- פעולות: פעולות נוספות של תגובה.
- Mini App: כפתור אפליקציית Web.