Docs

Telegram Mini App — Kurulum Kılavuzu

Bu nedir?

Telegram Mini App, müşterilerinizin restoran dijital menüsünü doğrudan Telegram içinde açmasına olanak tanır — uygulama yüklemeden veya tarayıcıya geçmeden. Menü, Telegram'ın yerel bir parçası gibi görünür: kullanıcı temasına uyum sağlar, Geri düğmesini ve hareketleri destekler.

Avantajlar

  • 📱 Telegram içinde — müşterinin tarayıcıya geçmesi gerekmez
  • 🎨 Yerel görünüm — renkler, yazı tipleri ve tema Telegram'a uyum sağlar
  • 🔗 Derin Bağlantılar — belirli bir restoranın menüsüne doğrudan bağlantı
  • 🌍 Otomatik dil — dil, kullanıcının Telegram ayarlarından alınır
  • 🍪 Çerez yok — çerez banner'ı Telegram içinde gösterilmez

Hızlı Başlangıç

Adım 1 — Bot oluşturun

Telegram'da @BotFather açın ve gönderin:

/newbot
  1. Bot adını girin (örn., Meni Menu Bot)
  2. Kullanıcı adını girin (örn., MeniMenuBot) — Bot ile bitmelidir
  3. Alınan Bot Token'ı kaydedin (format: 123456789:ABCdefGHI...)

💡 Bot zaten oluşturulmuşsa, 2. Adıma geçin.

Bot Token neden gereklidir?

Bot Token, Telegram Bot API aracılığıyla botu programlı olarak yönetmek için gizli bir anahtardır. Temel Mini App kurulumu (adımlar 2–4) için gerekli değildir — her şey BotFather aracılığıyla yapılır. Ancak şunları yapmak istiyorsanız gereklidir:

  • Müşterilere mesaj göndermek — sipariş durumu bildirimleri, promosyonlar, karşılama mesajları
  • Bot mesajlarına inline düğmeler eklemek (örn., "📋 Menüyü aç" düğmesi — aşağıdaki bölüme bakın)
  • Sipariş almak için Telegram botu oluşturmak — bot siparişleri alıp işleyebilir
  • Webhook kurmak — Telegram olaylarını almak (düğme basmaları, kullanıcı komutları)
  • CRM veya POS sistemiyle entegrasyon — bot aracılığıyla otomatik sipariş işleme

🔒 Bot Token'ı yayınlamayın — token'a sahip olan herkes botunuzu yönetebilir. Token ele geçirilirse, BotFather'da /revoke komutuyla iptal edin.

Adım 2 — Mini App oluşturun

BotFather'a komutu gönderin:

/newapp
  1. Listeden botu seçin
  2. Title — uygulama adı (örn., Meni)
  3. Description — açıklama (örn., Digital restaurant menu)
  4. Photo — 640×640 px resim yükleyin (uygulama simgesi)
  5. GIF — animasyon (isteğe bağlı). Atlamak için /empty gönderin
  6. Web App URL — istemci uygulamanızın adresini belirtin:
https://meni.ge
  1. Short Name — bağlantı için kısa ad (örn., menu)

Bundan sonra şu şekilde çalışan bir bağlantınız olacak:

https://t.me/YourBot/menu

Adım 3 — Bot sohbetine "Menü" düğmesi ekleyin

BotFather'a gönderin:

/setmenubutton
  1. Botu seçin
  2. URL'yi gönderin:
https://meni.ge
  1. Düğme metnini girin (örn., Open Menu veya 📋 Menü)

Artık botla sohbet açıldığında ekranın altında uygulamanızı açan bir düğme görünecektir.

Adım 4 — Etki alanına izin verin

BotFather'a gönderin:

/setdomain

Botu seçin ve etki alanını belirtin:

meni.ge

Bu, Telegram Web App'in etki alanınızda ve tüm alt etki alanlarında (örn., locationid.meni.ge) çalışmasına izin verir.

Derin Bağlantılar — belirli bir restorana bağlantılar

Telegram, açılırken uygulamaya iletilen startapp parametresini destekler. Belirli bir restorana yönelik bağlantılar için kullanın:

Bağlantı Ne açılır
t.me/YourBot/menu Ana sayfa
t.me/YourBot/menu?startapp=LOCATION_ID Belirli bir restoranın menüsü
t.me/YourBot/menu?startapp=LOCATION_ID__ru Rusça menü
t.me/YourBot/menu?startapp=LOCATION_ID__en İngilizce menü

Örnekler

Restoranınızın LOCATION_ID'si lnc2w74z ise:

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'deki konumunuzun tanımlayıcısıdır. Bunu yönetici panelinde veya https://LOCATION_ID.meni.ge formatındaki URL'de bulabilirsiniz.

Bottan inline düğmeler

Botunuz müşterilere mesaj gönderiyorsa, menüyü açacak bir inline düğme ekleyebilirsiniz:

Seçenek 1 — Web App düğmesi (hemen açılır)

{
  "inline_keyboard": [[{
    "text": "📋 Menüyü aç",
    "web_app": {
      "url": "https://LOCATION_ID.meni.ge/tr"
    }
  }]]
}

Seçenek 2 — Derin Bağlantı düğmesi

{
  "inline_keyboard": [[{
    "text": "📋 Menüyü aç",
    "url": "https://t.me/YourBot/menu?startapp=LOCATION_ID__tr"
  }]]
}

Otomatik çalışan özellikler

Bağlandıktan sonra Telegram içinde otomatik olarak etkinleşen özellikler:

Özellik Açıklama
🎨 Tema Uygulama renkleri Telegram temasına (açık/koyu) uyum sağlar
◀️ Geri düğmesi Ürün kartı açılırken yerel Telegram düğmesi görünür
📏 Görünüm Alanı Uygulama tam ekrana uzar
🔒 Kapatma koruması Dikey kaydırma uygulamayı yanlışlıkla kapatmaz
🌍 Otomatik dil Dil, Telegram profilinden belirlenir (açıkça ayarlanmadıkça)
🍪 Çerezler Çerez banner'ı Telegram içinde gösterilmez

Restoranlar için QR kodları

https://lnc2w74z.meni.ge gibi URL'lere sahip mevcut QR kodları tarayıcı üzerinden normal şekilde çalışmaya devam eder.

Ek Telegram entegrasyonu için masalara bot bağlantılı ikinci bir QR kodu yerleştirebilirsiniz:

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

Doğrulama

  1. Telefonunuzda https://t.me/YourBot/menu bağlantısını açın
  2. Start'a tıklayın (botu ilk kez açıyorsanız)
  3. Sohbet alt panelindeki 📋 Menü düğmesine tıklayın
  4. Uygulamanın açıldığından ve menüyü yüklediğinden emin olun
  5. Derin bağlantıyı açmayı deneyin: https://t.me/YourBot/menu?startapp=LOCATION_ID

Sık karşılaşılan sorunlar

Sorun Çözüm
Uygulama açılmıyor meni.ge etki alanının /setdomain ile izin verildiğini kontrol edin
Beyaz ekran Web App URL'nin https://meni.ge olarak ayarlandığından emin olun (HTTPS zorunludur)
startapp çalışmıyor Formatı kontrol edin: LOCATION_ID (boşluk veya özel karakter olmadan). Dil ayırıcı çift alt çizgi __
Tema uygulanmıyor Telegram Mini App SDK bağlanmalıdır (istemci uygulamasını güncelleyin)

Faydalı bağlantılar