Telegram Mini Apps

Telegram Mini Apps (TMA) — platform terbuka untuk menjalankan web‑aplikasi dan game di dalam Telegram. Aplikasi dibangun dengan stack standar HTML/CSS/JavaScript, dibuka melalui tautan dari obrolan atau tombol bot, dan menggunakan kemampuan bawaan messenger: otorisasi, pembayaran, pertukaran media, pengiriman Stars dan hadiah.

Platform ini menjadi titik masuk utama ke ekosistem TON — kebanyakan pengguna aplikasi TON pertama kali melihat dApp sebagai Mini App, bukan sebagai situs web atau aplikasi seluler.

Fitur#

• Satu klien. Mini App berjalan di dalam aplikasi Telegram yang sama, di mana pengguna sudah terotentikasi — di Android, iOS, Windows, macOS, dan Linux.
• Ambang rendah. Stack web yang familiar, tidak perlu publikasi ke toko aplikasi, pembaruan instan: cukup deploy build baru.
• Otorisasi tanpa seed‑phrase. Melalui TON Connect aplikasi terhubung ke dompet pengguna dan meminta tanda tangan tanpa mengirimkan kunci pribadi.
• Pembayaran. Mendukung pembayaran kripto dalam TON dan Jettons, serta mata uang internal Telegram — Stars.
• Bot sebagai server. Mini App biasanya berpasangan dengan Telegram‑bot: bot menyimpan status, mengirim notifikasi, dan memulai dialog.

Cara Membuat Mini App#

Jalur lengkap hingga peluncuran aplikasi:

1. Buat Telegram‑bot melalui BotFather dengan perintah /newbot.
2. Daftarkan Mini App: perintah /newapp di BotFather, pilih bot yang sudah dibuat, dan kaitkan aplikasi padanya. Setelah pendaftaran Mini App dapat diakses melalui tautan https://t.me/{bot}/{app}.
3. Publikasikan web‑aplikasi via HTTPS dengan sertifikat SSL yang valid. Di sandbox dapat menggunakan IP, tetapi di produksi Telegram akan menolak skema lain.
4. Tambahkan tombol peluncuran: perintah /setmenubutton menetapkan Mini App pada tombol menu bot. Alternatifnya — tautan langsung melalui /myapps → Edit link.

Setelah itu aplikasi tersedia dari tombol menu, tautan langsung, atau dari obrolan mana pun yang membagikan undangan.

Pembayaran dan Monetisasi#

Mini App dapat menghasilkan pendapatan dengan beberapa cara:

• Pembelian dalam game dan langganan — dalam Stars atau dalam TON melalui transaksi yang ditandatangani;
• Pembayaran kripto — pengguna mengonfirmasi transaksi di dompet yang terhubung (Tonkeeper, Wallet, MyTonWallet, dll.) melalui TON Connect;
• Iklan dan afiliasi — atribusi mandiri melalui start_param, kode referral, pembayaran melalui TON.

Untuk mempromosikan proyek TON tersedia jaringan iklan Telegram Ads. Iklan tidak menggunakan data pribadi pengguna — penargetan berdasarkan konteks kanal. Anggaran dapat dibayar langsung dalam TON.

Katalog dan Promosi#

• Telegram Apps Center — katalog aplikasi dan bot pihak ketiga; tersedia di tapps.center.
• Trending Apps (t.me/trendingapps) — kanal yang mempublikasikan TMA baru dan pembaruan besar; dimoderasi komunitas.
• The Open League (Open_league_bot) — aplikasi yang mengagregasi proyek yang berpartisipasi dalam program hibah dan insentif; memberikan tautan langsung ke pool STON.fi dan DeDust.

Aplikasi Terkenal#

• Notcoin dan Hamster Kombat — game tap‑to‑earn, pemimpin dalam jangkauan kategori TMA;
• Wallet — dompet terintegrasi di Telegram dengan kripto, pasar P2P, dan multi‑cek;
• STON.fi — DEX di TON dengan antarmuka yang berjalan langsung di dalam Telegram;
• DeDust — DEX besar kedua di ekosistem TON dengan front‑end TMA;
• Getgems — pasar NFT dengan versi Mini App.

Telegram Mini Apps 2.0#

Pada November 2024 Telegram merilis pembaruan besar platform, memperluas kemampuannya hingga setara aplikasi native:

• Mode layar penuh dalam orientasi vertikal dan horizontal;
• Akses ke sensor — akselerometer dan giroskop untuk kontrol dalam game;
• Lencana di layar utama — Mini App dapat dipasang berdampingan dengan aplikasi biasa;
• Geolokasi — peta, geo‑game, pencarian lokal;
• Stiker dan TON Gifts — mengirim hadiah dan pencapaian dengan Stars langsung dari obrolan;
• Status emoji untuk Premium — pengaturan melalui aplikasi;
• Dokumen dan media — menghasilkan file, kartu referral, meme;
• Langganan — monetisasi berulang dalam Stars;
• Kustomisasi layar pemuatan;
• Informasi perangkat yang diperluas — untuk menyesuaikan grafis dan performa.

Pembaruan ini memindahkan sebagian pola UX dari sistem operasi seluler ke Telegram, menjadikan Mini App antarmuka kompetitif untuk dompet kripto, game, dan social‑commerce.

Kebijakan Blockchain Telegram#

Telegram menerbitkan panduan penggunaan blockchain dalam bot dan Mini Apps. Aturan utama:

• gunakan hanya TON untuk penerbitan dan distribusi token atau aset blockchain;
• hubungkan dompet hanya melalui TON Connect;
• jangan promosikan dompet yang tidak berbasis TON dan tidak memakai TON Connect.

Pelanggaran aturan dapat mengakibatkan pemblokiran Mini App di katalog Telegram.

Alat Pengembang#

• @twa-dev/sdk dan @telegram-apps/sdk — SDK resmi/komunitas untuk bekerja dengan Telegram WebApp API;
• @tonconnect/ui-react — lapisan UI siap pakai untuk menghubungkan dompet di dalam TMA;
• Dokumentasi:
  • core.telegram.org/bots/webapps — spesifikasi WebApp API,
  • docs.telegram-mini-apps.com — dokumentasi komunitas yang diperluas,
  • docs.ton.org/develop/dapps/telegram-apps/ — panduan integrasi dari TON Foundation.

Lihat jugaLihat juga#

• TON Connect
• The Open Network
• The Open League
• Tonkeeper
• Notcoin
• Hamster Kombat