Telegram Mini App — Bosqichma-bosqich qo'llanma

Nima bu?#

Telegram Mini App mijozlaringizga restoraningizning raqamli menyusini to'g'ridan-to'g'ri Telegram ichida ochishga imkon beradi — ilovalarni o'rnatmasdan va brauzerga o'tmasdan. Menyu Telegramning tabiiy qismi sifatida ko'rinadi: foydalanuvchi mavzusiga moslashadi, "Orqaga" tugmasi va imo-ishoralarni qo'llab-quvvatlaydi.

Afzalliklari#

• 📱 Telegram ichida — mijoz brauzerga o'tishga hojat yo'q
• 🎨 Tabiiy ko'rinish — ranglar, shriftlar va mavzu Telegramga moslashadi
• 🔗 Deep Links — aniq bir restoran menyusiga to'g'ridan-to'g'ri havola
• 🌍 Avto til — til Telegram foydalanuvchi sozlamalaridan olinadi
• 🍪 Cookiesiz — cookie banneri Telegram ichida ko'rsatilmaydi

Tez boshlash#

1-qadam — Bot yarating#

Telegramda @BotFather ni oching va yuboring:

/newbot

1. Bot nomini kiriting (masalan, Cenaly Menu Bot)
2. Username kiriting (masalan, MeniMenuBot) — Bot bilan tugashi kerak
3. Olingan Bot Token ni saqlang (format: 123456789:ABCdefGHI...)

Bot Token nima uchun kerak?#

Bot Token — bu Telegram Bot API orqali botni dasturiy boshqarish uchun maxfiy kalit. Mini App ning asosiy sozlamalari uchun (2–4-qadamlar) u kerak emas — hammasi BotFather orqali amalga oshiriladi. Ammo u kerak bo'ladi, agar siz:

• Mijozlarga xabar yuborish — buyurtma holati haqida bildirishnomalar, aksiyalar, xush kelibsiz xabarlar
• Inline tugmalar qo'shish — bot xabarlariga (masalan, "📋 Menyu ochish" tugmasi — quyidagi bo'limga qarang)
• Buyurtmalarni qabul qilish uchun Telegram bot yaratish — bot buyurtmalarni qabul qilishi va qayta ishlashi mumkin
• Webhook sozlash — Telegramdan voqealarni olish (tugmalarni bosish, foydalanuvchi buyruqlari)
• CRM yoki POS tizimi bilan integratsiya qilish — bot orqali buyurtmalarni avtomatik qayta ishlash

2-qadam — Mini App yarating#

BotFather ga yuboring:

/newapp

1. Ro'yxatdan botni tanlang
2. Title — ilova nomi (masalan, Cenaly)
3. Description — tavsif (masalan, Digital restaurant menu)
4. Photo — 640×640 px tasvir yuklang (ilova ikonkasi)
5. GIF — animatsiya (ixtiyoriy). O'tkazib yuborish uchun /empty yuboring
6. Web App URL — mijoz ilovangiz manzilini kiriting:

https://cenaly.com

7. Short Name — havola uchun qisqa nom (masalan, menu)

Shundan so'ng sizda quyidagi ko'rinishdagi ishchi havola paydo bo'ladi:

https://t.me/YourBot/menu

3-qadam — Bot chatiga "Menyu" tugmasini qo'shing#

BotFather ga yuboring:

/setmenubutton

1. Botni tanlang
2. URL yuboring:

https://cenaly.com

3. Tugma matnini kiriting (masalan, Open Menu yoki 📋 Menyu)

Endi bot bilan chatni ochganingizda, ekranning pastki qismida ilovangizni ochadigan tugma paydo bo'ladi.

4-qadam — Domenni ruxsat bering#

BotFather ga yuboring:

/setdomain

Botni tanlang va domenni kiriting:

cenaly.com

Bu Telegram Web App ga sizning domeningiz va uning barcha subdomenlarida ishlashga ruxsat beradi (masalan, locationid.cenaly.com).

Deep Links — aniq bir restoran havolalari#

Telegram startapp parametrini qo'llab-quvvatlaydi, u ochilganda ilovaga uzatiladi. Uni aniq bir restoran havolalari uchun ishlating:

Misollar#

Agar restoraningizning LOCATION_ID si lnc2w74z bo'lsa:

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

Botdan inline tugmalar#

Agar botingiz mijozlarga xabar yuborsa, menyuni ochadigan inline tugma qo'shishingiz mumkin:

Variant 1 — Web App tugmasi (darhol ochiladi)#

{
  "inline_keyboard": [[{
    "text": "📋 Открыть меню",
    "web_app": {
      "url": "https://LOCATION_ID.cenaly.com/ru"
    }
  }]]
}

Variant 2 — Deep Link tugmasi#

{
  "inline_keyboard": [[{
    "text": "📋 Открыть меню",
    "url": "https://t.me/YourBot/menu?startapp=LOCATION_ID__ru"
  }]]
}

Avtomatik ishlaydigan narsalar#

Telegram ichida ulanishdan so'ng avtomatik ravishda yoqiladi:

Restoranlar uchun QR-kodlar#

https://lnc2w74z.cenaly.com ko'rinishidagi URL bilan mavjud QR-kodlar odatdagidek ishlashda davom etadi — brauzer orqali.

Telegram bilan qo'shimcha integratsiya uchun stollarga bot havolasi bilan ikkinchi QR-kodni joylashtirish mumkin:

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

Ishlashni tekshirish#

1. Telefonda https://t.me/YourBot/menu havolasini oching
2. Start tugmasini bosing (agar botni birinchi marta ochayotgan bo'lsangiz)
3. Chatning pastki panelidagi 📋 Menyu tugmasini bosing
4. Ilova ochilib, menyuni yuklaganiga ishonch hosil qiling
5. Deep linkni ochishga harakat qiling: https://t.me/YourBot/menu?startapp=LOCATION_ID

Tez-tez uchraydigan muammolar#

Foydali havolalar#

• Telegram Mini Apps hujjatlari
• BotFather
• Telegram Bot API — Web App tugmalari