O que é um Telegram Mini App

O Que É um Telegram Mini App?

Um Telegram Mini App é um site construído com tecnologia web padrão (HTML, CSS, JavaScript) que abre dentro da própria janela do Telegram em vez de uma aba do navegador, então parece e se comporta como parte do próprio app. O desenvolvedor de um bot registra o endereço web pelo @BotFather, e o Telegram então o abre em um WebView integrado, acionado a partir daquele bot — por um botão, o menu do chat, ou um link direto — sem nunca sair da interface do Telegram.

Como Abrir um Mini App

Existem quatro pontos de entrada comuns, e qualquer bot pode oferecer mais de um:

1. Botão de menu — toque no botão ao lado do campo de mensagem dentro do chat de um bot; ele substitui o ícone usual de comandos "/" quando o bot o habilitou.
2. Botão de teclado ou inline — alguns bots enviam uma mensagem com um botão rotulado para abrir o app; tocar nele abre o Mini App diretamente.
3. Menu de anexos — toque no ícone de clipe ou anexo em qualquer chat e escolha o Mini App na lista, se o bot tiver se adicionado lá.
4. Link direto — abra um link no formato t.me/nomedobot/nomedoapp compartilhado por alguém ou encontrado em um catálogo; o Telegram abre o Mini App da mesma forma.

O lugar exato onde fica o botão ou ícone varia um pouco entre iOS, Android e Telegram Desktop, então se você não encontrar em uma interface, verifique o menu ao lado do campo de mensagem ou o ícone de anexo nas outras — os pontos de entrada em si são os mesmos, só muda a localização.

Categorias de Mini Apps

Os Mini Apps cobrem uma ampla gama de tarefas que normalmente exigiriam um aplicativo ou site separado:

• Jogos — os próprios jogos HTML5 do Telegram funcionam assim; abrir um a partir de uma mensagem e apertar Jogar aciona o mesmo tipo de WebView.
• Finanças e carteiras — @wallet é um Mini App para guardar e enviar TON, tokens baseados em Toncoin, e USDT sem sair do Telegram.
• Compras e marketplaces — lojas que permitem navegar por um catálogo e finalizar a compra dentro do chat.
• Produtividade e ferramentas úteis — calculadoras, conversores e painéis que precisam de uma interface real em vez de uma troca de mensagens.
• Quizzes e conteúdo interativo — pesquisas ou experiências interativas com botões, formulários e layouts que uma simples mensagem de texto não consegue oferecer.

Qualquer bot pode combinar um Mini App com comandos normais e modo inline; o Mini App é usado só para as partes da experiência que precisam de uma interface mais rica do que uma bolha de chat.

Pagando Dentro de um Mini App com Telegram Stars

Telegram Stars é a moeda própria da plataforma, e muitos Mini Apps a usam em vez de um formulário de cartão. Você compra Stars uma vez, pela própria tela de pagamento do Telegram ou a partir do seu saldo em Configurações, e depois o Mini App pode solicitar um valor sem nunca ver os dados do seu banco — o Telegram guarda e transfere o pagamento, e para você isso aparece como uma fatura que você confirma com um toque. Alguns Mini Apps ainda oferecem suporte a uma recarga normal via cartão pelos pagamentos integrados do Telegram, caso o desenvolvedor tenha configurado isso, mas Stars é a opção que o Telegram promove para bens e conteúdo digital.

O Que um Mini App Pode (e Não Pode) Ver

Um Mini App roda dentro de um WebView isolado, não com o nível de acesso do próprio cliente do Telegram:

• Ele pode ver os dados que você compartilha ativamente com ele: seu nome no Telegram, username, ID de usuário, idioma, e o que você digita ou envia dentro do app.
• Ele não consegue ler seu histórico de conversas, contatos ou mensagens em outras conversas, a menos que você envie explicitamente essa informação pela própria interface do app.
• Pagamentos feitos com Stars passam pelo próprio fluxo de pagamento do Telegram, então um Mini App nunca vê diretamente o número do seu cartão ou dados bancários.
• Como um site, ele ainda pode ser construído de forma ruim ou maliciosa — trate pedidos de permissões extras, logins externos, ou dados incomuns com a mesma cautela que você usaria em qualquer site externo, e abra Mini Apps só de bots em que você confia.

Perguntas Frequentes

Preciso instalar alguma coisa para usar um Mini App? Não. Ele abre dentro do Telegram assim que você toca no botão ou no link — não há nenhum aplicativo separado para baixar nem conta para criar além da sua conta do Telegram já existente.

Um Mini App pode me enviar mensagens ou me adicionar a um grupo sem perguntar? Não. Um Mini App só pode agir dentro das permissões que você concede na própria interface dele; enviar mensagens em seu nome ou entrar em grupos ainda exige uma ação explícita sua por meio do bot.

Os Telegram Stars são dinheiro de verdade? Stars é a moeda própria do Telegram, comprada com dinheiro real através da tela de pagamento do Telegram e gasta apenas dentro do Telegram, em coisas como conteúdo de Mini App, então um Mini App nunca lida diretamente com os dados do seu cartão.