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

7. Short Name — მოკლე სახელი ბმულისთვის (მაგ., menu)

ამის შემდეგ გამოჩნდება სამუშაო ბმული სახის:

https://t.me/YourBot/menu

ნაბიჯი 3 — დაამატეთ "მენიუ" ღილაკი ბოტის ჩათში

გაუგზავნეთ BotFather:

/setmenubutton

1. აირჩიეთ ბოტი
2. გაგზავნეთ URL:

https://meni.ge

3. შეიყვანეთ ღილაკის ტექსტი (მაგ., Open Menu ან 📋 მენიუ)

ახლა ბოტის ჩათის გახსნისას ეკრანის ბოლოში გამოჩნდება ღილაკი, რომელიც ხსნის თქვენს აპლიკაციას.

ნაბიჯი 4 — დაუშვით დომენი

გაუგზავნეთ BotFather:

/setdomain

აირჩიეთ ბოტი და მიუთითეთ დომენი:

meni.ge

ეს Telegram Web App-ს საშუალებას მისცემს იმუშაოს თქვენს დომენზე და მის ყველა სუბდომენზე (მაგ., locationid.meni.ge).

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

📌 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-ში ავტომატურად ჩაირთვება:

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

ხშირი პრობლემები

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

• Telegram Mini Apps-ის დოკუმენტაცია
• BotFather
• Telegram Bot API — Web App ღილაკები