O Mini App Tester permite testar a API JavaScript de Mini Apps do Telegram (Telegram.WebApp) sem escrever código. Em um navegador comum, ele roda em modo mock e emula a API; aberto dentro do Telegram, conversa com a API real do cliente. Use-o para testar um recurso de Telegram Mini App antes de implementá-lo ou para ver como cada cliente se comporta.
Telegram.WebApp.https://telegram-bot-api.info/telegram-mini-app-tester.html como URL do Mini App de um bot no @BotFather (/newapp ou as configurações do botão de menu). Não precisa de hospedagem.version, platform, colorScheme, initData, themeParams e as áreas seguras.ready, expand, close, cores do cabeçalho e do fundo.showPopup, showAlert, showConfirm e o leitor de QR code.openInvoice, shareToStory, status de emoji, tela cheia e downloadFile.O log de eventos registra mais de 45 eventos com horário, como themeChanged, viewportChanged, mainButtonClicked e fullscreenChanged, para você ver exatamente o que seus handlers vão receber.
Um Mini App é uma página web aberta dentro do Telegram. Para criar o seu, você precisa de um bot (veja como criar um bot no Telegram e como obter o token), de uma página servida por HTTPS que carregue https://telegram.org/js/telegram-web-app.js e de um ponto de entrada: /newapp, o botão de menu ou um botão de teclado com o campo web_app, enviado como mostra o guia como enviar mensagens pela Bot API. Antes de escrever o seu código, use o tester para ver quais chamadas existem e o que cada uma retorna.
Os Mini Apps se chamavam originalmente Web Apps, por isso o objeto da API ainda é Telegram.WebApp. O modo mock serve para interface e fluxo: mostra quais chamadas existem, o que retornam e quais eventos disparam. Ele não reproduz popups nativos, feedback háptico nem dados reais do usuário, e o seu initData é um exemplo que o Telegram nunca assinou. Dentro do Telegram, o tester usa a API real: o initData é autêntico, cada chamada chega ao cliente de verdade e a interface acompanha o idioma do usuário.
O tester roda inteiramente no seu navegador, não precisa de token de bot e não chama a Bot API. O armazenamento emulado do modo mock fica no localStorage do navegador.
Para apontar o botão de menu para o seu Mini App pela API, chame setChatMenuButton no Bot API Tester e consulte qualquer método no Swagger ou na referência de métodos.
Abra o Mini App Tester em qualquer navegador. O modo mock emula o Telegram.WebApp, então você pode chamar métodos, disparar eventos e inspecionar propriedades sem bot nem cliente do Telegram.
Um bot criado no @BotFather, uma página web servida por HTTPS que carregue o script telegram-web-app.js e um ponto de entrada: /newapp, o botão de menu ou um botão de teclado com o campo web_app.
Sim. Defina https://telegram-bot-api.info/telegram-mini-app-tester.html como URL do Mini App no @BotFather, pelo /newapp ou nas configurações do botão de menu. Dentro do Telegram ele usa a API WebApp real, e você não precisa de hospedagem.
Os métodos principais do WebApp, MainButton, SecondaryButton, BackButton e SettingsButton, popups, HapticFeedback, CloudStorage, DeviceStorage, SecureStorage, sensores, biometria, localização, permissões, faturas e stories, status de emoji, tela cheia e download de arquivos, além de um log com mais de 45 eventos.
Não. O modo mock usa dados de exemplo que o Telegram nunca assinou, então eles falham na validação HMAC de propósito. Abra o tester dentro do Telegram para obter um initData real e testar a validação no seu servidor.
Não. A página não chama a Bot API. Você só precisa de um bot se quiser abrir o tester dentro do Telegram como Mini App.