Telegram Mini Apps (TMA) — plataforma aberta para execução de web‑apps e jogos dentro do Telegram. Os aplicativos são construídos com o stack padrão HTML/CSS/JavaScript, são abertos por link em um chat ou botão de bot e utilizam os recursos integrados do mensageiro: autorização, pagamentos, troca de mídia, envio de Stars e presentes.
A plataforma se tornou o ponto de entrada principal para o ecossistema TON — a maioria dos usuários de aplicativos TON vê a dApp primeiro como Mini App, e não como site de navegador ou aplicativo móvel.
Características#
- Um único cliente. Mini App funciona no próprio aplicativo Telegram, onde o usuário já está autenticado — em Android, iOS, Windows, macOS e Linux.
- Baixa barreira. Stack web familiar, sem necessidade de publicação em lojas de aplicativos, atualização instantânea: basta fazer o deploy da nova build.
- Autorização sem seed‑phrase. Via TON Connect o aplicativo se conecta à carteira do usuário e solicita assinatura sem transmitir chaves privadas.
- Pagamentos. São suportados pagamentos cripto em TON e Jettons, além da moeda interna do Telegram — Stars.
- Bot como servidor. Mini App normalmente opera em conjunto com um bot do Telegram: o bot armazena estado, envia notificações e inicia diálogos.
Como criar um Mini App#
Caminho completo até o lançamento do aplicativo:
- Crie um bot no Telegram através do BotFather com o comando
/newbot. - Registre o Mini App: comando
/newappno BotFather, escolha o bot criado anteriormente e vincule o aplicativo a ele. Após o registro, o Mini App fica disponível no linkhttps://t.me/{bot}/{app}. - Publique o web‑app via HTTPS com certificado SSL válido. No sandbox pode‑se usar IP, mas em produção o Telegram rejeitará qualquer outro esquema.
- Conecte o botão de lançamento: comando
/setmenubuttondefine o Mini App no botão de menu do bot. Alternativa — link direto via/myapps→Edit link.
Depois disso, o aplicativo fica acessível pelo botão de menu, por link direto ou por qualquer chat onde o convite foi encaminhado.
Pagamentos e monetização#
Mini App pode gerar receita de várias formas:
- Compras in‑game e assinaturas — em Stars ou em TON via transações assinadas;
- Pagamentos cripto — o usuário confirma a transação na carteira conectada (Tonkeeper, Wallet, MyTonWallet etc.) através do TON Connect;
- Publicidade e parcerias — atribuição própria via
start_param, códigos de referência, pagamentos via TON.
Para promover projetos TON, está disponível a rede de anúncios Telegram Ads. A publicidade não usa dados pessoais do usuário — o targeting ocorre pelo contexto do canal. O orçamento pode ser pago diretamente em TON.
Catálogo e promoção#
- Telegram Apps Center — catálogo de aplicativos e bots de terceiros; disponível em
tapps.center. - Trending Apps (
t.me/trendingapps) — canal que publica novos TMA e grandes atualizações; moderado pela comunidade. - The Open League (
Open_league_bot) — aplicativo que agrega projetos participantes da programa de grants e incentivos; fornece links diretos para pools da STON.fi e da DeDust.
Aplicativos conhecidos#
- Notcoin e Hamster Kombat — jogos tap‑to‑earn, recordistas de alcance na categoria TMA;
- Wallet — carteira integrada ao Telegram com cripto, mercado P2P e multi‑checks;
- STON.fi — DEX na TON com interface que funciona dentro do Telegram;
- DeDust — segundo grande DEX do ecossistema TON com front‑end TMA;
- Getgems — marketplace de NFT com versão Mini App.
Telegram Mini Apps 2.0#
Em novembro de 2024 o Telegram lançou uma grande atualização da plataforma, expandindo suas capacidades ao nível de aplicativos nativos:
- Modo tela cheia em orientação vertical e horizontal;
- Acesso a sensores — acelerômetro e giroscópio para controle em jogos;
- Atalho na tela principal — Mini App pode ser fixado ao lado de aplicativos comuns;
- Geolocalização — mapas, geo‑games, busca local;
- Stickers e TON Gifts — envio de presentes e conquistas por Stars direto do chat;
- Status de emoji para Premium — definição via aplicativo;
- Documentos e mídia — geração de arquivos, cartões de referência, memes;
- Assinaturas — monetização recorrente em Stars;
- Customização da splash screen;
- Informações avançadas do dispositivo — para adaptação de gráficos e desempenho.
A atualização traz parte dos padrões UX de sistemas operacionais móveis para o Telegram, tornando o Mini App uma interface competitiva para carteiras cripto, jogos e social‑commerce.
Política de blockchain do Telegram#
O Telegram publicou recomendações para uso de blockchain em bots e Mini Apps. Regras principais:
- usar apenas TON para emissão e distribuição de tokens ou ativos blockchain;
- conectar carteiras apenas via TON Connect;
- não promover carteiras que não sejam baseadas em TON e não utilizem TON Connect.
Violação das regras pode levar ao bloqueio do Mini App nos catálogos do Telegram.
Ferramentas do desenvolvedor#
@twa-dev/sdke@telegram-apps/sdk— SDKs oficiais/comunitários para trabalhar com a Telegram WebApp API;@tonconnect/ui-react— camada UI pronta para conexão de carteira dentro de TMA;- Documentação:
core.telegram.org/bots/webapps— especificação da WebApp API,docs.telegram-mini-apps.com— documentação expandida da comunidade,docs.ton.org/develop/dapps/telegram-apps/— guia de integração da TON Foundation.
Ver também#
- TON Connect
- The Open Network
- The Open League
- Tonkeeper
- Notcoin
- Hamster Kombat