Telegram Mini App — מדריך שלב אחר שלב

מה זה?#

Telegram Mini App מאפשר ללקוחות שלכם לפתוח את תפריט המסעדה הדיגיטלי ישירות בתוך Telegram — ללא התקנת אפליקציות וללא מעבר לדפדפן. התפריט נראה כחלק טבעי של Telegram: מתאים את עצמו לנושא המשתמש, תומך בכפתור "חזרה" ובמחוות.

יתרונות#

• 📱 בתוך Telegram — הלקוח לא צריך לעבור לדפדפן
• 🎨 מראה טבעי — צבעים, גופנים ונושא מתאימים את עצמם ל-Telegram
• 🔗 Deep Links — קישור ישיר לתפריט של מסעדה ספציפית
• 🌍 שפה אוטומטית — השפה נלקחת מהגדרות Telegram של המשתמש
• 🍪 ללא cookies — באנר cookie לא מוצג בתוך Telegram

התחלה מהירה#

שלב 1 — צרו בוט#

פתחו את @BotFather ב-Telegram ושלחו:

/newbot

1. הזינו שם בוט (למשל, Cenaly Menu Bot)
2. הזינו שם משתמש (למשל, MeniMenuBot) — חייב להסתיים ב-Bot
3. שמרו את Bot Token שהתקבל (פורמט: 123456789:ABCdefGHI...)

למה צריך Bot Token?#

Bot Token הוא מפתח סודי לניהול תכנותי של הבוט דרך Telegram Bot API. להגדרת Mini App בסיסית (שלבים 2–4) הוא לא נדרש — הכל נעשה דרך BotFather. אבל הוא יידרש אם תרצו:

• לשלוח הודעות ללקוחות — התראות על מצב הזמנה, מבצעים, הודעות ברוכים הבאים
• להוסיף כפתורי inline להודעות הבוט (למשל, כפתור "📋 פתח תפריט" — ראו סעיף למטה)
• ליצור בוט Telegram לקבלת הזמנות — הבוט יכול לקבל ולעבד הזמנות
• להגדיר Webhook — לקבל אירועים מ-Telegram (לחיצות על כפתורים, פקודות משתמשים)
• לשלב עם מערכת CRM או POS — עיבוד הזמנות אוטומטי דרך הבוט

שלב 2 — צרו Mini App#

שלחו ל-BotFather את הפקודה:

/newapp

1. בחרו בוט מהרשימה
2. Title — שם האפליקציה (למשל, Cenaly)
3. Description — תיאור (למשל, Digital restaurant menu)
4. Photo — העלו תמונה בגודל 640×640 פיקסלים (אייקון האפליקציה)
5. GIF — אנימציה (לא חובה). כדי לדלג, שלחו /empty
6. Web App URL — ציינו את כתובת האפליקציה שלכם:

https://cenaly.com

7. Short Name — שם קצר לקישור (למשל, menu)

לאחר מכן תקבלו קישור פעיל בפורמט:

https://t.me/YourBot/menu

שלב 3 — הוסיפו כפתור "תפריט" בצ'אט הבוט#

שלחו ל-BotFather:

/setmenubutton

1. בחרו בוט
2. שלחו URL:

https://cenaly.com

3. הזינו טקסט לכפתור (למשל, Open Menu או 📋 תפריט)

כעת, בעת פתיחת הצ'אט עם הבוט, יופיע כפתור בתחתית המסך שיפתח את האפליקציה שלכם.

שלב 4 — אפשרו דומיין#

שלחו ל-BotFather:

/setdomain

בחרו בוט וציינו את הדומיין:

cenaly.com

זה יאפשר ל-Telegram Web App לעבוד על הדומיין שלכם וכל תתי הדומיינים שלו (למשל, locationid.cenaly.com).

Deep Links — קישורים למסעדה ספציפית#

Telegram תומך בפרמטר startapp, שמועבר לאפליקציה בעת הפתיחה. השתמשו בו לקישורים למסעדה ספציפית:

דוגמאות#

אם LOCATION_ID של המסעדה שלכם הוא lnc2w74z:

https://t.me/YourBot/menu?startapp=lnc2w74z
https://t.me/YourBot/menu?startapp=lnc2w74z__ru
https://t.me/YourBot/menu?startapp=lnc2w74z__en

כפתורי Inline מהבוט#

אם הבוט שלכם שולח הודעות ללקוחות, תוכלו להוסיף כפתור inline שיפתח את התפריט:

אפשרות 1 — כפתור Web App (נפתח מיד)#

{
  "inline_keyboard": [[{
    "text": "📋 פתח תפריט",
    "web_app": {
      "url": "https://LOCATION_ID.cenaly.com/ru"
    }
  }]]
}

אפשרות 2 — כפתור Deep Link#

{
  "inline_keyboard": [[{
    "text": "📋 פתח תפריט",
    "url": "https://t.me/YourBot/menu?startapp=LOCATION_ID__ru"
  }]]
}

מה עובד אוטומטית#

לאחר החיבור בתוך Telegram מופעלות אוטומטית:

קודי QR למסעדות#

קודי QR קיימים עם URL בפורמט https://lnc2w74z.cenaly.com ימשיכו לעבוד כרגיל — דרך הדפדפן.

לשילוב נוסף עם Telegram ניתן למקם על השולחנות קוד QR שני עם קישור לבוט:

https://t.me/YourBot/menu?startapp=lnc2w74z

בדיקת תקינות#

1. פתחו את הקישור https://t.me/YourBot/menu בטלפון
2. לחצו Start (אם פותחים את הבוט לראשונה)
3. לחצו על כפתור 📋 תפריט בפאנל התחתון של הצ'אט
4. ודאו שהאפליקציה נפתחה וטעינה את התפריט
5. נסו לפתוח deep link: https://t.me/YourBot/menu?startapp=LOCATION_ID

בעיות נפוצות#

קישורים שימושיים#

• תיעוד Telegram Mini Apps
• BotFather
• Telegram Bot API — כפתורי Web App