Servidor para Telegram Mini App
Uma Mini App é um aplicativo web que abre dentro do Telegram: loja, agendamento de horário, jogo ou área do cliente. Por fora é um bot com um botão; por dentro, um site comum com API e banco de dados. Veja o que disso exige servidor e qual VPS escolher.
Resposta curta. Para uma Mini App basta uma VPS KVM com 1–2 vCPU e 2 GB de memória na Europa, com IPv4 próprio e domínio com HTTPS. No mesmo servidor rodam o frontend, a API, o webhook do bot e o PostgreSQL; mais memória só é necessária quando o banco cresce ou o app processa arquivos.
Do que é feita uma Mini App
O app tem três partes. O frontend: HTML, CSS e JavaScript que o Telegram abre por um link; o endereço precisa ser somente HTTPS, e em produção HTTP simples e endereço IP não são aceitos. O backend: a API que o frontend chama para pedidos, perfil e pagamento. O bot: recebe comandos e pagamentos por webhook. O frontend pode ser servido pelo mesmo servidor ou por uma CDN (veja CDN: quando um site precisa de uma); backend e bot costumam ficar juntos. O certificado Let's Encrypt é gratuito; como emitir e renovar está no artigo Certificados SSL.
Validação do usuário no servidor
Ao abrir o app, o Telegram passa a ele o initData: quem abriu, o horário da abertura (auth_date) e a assinatura hash. Não dá para confiar nesses dados no frontend — quem os valida é o backend. Segundo a documentação do Telegram, o servidor calcula o HMAC-SHA-256 dos campos ordenados com uma chave derivada do token do bot e da string WebAppData e compara o resultado com hash; dados antigos são descartados pelo auth_date. Por isso o token do bot fica só no servidor, nunca no código do frontend.
Webhook do bot e rede
O bot recebe as atualizações por webhook, e o Telegram tem requisitos rígidos para ele: só IPv4 (IPv6 não é suportado em webhooks), portas 443, 80, 88 ou 8443, TLS 1.2 ou mais recente. O endereço do webhook não é conhecido só pelo Telegram, então, ao configurá-lo, defina um secret_token: o Telegram o envia no cabeçalho X-Telegram-Bot-Api-Secret-Token de cada requisição, e o servidor rejeita as que vierem sem ele. Um servidor sem IPv4 próprio não serve — veja VPS só com IPv6. O servidor fica na Europa, como para um bot comum: ele acessa o api.telegram.org o tempo todo, e a latência até lá importa mais do que até os usuários. Enquanto o webhook está fora do ar, o Telegram guarda as atualizações por no máximo 24 horas, então vale perceber a queda do servidor na hora — veja Monitoramento de servidor. Mais sobre a carga de um bot no artigo VPS para bot do Telegram.
Banco de dados, pagamentos e tarefas em segundo plano
Guarde usuários, pedidos e saldos no PostgreSQL, não em arquivos — veja Banco de dados numa VPS. Produtos digitais dentro da Mini App são vendidos em Telegram Stars: antes do pagamento o bot recebe um pre_checkout_query e precisa responder em 10 segundos, senão o pagamento é cancelado. Ou seja, o webhook não pode esperar operações lentas: envios em massa, relatórios e processamento de arquivos vão para uma fila (veja Tarefas agendadas: cron e filas). A carga de uma Mini App é irregular: depois de um post no canal, centenas de pessoas abrem o app em minutos, por isso folga de memória importa mais que o número de núcleos.
Quanto custa o servidor
No catálogo da accsly.io, em 18 de novembro de 2026, há na Europa, com IPv4 próprio, 680 planos com 1 vCPU e 2 GB em 425 provedores; a mediana mensal no pagamento mensal sem pré-pagamento é de 9,49 € nos planos em euros, US$ 12 nos em dólares e 770 ₽ nos em rublos. Com 2 vCPU e 2 GB são 576 planos, com mediana de 13,90 €, US$ 20 e 885 ₽. Seleções: VPS para bot do Telegram, VPS para Node.js e VPS na Holanda.