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://masamenu.tr

7. 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://masamenu.tr

3. 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:

masamenu.tr

Bu, Telegram Web App'in etki alanınızda ve tüm alt etki alanlarında (örn., locationid.masamenu.tr) ç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:

Ö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, masamenu.tr'deki konumunuzun tanımlayıcısıdır. Bunu yönetici panelinde veya https://LOCATION_ID.masamenu.tr 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.masamenu.tr/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:

Restoranlar için QR kodları#

https://lnc2w74z.masamenu.tr 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#

Faydalı bağlantılar#

• Telegram Mini Apps belgeleri
• BotFather
• Telegram Bot API — Web App düğmeleri