--- title: "Telegram Mini App Oluşturun: Adım Adım TMA Rehberi" description: "Telegram Mini App Oluşturun: Adım Adım TMA Rehberi. Kendi Telegram Mini App'inizi oluşturmayı öğrenin! Bu rehber, bir TMA oluşturmak için ihtiyacınız olan her şeyi kapsıyor." image: https://image.adsgram.ai/site/maxresdefault-1024x576jpg.webp --- # Telegram Mini App nasıl yapılır? Telegram Mini App oluşturun: Adım adım TMA rehberi. Kendi Telegram Mini App’inizi nasıl yapacağınızı öğrenin! Bu rehber, bir TMA oluşturmak için ihtiyacınız olan her şeyi anlatıyor. Yayınlandı 6 Kas 202515 dk okuma ![maxresdefault-1024x576.jpg](https://image.adsgram.ai/site/maxresdefault-1024x576jpg.webp) [Telegram Mini Apps](https://adsgram.ai/tr) doğrudan Telegram’a entegre web uygulamaları geliştirmek için güçlü bir platformdur. Bu rehber, kendi Mini App’inizi ilk kurulumdan yayına almaya ve AdsGram ile gelir elde etmeye kadar adım adım anlatır. ## Telegram Mini Apps nedir? Telegram Mini Apps, Telegram arayüzünde çalışan web uygulamalarıdır; uygulama mağazasından indirme veya harici kurulum gerektirmeden etkileşimli deneyimler sunar. Standart web teknolojileriyle geliştirilen bu uygulamalar geliştiricilere şunları sağlar: - Telegram’ın küresel ekosisteminde dağıtım; görünürlük otomatik değildir - Telegram arayüzü ve özellikleriyle yerel entegrasyon - Platformlar arası uyumluluk (iOS, Android, masaüstü ve web) - Bot bağlantıları ve menü düğmeleriyle kolay dağıtım ## Uygulama geliştirme süreci Geliştirme süreci üç temel aşamadan oluşur: 1. Bot ve Mini App kaydı – Telegram botunuzu ve Mini App’inizi BotFather üzerinden yapılandırma 2. Uygulama geliştirme – React, Vue veya saf JavaScript ile geliştirme; React ve Vue isteğe bağlı arayüz araçlarıdır 3. Yayına alma ve entegrasyon – Uygulamanızı barındırma ve Telegram ekosistemine bağlama Bu yazı, her aşama için adım adım talimatların yanı sıra geliştirme için en iyi uygulamaları, test stratejilerini ve Telegram Mini Apps için uzmanlaşmış reklam platformu AdsGram ile gelir fırsatlarını ele alıyor. ## Geliştirme ortamının kurulumu Tamamlanmamış değişiklikleri gerçek kullanıcılardan uzak tutun. Ayrı bir staging ortamı ve gerektiğinde Telegram’ın test ortamını kullanın. Test backend’i bir seçenektir; arayüz geliştirmenin her aşamasında zorunlu değildir. ### Telegram’ın test ortamını anlamak Telegram, geliştirme ve test için özel olarak tasarlanmış ayrı bir test ortamı sunar. Bu yalıtılmış ortam üretim işlevlerini yansıtırken önemli avantajlar da sağlar: HTTP desteği (yerel geliştirmede SSL sertifikası gerekmez), alan adı olmadan doğrudan IP adresiyle erişim ve üretim botları ile gerçek kullanıcı verilerinden tam yalıtım. ### Üretim ve test ortamı **Özellik** **Üretim ortamı** **Test ortamı** URL gereksinimleri Yalnızca HTTPS (geçerli SSL sertifikası) HTTP ve HTTPS desteklenir Alan adı Güvenilir sertifikaya sahip herkese açık HTTPS URL’si Erişilebilir test sunucusu; IP adresleri kullanılabilir Veriler Gerçek kullanıcılar ve veriler Yalıtılmış test verileri Kullanım alanı Canlı uygulamalar Geliştirme ve test ### Test ortamına geçiş Şu anda belgelenen giriş yolları şunlardır. Telegram Desktop’ta: Ayarlar → Shift + Alt + Hesap Ekle’ye sağ tıklayın → Test Sunucusu. iOS’ta: Ayarlar simgesine 10 kez dokunun → Hesaplar → Başka bir hesapla giriş yap → Test. Yerel macOS uygulamasında hata ayıklama menüsüyle ayrı bir yol izlenir. Menüler istemciye ve sürüme göre değişir; Android’de aynı gizli menünün olduğunu varsaymayın. Test hesaplarının üretim hesaplarından tamamen ayrı olduğunu unutmayın. Test ortamında BotFather ile yeni bir test botu oluşturmanız gerekir. ### Geliştirme akışı Yerel olarak veya ayrı bir staging ortamında geliştirin. Telegram’ın test ortamı Mini Apps için HTTP’ye izin verir, ancak cihazın sunucunuza erişebilmesi gerekir; localhost cihazın kendisini ifade eder. Yayına almadan önce üretim HTTPS URL’sini ve gerekli tüm özellikleri test edin. AdsGram entegrasyonu isteğe bağlıdır ve ayrıca test edilmelidir. Bu ayrım, geliştirme sürecinizi profesyonel, güvenli ve verimli hâle getirir; üretim kararlılığını riske atmadan rahatça çalışmanızı sağlar. ## Geliştirmeye hazırlık Bu aşama, uygulamanızın ne kadar kullanışlı ve faydalı olacağını belirler. Endişelenmeyin: süreç oldukça basit ve deneyiminiz olmasa bile anlayabilirsiniz. Sıfırdan etkili mini uygulamalar oluşturmayı öğreneceksiniz. - **Mini uygulamanın amacını belirleyin** Öncelikle neden bir mini uygulamaya ihtiyacınız olduğunu düşünün. Bu şunlar olabilir: Kullanıcıları eğlendirmek ve etkileşimi artırmak için tasarlanmış bir oyun. Faydalı bir araç (örneğin hesap makinesi, çeviri aracı veya görev planlayıcı). Bir iletişim hizmeti (örneğin müşterilere yardım eden bir bot veya otomatik SSS). Mini uygulamanızla hangi sorunu çözmek istediğinizi anlamak önemlidir. Amaç ne kadar netse yapısını ve işlevlerini geliştirmek de o kadar kolay olur. - **Geliştirme platformunu ve teknolojisini seçin** Amacınızı belirlediğinize göre uygulamanızı neyle geliştireceğinizi seçme zamanı. İşte bazı popüler seçenekler: Temel programlama biliyorsanız JavaScript mükemmel bir seçimdir. Onunla Telegram ekosisteminde sorunsuz çalışan bir web uygulaması oluşturabilirsiniz. Telegram bu teknolojiyi çok iyi destekler ve hızlı başlangıç için oldukça kullanışlıdır. React. Kullanıcı arayüzleri oluşturmaya yarayan bir kütüphanedir. Bileşen oluşturmayı ve kullanıcı etkileşimini kolaylaştırdığı için mini uygulama geliştirmeye çok uygundur. Diğer web teknolojileri. Uygulamanızın arayüzünü oluşturmak için HTML ve CSS de kullanabilirsiniz. Bu temel öğeler projenizi görsel olarak çekici ve işlevsel kılar. Telegram’ın WebView’unda çalışan ve gerekli Telegram entegrasyonlarını destekleyen bir web uygulaması üreten diğer framework’ler de uygundur. ### Botunuzu oluşturma ve Mini App’i kaydetme Telegram Mini App oluşturmak için önce Telegram’ın resmî bot yönetim aracı BotFather üzerinden bir Telegram botu kurmanız gerekir. BotFather, platformdaki tüm botlar ve Mini Apps için merkezî yönetici görevi görür. ### Botunuzu kurma Telegram’ı açın ve şunu arayın: [@BotFather](https://t.me/botfather) . Bir sohbet başlatın ve /newbot komutunu kullanın. BotFather, görünen ad ve benzersiz kullanıcı adı belirlemenizde size yol gösterir (kullanıcı adı “bot” ile bitmelidir, örneğin MyCoolMiniApp\_bot). Bot oluşturulduğunda BotFather bir kimlik doğrulama token’ı verir. Botunuz üzerinde tam kontrol sağladığı için bunu ortam değişkenlerinizde güvenle saklayın. ### Mini App’inizi kaydetme Yeni bir Mini App kaydetmek ve botunuza bağlamak için BotFather’da /newapp komutunu kullanın. Uygulamanın kısa adını, açıklamasını ve simgesini girin. Mini App’iniz doğrudan bir bağlantı alır: `https://t.me/{bot_username}/{app_short_name}.` ### Menü düğmesi mi, doğrudan bağlantı mı: entegrasyon yönteminizi seçin Telegram, Mini App’inize erişim için farklı amaçlara hizmet eden iki yol sunar. **Özellik** **Menü düğmesi** **Doğrudan bağlantı** Erişim yöntemi Sohbetteki bot menü düğmesiyle Paylaşılabilir URL t.me/{bot}/{app} Kullanıcı akışı Kullanıcı önce botla sohbet başlatır Doğrudan erişim, botla sohbet gerekmez Görünürlük Bot arayüzünde her zaman görünür URL’nin paylaşılması veya keşfedilmesi gerekir En uygun olduğu alan Bot işlevlerini genişleten uygulamalar Bağımsız uygulamalar, viral paylaşım ve oyunlar Keşif Bot aramasıyla Bağlantılar, QR kodları ve pazarlama kampanyaları ### Menü düğmesi entegrasyonu Kullanıcılar botunuzla etkileşime geçtiğinde menü düğmesi sohbet arayüzünün sol altında görünür. Bu yöntemde Mini App’iniz bot işlevlerinin doğal bir uzantısı gibi hissettirir. **Kurulum:** BotFather’a /setmenubutton gönderin → Botunuzu seçin → Web uygulaması URL’nizi girin (üretimde HTTPS zorunludur) → Düğme başlığını yazın. **En uygun olduğu alanlar:** Botla entegre uygulamalar, kişiselleştirilmiş paneller, müşteri destek araçları ve bot iş akışına bağlı uygulamalar; sohbet geçmişine erişim otomatik değildir. ### Doğrudan bağlantı entegrasyonu Doğrudan bağlantılar, önce botla etkileşim gerektirmeden paylaşılabilir URL’lerle erişilen bağımsız Mini Apps oluşturur. Viral dağıtımdan yararlanan bağımsız uygulamalar için idealdir. **Kurulum:** BotFather’a /myapps gönderin → Mini App’inizi seçin → “Edit Web App URL”ye tıklayın → URL’nizi girin (üretimde HTTPS zorunludur). **En uygun olduğu alanlar:** Bağımsız oyunlar, e-ticaret mağazaları, kullanışlı araçlar, viral uygulamalar ve pazarlama odaklı uygulamalar. ### Seçiminizi yapma Uygulamanız bot komutlarını tamamlıyorsa menü düğmesini seçin; bu düğme sohbet geçmişine otomatik erişim sağlamaz. Uygulamanız bağımsız çalışıyor ve doğrudan paylaşımdan yararlanıyorsa doğrudan bağlantıyı seçin. İkisini aynı anda da kullanabilirsiniz: bot kullanıcıları için menü düğmesini, yeni kullanıcı kazanımı ve viral büyüme için doğrudan bağlantıyı. Yöntem ne olursa olsun, URL’nizin üretimde geçerli SSL’e sahip HTTPS kullandığından emin olun (HTTP yalnızca test ortamında). Her iki yapılandırma da gelir elde etmek için AdsGram entegrasyonunu destekler. ## Mini uygulama geliştirme TMA’nızı geliştirmek için React gibi farklı framework’ler kullanabilir veya web teknolojileri ve Telegram hizmetleriyle sıfırdan bir uygulama oluşturabilirsiniz. İster basit bir bot ister karmaşık bir etkileşimli uygulama geliştirin, bu adım adım rehber süreç boyunca size yardımcı olur. Bunlar doğrudan Telegram arayüzünde çalışan web uygulamalarıdır ve uygulama mağazasına gitmeye gerek kalmadan akıcı bir deneyim sunar. Unutmayın, her şey ilk bakışta göründüğü kadar zor değil. ### Adım 1. Proje oluşturma Önce mini uygulamanızın temeli olacak bir Telegram Mini App projesi oluşturmanız gerekir. VS Code, WebStorm gibi metin düzenleyiciler veya geliştirme ortamları (IDE) ya da Sublime Text gibi basit düzenleyiciler bu konuda yardımcı olur. Kodu düzenlemeyi ve yazmayı kolaylaştırırlar. Her şeyin doğru çalıştığından emin olmak için uygun bir test ortamı da kurmanız gerekir. Projeniz için bir klasör oluşturun ve içine şu dosyaları ekleyin: index.html: web uygulamanızın HTML kodunu içerecek dosya. style.css: arayüz stillerini (CSS) içerir; bu asgari örnekte boş kalabilir. app.js: uygulama mantığını ve Telegram hizmetleriyle etkileşimi kontrol edecek ana kodunuz burada olur. ### Adım 2. Kod yazma Proje yapısı hazır olduğunda koda geçebilirsiniz. Uygulamanızı nasıl kuracağınıza ve etkileşimli hâle getireceğinize bakalım. Uygulamanızın doğru çalıştığından ve iyi hata ayıklama olanakları sunduğundan emin olmak istersiniz. Telegram hizmetlerine bağlanma Telegraf, sunucu tarafındaki bot için bir Node.js kütüphanesidir; tarayıcı SDK’sı değildir. BotFather token’ını yalnızca sunucu tarafındaki BOT\_TOKEN ortam değişkeninde saklayın. Bunu index.html veya app.js içine koymayın. Mini App kimliği için Telegram initData’nın sunucu tarafında ayrıca doğrulanması gerekir; Telegraf bunu otomatik olarak eklemez. Telegraf’ı şu komutla yükleyin: `bash` `npm install telegraf` Bu sunucu tarafı örneği bot.js olarak kaydedin, BOT\_TOKEN’ı ayarlayın ve node bot.js komutunu çalıştırın: `javascript` `const { Telegraf } = require('telegraf');` `const bot = new Telegraf(process.env.BOT_TOKEN);` `bot.start((ctx) => ctx.reply('Hello! This is your Mini App bot.'));` `bot.launch();` Bu bot, kullanıcı /start gönderdiğinde yanıt verir; Mini App’i açmaz ve başlatıldığında her kullanıcıya mesaj göndermez. Menü düğmesini veya doğrudan bağlantıyı ayrıca yapılandırın. Web3 ve cüzdan entegrasyonları isteğe bağlıdır ve bu örnekte uygulanmamıştır. Arayüz oluşturma index.html, style.css ve app.js dosyalarını içeren bir public klasörü oluşturun. Aşağıdaki HTML’i public/index.html olarak kaydedin. Bu asgari arayüzde henüz kimlik doğrulama veya Telegram bağlantısı yok: `html` `` `` `` `` `` `` `My Mini App` `` `` `
` `` `
` `` `` `` ### Adım 3. Uygulama mantığını yazma İstemci tarafındaki app.js tarayıcı etkileşimlerini yönetir. Sonraki örnek, düğmeye tıklandığında yalnızca bir uyarı gösterir; gerçek oyun veya hizmet mantığınızı ayrıca ekleyin. Telegram API’leri için Telegram WebApp betiğini yükleyin ve desteklenen yöntemlerini kullanın. Kullanıcı kimliğine güvenmeden önce initData’yı backend’de doğrulayın. Arayüzü net ve erişilebilir tutun. Bot mesajları için kullanıcının daha önce etkileşime girmiş olması veya uygun yazma izni gerekir; Mini App, arka planda rastgele bildirim gönderemez. ### Adım 4. Başlatma ve test Bu tıklama işleyicisini public/app.js olarak kaydedin, ardından düğmeyi tarayıcıda ve Telegram içinde test edin: `javascript` `document.getElementById('startBtn').addEventListener('click', function() {` `alert('The game has started!');` `// Add code here to start your game or other application logic.` `});` Statik arayüz için Live Server yeterlidir. bot.launch() kullanan bir bot, sürekli çalışan bir Node.js işlemine ihtiyaç duyar; bu polling işlemini değiştirmeden kısa ömürlü bir serverless işlev olarak yayına almayın. Arayüz için HTTPS’li staging barındırma, bot için ise uygun bir işlem veya webhook dağıtımı kullanın. Sürekli çalışan bir Node.js barındırması için npm install express ile Express’i yükleyin ve aşağıdakini public/ klasörünün yanına server.js olarak kaydedin. BOT\_TOKEN’ı ayarlayın ve bot.js yerine node server.js çalıştırın; ikisini aynı token ile birlikte çalıştırmayın. Bu örnek statik dosya sunumu ekler ve token’ı ortamdan okur. HTTPS’i barındırma katmanında yapılandırın: `javascript` `const express = require('express');` `const { Telegraf } = require('telegraf');` `const path = require('node:path');` `const app = express();` `const bot = new Telegraf(process.env.BOT_TOKEN);` `// Serve only the client files in the public directory.` `app.use(express.static(path.join(__dirname, 'public')));` `// Bot logic` `bot.start((ctx) => ctx.reply('Hello! The bot is running on the server.'));` `bot.launch();` `// Port configuration` `const PORT = process.env.PORT || 3000;` `app.listen(PORT, () => {` `console.log(Server running on port ${PORT});` `});` Artık temel bir arayüzünüz ve bir bot/sunucu örneğiniz var, ancak bu tamamlanmış bir üretim uygulaması değil. HTTPS URL’sini BotFather’a bağlayın, açılışı test edin ve yayından önce gerekli backend doğrulamasını, veri saklamayı ve hata yönetimini uygulayın. Reklamları, uygulama kararlı hâle geldikten sonra ayrıca test edin. ## Hata ayıklama ve test Mini App’inizi geliştirdikten sonra yayına almadan önce kapsamlı hata ayıklama ve test yapmak çok önemlidir. Telegram, geliştirme sırasında sorunları belirleyip çözmenize yardımcı olan çeşitli araçlar ve yöntemler sunar. ### Test yaklaşımları Testler, kurulumunuza göre farklı aşamalarda yapılabilir. Yerel geliştirmede uygulamanızı VS Code’daki Live Server gibi araçlarla yerel bir sunucuda çalıştırın. Test ortamında basit testler için uygulamanıza HTTP bağlantıları ve IP adresleriyle erişebilirsiniz. Üretime yakın testler için Vercel, Netlify veya Heroku gibi staging platformlarına dağıtın ve Mini App’inizin gerçek Telegram koşullarında nasıl davrandığını görün. ### Hata ayıklama araçları Konsol, ağ ve JavaScript hata ayıklaması için tarayıcı geliştirici araçlarını kullanın. Telegram’daki inceleme desteği istemciye, platforma ve hata ayıklama ayarlarına bağlıdır; sürümünüz için güncel Mini Apps hata ayıklama talimatlarını izleyin. Android ve iOS WebView incelemesi ek kurulum gerektirebilir. ### Sık karşılaşılan sorunlar ve çözümleri **Sorun** **Çözüm** API bağlantı hataları Bot token’ının doğru olduğunu ve ortam değişkenlerinde düzgün saklandığını doğrulayın HTTPS hataları Barındırma hizmetinizin geçerli SSL sertifikaları sağladığından emin olun (üretim gereksinimi) Webhook sorunları Webhook URL’sinin erişilebilir olduğunu ve doğru yanıtlar gönderdiğini doğrulayın Platformlar arası sorunlar Tutarlı davranış için iOS, Android, masaüstü ve webde test edin ### Yayın öncesi test kontrol listesi Yayına almadan önce kullanıcı kimlik doğrulaması, etkileşimli öğeler ve API entegrasyonları dahil tüm temel işlevlerin doğru çalıştığını doğrulayın. Hata yönetiminin kullanıcıya uygun geri bildirim verdiğinden emin olun ve farklı ekran boyutları ile cihazlarda test edin. Akıcı performans için yükleme sürelerini ve yanıt hızını izleyin. ### Üretimde izleme Yayına aldıktan sonra hataları ve performansı izlemek için Sentry veya LogRocket gibi araçlar kullanın. API yanıt sürelerini izleyin, kullanıcı davranışlarını takip edin ve kritik sorunlar için uyarılar kurun. Düzenli izleme, sorunları hızla bulup çözmenize ve yüksek hizmet kalitesini korumanıza yardımcı olur. ## HTTPS gereksinimleri ve yayına alma konuları HTTPS gereksinimlerini anlamak, Mini App’i başarıyla yayına almak için kritik önemdedir. Telegram üretimde sıkı güvenlik standartları uygular; bunlara uymak en yaygın yayına alma sorunlarını önler. ### Ortama göre HTTPS gereksinimleri **Ortam** **Protokol desteği** **Sertifika gereksinimleri** **Kullanım alanı** Test ortamı HTTP ve HTTPS HTTP için sertifika gerekmez Yerel geliştirme ve test Üretim Yalnızca HTTPS Geçerli SSL/TLS sertifikası gerekir Canlı uygulamalar ve gerçek kullanıcılar Telegram, hassas verileri (kullanıcı bilgileri, kimlik doğrulama token’ları ve API istekleri) şifrelemek için tüm üretim Mini Apps’lerinde HTTPS zorunlu kılar. Test ortamı, yerel geliştirme için HTTP URL’lerine ve IP adreslerine (örneğin http://192.168.1.100:3000) izin verir. Üretim ortamı ise geçerli SSL sertifikalarıyla HTTPS’i kesinlikle zorunlu kılar; HTTP URL’leri reddedilir. ### SSL sertifikası edinme Birçok barındırma platformu yönetilen HTTPS sunar, ancak ücretler, sertifika desteği ve özel alan adı gereksinimleri ürüne ve plana göre değişir: - **Vercel** – Otomatik SSL, anında HTTPS URL’leri; React ve Next.js uygulamaları için mükemmel. - **Netlify** – Ücretsiz SSL sertifikaları, sürekli dağıtım; statik siteler için ideal. - **Heroku** – HTTPS ve özel alan adı sertifika yönetimi dağıtıma ve plana bağlıdır; her planda ücretsiz barındırma veya otomatik sertifika olduğunu varsaymayın. - **AWS/DigitalOcean** – Seçilen barındırma ürününe göre yönetilen sertifikalar veya elle yapılandırma kullanılabilir. Let’s Encrypt, elle kurulum için ücretsiz sertifikalar sunar. Ticari sağlayıcılar (DigiCert, Sectigo) çoğu Mini App için genellikle gereksiz olan ücretli sertifikalar sunar. ### Sık karşılaşılan sorunlar ve çözümleri **Sorun** **Çözüm** Geçersiz sertifika Kurulumu ve son kullanma tarihini SSL denetleyicileriyle (SSL Labs) doğrulayın Karışık içerik Tüm kaynakların (görseller, betikler ve API’ler) HTTPS URL’leri kullandığından emin olun Kendinden imzalı sertifikalar Kabul edilmez; güvenilir sertifika yetkililerini kullanın (Let’s Encrypt, DigiCert) Alan adı uyuşmazlığı Sertifika alan adıyla tam olarak eşleşmelidir; alt alan adları için wildcard kullanın ### Yayına alma akışı **Geliştirme aşaması:** Hızlı yineleme için test ortamında yerel sunucularla HTTP kullanın. **Üretim öncesi:** Otomatik HTTPS’li barındırmaya dağıtın, SSL sertifikasını doğrulayın, test ortamında HTTPS ile test edin ve tüm harici kaynakların HTTPS kullandığından emin olun. **Üretim:** BotFather’ı HTTPS URL’siyle güncelleyin, platformlar arasında test edin, sertifika süresini izleyin ve otomatik yenilemeyi etkinleştirin. ### En iyi uygulamalar Sunucu sırlarını ortam değişkenlerinde saklayın, API erişimini uygun şekilde kısıtlayın ve HTTPS kullanın. CORS istekleri doğrulamaz. DNS’i ve sertifika yenilemeyi kontrol edin; sertifika düzenleme süresi değişir ve belirli bir dakika içinde garanti edilmez. HTTPS, üretimdeki Mini Apps için temel bir gereksinimdir. Otomatik SSL sunan barındırma platformları seçmek, Telegram’ın güvenlik standartlarını verimli biçimde karşılamanızı sağlar. ## Telegram’a mini uygulama nasıl eklenir? Mini uygulamanız hazır ve test edilmişse kullanıcıların kullanabilmesi için onu Telegram’a ekleme zamanı gelmiştir. Telegram Mini Apps’in nasıl çalıştığını anlamak başarılı entegrasyon için çok önemlidir. ### Adım 1. Projeyi sunucuya yükleme İlk adım, mini uygulamanızı sunucuya yerleştirmektir. Bu, kullanıcıların ona her zaman erişebilmesi için gereklidir. Sunucu, uygulamanızın sürekli çalışmasını ve istekleri gerçek zamanlı işlemesini sağlar. Bunu şöyle yapabilirsiniz: Her bileşene uygun barındırmayı seçin: arayüz için statik barındırma, bot için ise sürekli çalışan bir işlem veya desteklenen webhook işlevleri. Heroku’nun veya başka bir platformun ücretsiz olduğunu varsaymak yerine güncel fiyatları kontrol edin. Bot token’larını veya diğer sırları yayımlamadan bir depodan dağıtım yapın. Dağıtımdan sonra barındırma hizmetiniz, mini uygulamanızın çevrim içi erişilebileceği bir uygulama URL’si sağlar. ### Adım 2. Botu bağlama ve uygulama URL’sini yapılandırma Barındırmadan sonra Mini App’in HTTPS URL’sini BotFather’daki uygulama veya menü düğmesi ayarlarına girin. Bot token’ı sunucudan sunucuya Bot API çağrıları içindir; web arayüzüne gömülecek bir erişim anahtarı değildir. BOT\_TOKEN’ı yalnızca bot sunucusunun ortamında saklayın. Telegram bot güncellemeleri ve Mini App tarayıcı istekleri ayrı akışlardır: web uygulamasını göstermek için her tıklamayı bot üzerinden geçirmek gerekmez. Üretimde HTTPS kullanın ve kullanıcı kimliğinin önemli olduğu yerlerde initData’yı backend’de doğrulayın. ### Adım 3. Kurulum ve uygulama entegrasyonu Mini uygulamanızın Telegram’da tam olarak çalışması için sistemi doğru yapılandırmanız ve kullanıcıların etkileşime girebileceği öğeler eklemeniz gerekir. En iyi kullanıcı deneyimi için uygulamanızın doğrudan Telegram içinde açıldığından emin olun. Webhook’u yapılandırma Webhook, botunuz için Bot API güncellemelerini alır; Mini App’teki her tarayıcı tıklamasını otomatik olarak almaz. Yalnızca polling yerine webhook seçerseniz yapılandırın. Aynı bot için getUpdates polling’i ve etkin webhook’u aynı anda kullanmayın. Düğmeleri ve komutları ayarlama Kullanıcıların Telegram Mini App’inizi kolayca başlatabilmesi için sezgisel düğmeler ve komutlar ekleyin. Örneğin “Başlat”, “Aç” veya uygulamanızın işlevine uygun başka düğmeler olabilir. Kolay gezinme için bir menü düğmesi eklemeyi düşünün; bu aynı zamanda bot menü düğmesi olarak da kullanılabilir. Bu düğmeler, kullanıcıların metin komutu girmeden doğrudan sohbette mini uygulamanızla etkileşim kurmasını sağlar. Telegram arayüzü akıcı bir etkileşim sunmalı, botunuz da tüm bu etkileşimleri sorunsuz işlemelidir. Uygulamanızda oyun başlatma veya yardım çağırma gibi belirli eylemleri etkinleştirecek komutlar ayarlayın. Her parametreyi doğru işlediğinizden emin olun. Komutları ve eylemleri işleme Uygulamanızın kullanıcı eylemlerine doğru yanıt vermesi önemlidir. Kullanıcı bir düğmeye tıkladığında veya komut girdiğinde uygulama uygun yanıtı göndermeli ya da mini uygulamanın ilgili işlevini etkinleştirmelidir. Bu, akıcı ve kullanışlı bir etkileşim sağlar. Botunuz çeşitli senaryoları ve uç durumları işleyecek şekilde programlanmalıdır. ### Adım 4. Test ve başlatma Her şey hazır olduğunda mini uygulamanızı test etme zamanı gelmiştir: Sunucunun doğru çalıştığından ve HTTPS üzerinden çevrim içi erişilebilir olduğundan emin olun. Telegram’a giriş yapın ve uygulamanızı açın. Yapılandırdığınız düğmelere tıklayın ve uygulamanın beklediğiniz gibi çalıştığını doğrulayın. Komutlara doğru yanıt verdiğinden ve sistemle etkileşim kurduğundan emin olun. Kurulumdan sonra hedef kullanıcıların uygulamaya erişebildiğini; izinlerin, backend hizmetlerinin ve bölgesel erişilebilirliğin doğru olduğunu doğrulayın. Yayını genişletmeden önce hataları ve gerçek kullanımı izleyin. Mini uygulamanızı BotFather ile ayarlama Geliştirme sürecini tamamladıktan sonra uygulamanızı doğru yapılandırmanız gerekir. Telegram Mini App oluştururken doğru adımları izlemek çok önemlidir. Uygulamanız hazır olduğunda son yapılandırmaya geçebilirsiniz. BotFather’a dönün ve mini uygulama ayarlarınızı yapılandırın. Kullanıcıların paylaşabileceği doğrudan bir bağlantı oluşturabilir ve uygulamanızın Telegram gruplarında iyi çalıştığından emin olabilirsiniz. Telegram platformu hem Android hem iOS cihazları destekler; bu nedenle uygulamanızın her iki sistemle de uyumlu olduğundan emin olun. Uygulamanızı tasarlarken Telegram’ın arayüz yönergelerini dikkate alın. Kullanıcılar, cihaz türünden bağımsız olarak mini uygulamayı açarken akıcı bir deneyim yaşamalıdır. Mini uygulamanızı optimize edin ve mevcut işlevlerden en iyi şekilde yararlanın. Kullanıcılar en iyi deneyim için uygulamanıza doğrudan Telegram arayüzünden erişebilir. Gerekli tüm özellikler eklendiğinde uygulamanız, kullanıcılarınız için kapsamlı bir çözüm sunar. ## AdsGram ile mini uygulama tanıtımı Mini uygulamanız artık etkin olduğuna göre onu tanıtmak için AdsGram’ı kullanabilirsiniz. Platformumuz, Telegram mini uygulamaları ve oyunlarına özel reklamlar ayarlamanıza olanak tanır. Daha geniş erişim için Telegram Ads’i de kullanabilirsiniz. Şunları yapabilirsiniz: Uygulamanıza daha fazla kullanıcı çekmek için reklam kampanyası oluşturun. Reklamları doğru bölgelerde göstermek ve kaliteli trafik almak için coğrafi hedefleme kullanın. Kullanıcı etkileşimini artırmak için ödüllü videolar veya bannerlar gibi oyunlara ve mini uygulamalara uygun reklam formatlarını optimize edin. AdsGram ile uygulamanızı etkili biçimde tanıtabilir ve yeni kullanıcılar kazanabilirsiniz. Mini uygulamanızı başlatırken ve tanıtırken başarılar! ![Elizaveta Bydanova](https://image.adsgram.ai/site/elizaveta-bydanova.webp) Elizaveta Bydanova İş Geliştirme Takım Lideri, Adsgram ## Sonrakini oku Sektördeki en son haberler, röportajlar, teknolojiler ve kaynaklar [Tüm yazıları gör](/tr/blog) ### Etkili reklamcılık için hepsi bir arada otomatik platform Reklam yolculuğunuza bugün bizimle başlayın. [Reklamveren Girişi](https://traffic.adsgram.ai/registration?code=NewDirectUser) [Yayıncı Girişi](https://partner.adsgram.ai/registration?code=NewDirectUser)