Mini App Tester

Mock
ID
Properti
version
—
platform
—
colorScheme
—
isActive
—
isExpanded
—
isFullscreen
—
isOrientationLocked
—
isClosingConfirmation
—
isVerticalSwipes
—
viewportHeight
—
viewportStableH
—
headerColor
—
backgroundColor
—
bottomBarColor
—
initData
initDataUnsafe
Parameter tema
bg_color
text_color
hint_color
link_color
button_color
button_text_color
secondary_bg_color
header_bg_color
bottom_bar_bg_color
accent_text_color
section_bg_color
section_header_text_color
section_separator_color
subtitle_text_color
destructive_text_color
WebApp 18
ready()
expand()
close()
sendData()
switchInlineQuery()
setHeaderColor()
setBackgroundColor()
setBottomBarColor()
enableClosingConfirmation()
disableClosingConfirmation()
enableVerticalSwipes()
disableVerticalSwipes()
requestFullscreen()
exitFullscreen()
lockOrientation()
unlockOrientation()
openLink()
openTelegramLink()
isVersionAtLeast()
hideKeyboard()
Tombol 4
MainButton
Klik tombol ini akan memicu event mainButtonClicked
SecondaryButton
BackButton
BackButton
Klik akan memicu event backButtonClicked
SettingsButton
SettingsButton
Klik akan memicu event settingsButtonClicked
Popup & peringatan 5
showAlert()
showConfirm()
showPopup()
showScanQrPopup()
readTextFromClipboard()
Umpan balik haptik 3
impactOccurred()
notificationOccurred()
selectionChanged()
Penyimpanan cloud 6
setItem()
getItem()
getKeys()
removeItem()
Penyimpanan perangkat 4
setItem()
getItem()
removeItem()
clear()
Penyimpanan aman 5
setItem()
getItem()
restoreItem()
removeItem()
clear()
Sensor 3
Accelerometer
DeviceOrientation
Gyroscope
Biometrik 5
init()
requestAccess()
authenticate()
updateBiometricToken()
openSettings()
Lokasi 3
LocationManager.init()
LocationManager.getLocation()
LocationManager.openSettings()
Invoice & story 3
openInvoice()
shareMessage()
Izin & autentikasi 3
requestWriteAccess()
requestContact()
requestChat()
Emoji, layar, file 5
Home Screen
addToHomeScreen()
checkHomeScreenStatus()
Emoji Status
File Download
Log event 0
Memantau 45 event
Belum ada event. Jalankan metode di atas untuk memicu event.

Mini App Tester membantu Anda tes Mini App Telegram tanpa menulis kode: fitur JavaScript API Telegram.WebApp bisa dicoba langsung. Di browser biasa, alat ini berjalan dalam mode mock yang meniru API; saat dibuka di dalam Telegram, alat ini memakai API asli dari klien yang sedang digunakan. Cocok untuk mencoba fitur Telegram Mini App sebelum Anda membuatnya sendiri, atau untuk melihat perilaku klien tertentu.

Cara tes Mini App Telegram

  1. Buka halaman ini di browser apa saja. Mode mock aktif otomatis dan meniru Telegram.WebApp.
  2. Buka salah satu dari 13 grup metode, panggil metodenya, lalu pantau hasilnya di log event dan panel properti yang diperbarui secara langsung.
  3. Untuk menguji di dalam Telegram, pasang https://telegram-bot-api.info/telegram-mini-app-tester.html sebagai URL Mini App bot Anda di @BotFather (/newapp atau pengaturan tombol menu). Tidak perlu hosting.
  4. Buka di iOS, Android, dan desktop, lalu bandingkan version, platform, colorScheme, initData, themeParams, dan safe area.

Di dalam Telegram, antarmuka tester otomatis mengikuti bahasa pengguna, termasuk bahasa Indonesia.

Fitur yang bisa diuji

Log event mencatat 45+ event lengkap dengan waktunya, seperti themeChanged, viewportChanged, mainButtonClicked, dan fullscreenChanged, sehingga Anda bisa melihat persis apa yang akan diterima handler Anda.

Tes Telegram Web App: mode mock vs. Telegram asli

Mini App dulu bernama Web App, karena itu objek API-nya masih bernama Telegram.WebApp. Mode mock cocok untuk menguji UI dan alur: terlihat panggilan apa saja yang tersedia, apa hasilnya, dan event apa yang dipicu, sementara penyimpanan diemulasikan di localStorage. Namun mode ini tidak bisa meniru popup native, getaran haptik, atau data pengguna sungguhan, dan initData-nya hanya contoh yang tidak pernah ditandatangani Telegram. Di dalam Telegram, tester beralih ke API asli, sehingga initData asli dan setiap panggilan benar-benar sampai ke klien.

Privasi

Tester berjalan sepenuhnya di browser Anda, tidak memerlukan token bot, dan tidak memanggil Bot API. Data penyimpanan pada mode mock tetap berada di localStorage browser Anda.

Membuat Mini App Telegram: langkah berikutnya

Untuk membuat Mini App Telegram, Anda butuh bot dan halaman web yang bisa diakses lewat HTTPS. Mulailah dengan cara membuat bot Telegram dan cara mendapatkan token bot. Tombol menu yang membuka Mini App bisa dipasang lewat API dengan setChatMenuButton di Bot API Tester; detail setiap metode ada di Swagger dan referensi metode. Mini App yang dibuka dari tombol keyboard bisa mengirim data ke bot dengan sendData; data itu tiba sebagai pesan berisi web_app_data, jadi bot perlu menerima update lewat getUpdates atau webhook (lihat panduan webhook bot Telegram).

Pertanyaan umum

Bagaimana cara tes Mini App Telegram online tanpa Telegram?

Buka Mini App Tester di browser apa saja. Mode mock-nya meniru Telegram.WebApp, jadi Anda bisa memanggil metode, memicu event, dan memeriksa properti tanpa bot maupun aplikasi Telegram.

Bisakah Mini App Tester dipakai sebagai Mini App bot saya?

Bisa. Pasang https://telegram-bot-api.info/telegram-mini-app-tester.html sebagai URL Mini App di @BotFather, lewat /newapp atau pengaturan tombol menu. Di dalam Telegram, tester memakai WebApp API asli, dan Anda tidak perlu hosting sendiri.

Fitur Telegram WebApp API apa saja yang bisa diuji?

Metode inti WebApp, MainButton, SecondaryButton, BackButton, SettingsButton, popup, HapticFeedback, CloudStorage, DeviceStorage, SecureStorage, sensor, biometrik, lokasi, izin, invoice dan story, status emoji, layar penuh, serta unduhan file, ditambah log untuk 45+ event.

Apakah initData di mode mock valid?

Tidak. Mode mock memakai data contoh yang tidak pernah ditandatangani Telegram, sehingga memang sengaja gagal validasi HMAC. Buka tester di dalam Telegram untuk mendapatkan initData asli guna menguji validasi di server Anda.

Apakah perlu token bot untuk memakai Mini App Tester?

Tidak. Halaman ini sama sekali tidak memanggil Bot API. Bot hanya diperlukan jika Anda ingin membuka tester di dalam Telegram sebagai Mini App.

Apa saja yang dibutuhkan untuk membuat Mini App Telegram?

Sebuah bot dari @BotFather dan halaman web yang bisa diakses lewat HTTPS. Halaman itu memuat skrip https://telegram.org/js/telegram-web-app.js, lalu URL-nya dipasang di bot, misalnya lewat /newapp, tombol menu, atau tombol dengan field web_app.