Mini App Tester

Simulación
Propiedades
version
—
platform
—
colorScheme
—
isActive
—
isExpanded
—
isFullscreen
—
isOrientationLocked
—
isClosingConfirmation
—
isVerticalSwipes
—
viewportHeight
—
viewportStableH
—
headerColor
—
backgroundColor
—
bottomBarColor
—
initData
initDataUnsafe
Parámetros del 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()
Botones 4
MainButton
Al hacer clic en el botón se dispara el evento mainButtonClicked
SecondaryButton
BackButton
BackButton
El clic dispara el evento backButtonClicked
SettingsButton
SettingsButton
El clic dispara el evento settingsButtonClicked
Popups y alertas 5
showAlert()
showConfirm()
showPopup()
showScanQrPopup()
readTextFromClipboard()
Respuesta háptica 3
impactOccurred()
notificationOccurred()
selectionChanged()
Almacenamiento en la nube 6
setItem()
getItem()
getKeys()
removeItem()
Almacenamiento del dispositivo 4
setItem()
getItem()
removeItem()
clear()
Almacenamiento seguro 5
setItem()
getItem()
restoreItem()
removeItem()
clear()
Sensores 3
Accelerometer
DeviceOrientation
Gyroscope
Biometría 5
init()
requestAccess()
authenticate()
updateBiometricToken()
openSettings()
Ubicación 3
LocationManager.init()
LocationManager.getLocation()
LocationManager.openSettings()
Factura e historia 3
openInvoice()
shareMessage()
Permisos y autorización 3
requestWriteAccess()
requestContact()
requestChat()
Emoji, pantalla, archivo 5
Home Screen
addToHomeScreen()
checkHomeScreenStatus()
Emoji Status
File Download
Registro de eventos 0
Escuchando 45 eventos
No hay eventos. Usa los métodos de arriba para generarlos.

Mini App Tester te permite probar la API de JavaScript de Telegram Mini App (Telegram.WebApp) sin escribir código. En un navegador normal funciona en modo simulado y emula la API; si lo abres dentro de Telegram, usa la API real del cliente. Sirve para probar una función de tu Telegram Mini App antes de programarla o para ver cómo se comporta un cliente concreto.

Cómo probar una Mini App de Telegram con el tester

  1. Abre esta página en cualquier navegador. El modo simulado se activa automáticamente y emula Telegram.WebApp.
  2. Despliega uno de los 13 grupos de métodos, ejecuta llamadas y sigue los resultados en el registro de eventos y en el panel de propiedades en vivo.
  3. Para probar dentro de Telegram, configura https://telegram-bot-api.info/telegram-mini-app-tester.html como URL de la Mini App de un bot en @BotFather (/newapp o la configuración del botón de menú). No necesitas hosting.
  4. Ábrelo en iOS, Android y escritorio, y compara version, platform, colorScheme, initData, themeParams y las áreas seguras.

Qué puedes probar

El registro guarda más de 45 eventos con su hora, como themeChanged, viewportChanged, mainButtonClicked y fullscreenChanged, para que veas exactamente qué recibirán tus handlers.

Modo simulado vs. Telegram real

Las Mini Apps antes se llamaban Web Apps; por eso el objeto de la API sigue siendo Telegram.WebApp. El modo simulado sirve para la interfaz y el flujo: muestra qué llamadas existen, qué devuelven y qué eventos se disparan, y emula el almacenamiento en localStorage. No reproduce los popups nativos, la respuesta háptica ni los datos reales del usuario, y su initData es un ejemplo que Telegram nunca firmó. Dentro de Telegram el tester cambia a la API real: initData es auténtico, cada llamada llega al cliente y la interfaz se muestra en el idioma del usuario.

Crear una Mini App de Telegram: por dónde empezar

Para crear una Mini App de Telegram primero necesitas un bot: sigue cómo crear un bot de Telegram y obtén su token. La Mini App en sí es una página web servida por HTTPS que carga https://telegram.org/js/telegram-web-app.js; prueba aquí cada método antes de usarlo en tu código. Para abrirla desde un chat privado, envía un teclado inline con un botón web_app (ve cómo enviar mensajes con la Bot API) o configura el botón de menú con setChatMenuButton en Bot API Tester.

Privacidad y más herramientas

El tester funciona por completo en tu navegador, no necesita token de bot y no llama a la Bot API. El almacenamiento simulado se queda en el localStorage de tu navegador. Para consultar cualquier método de la Bot API, abre Swagger o la referencia de métodos.

Preguntas frecuentes

¿Cómo puedo probar una Mini App de Telegram online sin Telegram?

Abre Mini App Tester en cualquier navegador. Su modo simulado emula Telegram.WebApp, así que puedes llamar a métodos, disparar eventos e inspeccionar propiedades sin bot ni cliente de Telegram.

¿Puedo usar Mini App Tester como la Mini App de mi bot?

Sí. Configura https://telegram-bot-api.info/telegram-mini-app-tester.html como URL de la Mini App en @BotFather, con /newapp o en la configuración del botón de menú. Dentro de Telegram usa la API WebApp real y no necesitas hosting.

¿Qué necesito para crear una Mini App de Telegram?

Un bot creado con /newbot en @BotFather y una página web servida por HTTPS que cargue el script https://telegram.org/js/telegram-web-app.js. Después registras su URL en @BotFather con /newapp o como botón de menú.

¿Qué funciones de la API WebApp de Telegram cubre?

Los métodos básicos de WebApp, MainButton, SecondaryButton, BackButton y SettingsButton, popups, HapticFeedback, CloudStorage, DeviceStorage, SecureStorage, sensores, biometría, ubicación, permisos, facturas e historias, estado con emoji, pantalla completa y descarga de archivos, además de un registro de más de 45 eventos.

¿El initData del modo simulado es válido?

No. El modo simulado usa datos de ejemplo que Telegram nunca firmó, así que, por diseño, no pasan la validación HMAC. Abre el tester dentro de Telegram para obtener un initData real y probar la validación en tu servidor.

¿Necesito un token de bot para usar Mini App Tester?

No. La página no llama a la Bot API. Solo necesitas un bot si quieres abrir el tester dentro de Telegram como Mini App.