Telegram Mini App — Addım-addım Təlimat

Nədir?#

Telegram Mini App müştərilərinizə restoranın rəqəmsal menyusunu birbaşa Telegram daxilində açmağa imkan verir — tətbiqləri quraşdırmadan və brauzerə keçmədən. Menyu Telegram-ın yerli hissəsi kimi görünür: istifadəçinin mövzusuna uyğunlaşır, "Geri" düyməsini və jestləri dəstəkləyir.

Üstünlüklər#

• 📱 Telegram daxilində — müştəri brauzerə keçməyə ehtiyac duymur
• 🎨 Yerli görünüş — rənglər, şriftlər və mövzu Telegram-a uyğunlaşır
• 🔗 Dərin Keçidlər — xüsusi restoran menyusuna birbaşa keçid
• 🌍 Avtomatik Dil — dil istifadəçinin Telegram parametrlərindən götürülür
• 🍪 Cookies olmadan — cookie banneri Telegram daxilində göstərilmir

Sürətli Başlanğıc#

Addım 1 — Bot yaradın#

Telegram-da @BotFather açın və göndərin:

/newbot

1. Bot adı daxil edin (məsələn, Cenaly Menu Bot)
2. İstifadəçi adı daxil edin (məsələn, MeniMenuBot) — Bot ilə bitməlidir
3. Alınan Bot Token-i saxlayın (format: 123456789:ABCdefGHI...)

Bot Token nə üçün lazımdır?#

Bot Token — botu Telegram Bot API vasitəsilə proqramlı idarə etmək üçün gizli açardır. Mini App-in əsas quraşdırılması üçün (addımlar 2–4) o tələb olunmur — hər şey BotFather vasitəsilə edilir. Amma əgər siz:

• Müştərilərə mesaj göndərmək istəyirsinizsə — sifariş statusu, aksiyalar, salam mesajları
• Bot mesajlarına inline düymələr əlavə etmək istəyirsinizsə (məsələn, "📋 Menyu Aç" düyməsi — aşağıdakı bölməyə baxın)
• Sifariş qəbul etmək üçün Telegram botu yaratmaq istəyirsinizsə — bot sifarişləri qəbul edə və işləyə bilər
• Webhook qurmaq istəyirsinizsə — Telegram-dan hadisələri qəbul etmək (düymə basmaları, istifadəçi komandaları)
• CRM və ya POS sistemi ilə inteqrasiya etmək istəyirsinizsə — bot vasitəsilə sifarişlərin avtomatik işlənməsi

Addım 2 — Mini App yaradın#

BotFather-a komanda göndərin:

/newapp

1. Siyahıdan botu seçin
2. Title — tətbiqin adı (məsələn, Cenaly)
3. Description — təsvir (məsələn, Rəqəmsal restoran menyusu)
4. Photo — 640×640 px ölçüsündə şəkil yükləyin (tətbiq ikonkası)
5. GIF — animasiya (isteğe bağlı). Keçmək üçün /empty göndərin
6. Web App URL — müştəri tətbiqinizin ünvanını göstərin:

https://cenaly.com

7. Short Name — keçid üçün qısa ad (məsələn, menu)

Bundan sonra sizdə aşağıdakı formada işçi keçid olacaq:

https://t.me/YourBot/menu

Addım 3 — Bot çatına "Menyu" düyməsi əlavə edin#

BotFather-a göndərin:

/setmenubutton

1. Botu seçin
2. URL göndərin:

https://cenaly.com

3. Düymə mətnini daxil edin (məsələn, Open Menu və ya 📋 Menyu)

İndi botla çatı açdığınızda ekranın aşağısında tətbiqinizi açan bir düymə görünəcək.

Addım 4 — Domenə icazə verin#

BotFather-a göndərin:

/setdomain

Botu seçin və domeni göstərin:

cenaly.com

Bu, Telegram Web App-in domeninizdə və onun bütün subdomenlərində (məsələn, locationid.cenaly.com) işləməsinə icazə verəcək.

Deep Links — xüsusi restorana keçidlər#

Telegram startapp parametrini dəstəkləyir, bu da açılış zamanı tətbiqə ötürülür. Xüsusi restorana keçidlər üçün istifadə edin:

Nümunələr#

Əgər restoranınızın LOCATION_ID-si lnc2w74z-dirsə:

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 düymələr#

Əgər botunuz müştərilərə mesaj göndərirsə, menyunu açacaq inline düymə əlavə edə bilərsiniz:

Variant 1 — Web App düyməsi (dərhal açılır)#

{
  "inline_keyboard": [[{
    "text": "📋 Menyu Aç",
    "web_app": {
      "url": "https://LOCATION_ID.cenaly.com/ru"
    }
  }]]
}

Variant 2 — Deep Link düyməsi#

{
  "inline_keyboard": [[{
    "text": "📋 Menyu Aç",
    "url": "https://t.me/YourBot/menu?startapp=LOCATION_ID__ru"
  }]]
}

Avtomatik işləyənlər#

Telegram daxilində qoşulduqdan sonra avtomatik olaraq aktivləşir:

Restoranlar üçün QR-kodlar#

https://lnc2w74z.cenaly.com formatında URL-lərlə mövcud QR-kodlar adi qaydada — brauzer vasitəsilə işləməyə davam edəcək.

Telegram ilə əlavə inteqrasiya üçün masalarda botun keçidi ilə ikinci QR-kod yerləşdirə bilərsiniz:

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

İşləkliyi yoxlamaq#

1. https://t.me/YourBot/menu keçidini telefonda açın
2. Start düyməsini basın (əgər botu ilk dəfə açırsınızsa)
3. Çatın aşağı panelində 📋 Menyu düyməsini basın
4. Tətbiqin açıldığını və menyunun yükləndiyini yoxlayın
5. Dərin keçidi açmağa çalışın: https://t.me/YourBot/menu?startapp=LOCATION_ID

Ümumi problemlər#

Faydalı keçidlər#

• Telegram Mini Apps sənədləri
• BotFather
• Telegram Bot API — Web App düymələri