Docs

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

מה זה?

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

יתרונות

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

התחלה מהירה

שלב 1 — צרו בוט

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

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

💡 אם הבוט כבר נוצר, עברו לשלב 2.

למה צריך Bot Token?

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

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

🔒 אל תפרסמו את Bot Token — כל מי שיש לו את הטוקן יכול לנהל את הבוט שלכם. אם הטוקן נחשף, בטלו אותו עם הפקודה /revoke ב-BotFather.

שלב 2 — צרו Mini App

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

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

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

https://t.me/YourBot/menu

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

שלחו ל-BotFather:

/setmenubutton
  1. בחרו בוט
  2. שלחו URL:
https://meni.ge
  1. הזינו טקסט לכפתור (למשל, Open Menu או 📋 תפריט)

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

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

שלחו ל-BotFather:

/setdomain

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

meni.ge

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

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

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

קישור מה ייפתח
t.me/YourBot/menu דף הבית
t.me/YourBot/menu?startapp=LOCATION_ID תפריט של מסעדה ספציפית
t.me/YourBot/menu?startapp=LOCATION_ID__ru תפריט בשפה הרוסית
t.me/YourBot/menu?startapp=LOCATION_ID__en תפריט בשפה האנגלית

דוגמאות

אם 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

📌 LOCATION_ID הוא מזהה המיקום שלכם ב-meni.ge. תוכלו למצוא אותו בפאנל הניהול או ב-URL בפורמט https://LOCATION_ID.meni.ge.

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

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

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

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

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

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

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

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

פונקציה תיאור
🎨 נושא צבעי האפליקציה מתאימים את עצמם לנושא Telegram (בהיר/כהה)
◀️ כפתור "חזרה" כפתור חזרה טבעי של Telegram מופיע בעת פתיחת כרטיס מוצר
📏 Viewport האפליקציה נמתחת על כל המסך
🔒 הגנה מסגירה החלקה אנכית לא תסגור את האפליקציה בטעות
🌍 שפה אוטומטית השפה נקבעת מפרופיל Telegram, אם לא נקבעה במפורש
🍪 Cookies באנר cookie לא מוצג בתוך Telegram

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

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

לשילוב נוסף עם 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

בעיות נפוצות

בעיה פתרון
האפליקציה לא נפתחת בדקו שהדומיין meni.ge מאושר דרך /setdomain
מסך לבן ודאו ש-Web App URL מצוין כ-https://meni.ge (HTTPS חובה)
startapp לא עובד בדקו את הפורמט: LOCATION_ID (ללא רווחים, תווים מיוחדים). מפריד לשפה — שתי קווים תחתונים __
הנושא לא מוחל יש לחבר את Telegram Mini App SDK (עדכנו את אפליקציית הלקוח)

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