Telegram Mini Uygulamaları

Telegram Mini Apps (TMA) — Telegram içinde web uygulamaları ve oyunları çalıştırmak için açık bir platform. Uygulamalar standart HTML/CSS/JavaScript yığınıyla oluşturulur, sohbetten ya da bot düğmesinden bir bağlantı ile açılır ve mesajlaşma uygulamasının yerleşik özelliklerini kullanır: yetkilendirme, ödemeler, medya alışverişi, yıldız ve hediye gönderimi.

Platform, ekosisteme giriş noktasının anahtarı haline geldi; çoğu TON‑uygulamasını ilk kez bir Mini App olarak görür, tarayıcı sitesi ya da mobil uygulama olarak değil.

Özellikler#

Tek istemci. Mini App, kullanıcının zaten oturum açtığı aynı Telegram uygulamasında çalışır — Android, iOS, Windows, macOS ve Linux’ta.
Düşük eşik. Tanıdık web yığını, uygulama mağazalarına yayınlama zorunluluğu yok, anlık güncelleme: yeni bir derleme dağıtmak yeterli.
Seed ifadesi olmadan yetkilendirme. TON Connect aracılığıyla uygulama, kullanıcının cüzdanına bağlanır ve özel anahtarları iletmeden imza talep eder.
Ödemeler. TON ve Jetton’larda kripto‑ödemeler, ayrıca Telegram’un iç para birimi — Stars desteklenir.
Bot sunucu olarak. Mini App genellikle bir Telegram botu ile birlikte çalışır: bot durum tutar, bildirim gönderir ve diyalog başlatır.

Mini App Nasıl Oluşturulur#

Uygulamanın yayına alınmasına kadar tam yol haritası:

/newbot komutuyla BotFather üzerinden bir Telegram botu oluştur.
Mini App’i kaydet: BotFather’da /newapp komutunu kullan, önceden oluşturduğun botu seç ve uygulamayı ona bağla. Kayıt sonrası Mini App https://t.me/{bot}/{app} bağlantısıyla erişilebilir.
Geçerli bir SSL sertifikasına sahip HTTPS üzerinden web uygulamasını yayınla. Test ortamında IP kullanılabilir, ancak üretimde Telegram başka bir şemayı reddeder.
Başlat düğmesini bağla: /setmenubutton komutu bot menüsü düğmesine Mini App’i ekler. Alternatif olarak /myapps üzerinden doğrudan bağlantı Edit link ile verilir.

Bu adımlardan sonra uygulama menü düğmesinden, doğrudan bağlantıdan ya da davet edilen herhangi bir sohbetten erişilebilir.

Ödemeler ve Paraya Çevirme#

Mini App çeşitli yollarla gelir elde edebilir:

Oyun içi satın alımlar ve abonelikler — Stars ya da TON üzerinden imzalı işlemlerle;
Kripto ödemeler — kullanıcı, bağlandığı cüzdanda (Tonkeeper, Wallet, MyTonWallet vb.) işlemi onaylar; bu işlem TON Connect ile gerçekleşir;
Reklam ve ortaklıklar — start_param üzerinden kendi atıflamanız, referans kodları, TON üzerinden ödemeler.

TON projelerinin tanıtımı için Telegram Ads reklam ağı mevcuttur. Reklam, kullanıcı kişisel verilerini kullanmaz; hedefleme kanal bağlamına göre yapılır. Bütçeyi doğrudan TON’da ödeyebilirsiniz.

Katalog ve Tanıtım#

Telegram Apps Center — üçüncü taraf uygulama ve bot kataloğu; tapps.center adresinde bulunur.
Trending Apps (t.me/trendingapps) — yeni TMA’ları ve büyük güncellemeleri yayınlayan kanal; topluluk tarafından denetlenir.
The Open League (Open_league_bot) — aynı adlı grant ve teşvik programı projelerini toplayan uygulama; STON.fi ve DeDust havuzlarına doğrudan bağlantılar sunar.

Bilinen Uygulamalar#

Notcoin ve Hamster Kombat — tap‑to‑earn oyunları, TMA kategorisinde erişim rekorları kırdı;
Wallet — Telegram içinde kripto, P2P market ve çoklu çekler sunan yerleşik cüzdan;
STON.fi — Telegram içinde çalışan bir TON DEX’i;
DeDust — TON ekosisteminin ikinci büyük DEX’i, TMA arayüzüyle;
Getgems — Mini App versiyonlu NFT market yeri.

Telegram Mini Apps 2.0#

Kasım 2024’te Telegram, platformu yerel uygulama seviyesine çıkaran büyük bir güncelleme yayınladı:

Tam ekran modu dikey ve yatay yönelimde;
Sensörlere erişim — oyun kontrolü için ivmeölçer ve jiroskop;
Ana ekranda kısayol — Mini App, normal uygulamalar gibi yanına sabitlenebilir;
Coğrafi konum — haritalar, geo‑oyunlar, yerel arama;
Sticker ve TON Gifts — Stars ile doğrudan sohbetten hediye ve rozet gönderimi;
Premium için emoji‑durumlar — uygulama üzerinden ayarlanır;
Belge ve medya — dosya, referans kart, meme üretimi;
Abonelikler — Stars ile tekrarlayan gelir modeli;
Başlangıç ekranı özelleştirme;
Gelişmiş cihaz bilgisi — grafik ve performans uyarlaması için.

Güncelleme, mobil işletim sistemlerinden gelen UX kalıplarını Telegram’a taşıyarak Mini App’i kripto cüzdanları, oyunlar ve sosyal‑ticaret için rekabetçi bir arayüz hâline getiriyor.

Telegram’ın Blokzincir Politikası#

Telegram, botlarda ve Mini App’lerde blokzincir ile çalışmaya dair rehber yayınladı. Temel kurallar:

token ya da blokzincir varlıkları yalnızca TON üzerinden ihraç ve dağıtılmalı;
cüzdanlar yalnızca TON Connect aracılığıyla bağlanmalı;
TON temelli olmayan ve TON Connect kullanmayan cüzdanların tanıtımı yasaktır.

Kurallara uyulmaması, Mini App’in Telegram kataloglarından kaldırılmasına yol açabilir.

Geliştirici Araçları#

@twa-dev/sdk ve @telegram-apps/sdk — Telegram WebApp API ile çalışmak için resmi/topluluk SDK’ları;
@tonconnect/ui-react — TMA içinde cüzdan bağlama için hazır UI katmanı;
Dokümantasyon:
- core.telegram.org/bots/webapps — WebApp API spesifikasyonu,
- docs.telegram-mini-apps.com — topluluk tarafından genişletilmiş dokümantasyon,
- docs.ton.org/develop/dapps/telegram-apps/ — TON Foundation entegrasyon rehberi.