Docs

Telegram Mini App — დაყენების სახელმძღვანელო

რა არის ეს?

Telegram Mini App საშუალებას აძლევს თქვენს კლიენტებს გახსნან რესტორნის ციფრული მენიუ პირდაპირ Telegram-ში — აპლიკაციების ინსტალაციის ან ბრაუზერზე გადართვის გარეშე. მენიუ გამოიყურება როგორც Telegram-ის ნაწილი: ადაპტირდება მომხმარებლის თემაზე, მხარს უჭერს "უკან" ღილაკს და gesture-ებს.

უპირატესობები

  • 📱 Telegram-ში — კლიენტს არ სჭირდება ბრაუზერზე გადართვა
  • 🎨 ნატიური გარეგნობა — ფერები, შრიფტები და თემა ადაპტირდება Telegram-ზე
  • 🔗 Deep Links — პირდაპირი ბმული კონკრეტული რესტორნის მენიუზე
  • 🌍 ავტომატური ენა — ენა აღებულია მომხმარებლის Telegram პარამეტრებიდან
  • 🍪 Cookies გარეშე — cookie ბანერი არ გამოჩნდება Telegram-ში

სწრაფი დაწყება

ნაბიჯი 1 — შექმენით ბოტი

გახსენით @BotFather Telegram-ში და გაგზავნეთ:

/newbot
  1. შეიყვანეთ ბოტის სახელი (მაგ., Meni Menu Bot)
  2. შეიყვანეთ username (მაგ., 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 — ვინც ინახავს token-ს, შეუძლია მართოს თქვენი ბოტი. კომპრომეტირების შემთხვევაში, გააუქმეთ /revoke ბრძანებით BotFather-ში.

ნაბიჯი 2 — შექმენით Mini App

გაუგზავნეთ BotFather ბრძანება:

/newapp
  1. აირჩიეთ ბოტი სიიდან
  2. Title — აპლიკაციის სახელი (მაგ., Meni)
  3. Description — აღწერა (მაგ., Digital restaurant menu)
  4. Photo — ატვირთეთ 640×640 px სურათი (აპის ხატულა)
  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/ka"
    }
  }]]
}

ვარიანტი 2 — Deep Link ღილაკი

{
  "inline_keyboard": [[{
    "text": "📋 მენიუს გახსნა",
    "url": "https://t.me/YourBot/menu?startapp=LOCATION_ID__ka"
  }]]
}

რა მუშაობს ავტომატურად

დაკავშირების შემდეგ Telegram-ში ავტომატურად ჩაირთვება:

ფუნქცია აღწერა
🎨 თემა აპის ფერები ადაპტირდება Telegram-ის თემაზე (ნათელი/მუქი)
◀️ "უკან" ღილაკი Telegram-ის ნატიური ღილაკი გამოჩნდება პროდუქტის ბარათის გახსნისას
📏 Viewport აპლიკაცია გაიჭიმება სრულ ეკრანზე
🔒 დახურვის დაცვა ვერტიკალური swipe-ი შემთხვევით არ დახურავს აპს
🌍 ავტო ენა ენა განისაზღვრება 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 უნდა იყოს დაკავშირებული (განაახლეთ კლიენტური აპლიკაცია)

სასარგებლო ბმულები