Também disponível em English·Español·Français·Türkçe·Русский
Hospedagem de bot do Telegram: grátis, a partir do GitHub, sempre ligado
Pegue o token no BotFather, cole a URL do seu repositório e faça o deploy. O bot roda 24 horas com 256 MB grátis, reinicia se cair e recebe um novo deploy a cada push. Polling sem configurar nada, ou webhook com um endereço https.
Como funciona
- Crie o bot com o BotFather no Telegram e copie o token.
- Crie uma conta na FadeHost e verifique seu e-mail.
- Em Bots, clique em Host a bot, escolha Telegram e cole a URL do repositório, ou parta do modelo telegram-starter-bot.
- Coloque o token nas variáveis de ambiente, com o nome que o seu código lê (
BOT_TOKENno modelo). - Clique em Deploy e mande /start para o seu bot.
Polling ou webhook
Com polling o bot pergunta ao Telegram pelas novidades em um loop: não precisa de porta nem de endereço e funciona no plano grátis como está. É a escolha para um bot que é só um bot.
Com webhook o Telegram chama o seu bot em um endereço https. Cada app pode ter um em https://nome.fadehost.app; no plano grátis esse endereço dorme quando ninguém usa e acorda na próxima requisição, em um plano pago ele fica sempre ligado por US$ 2 ao mês. O Telegram permite um modo por vez: apague o webhook antes de voltar ao polling, ou verá o erro Conflict.
Preços
| Grátis | Starter | Standard | Pro | |
|---|---|---|---|---|
| Preço | US$ 0 | US$ 2/mês | US$ 3/mês | US$ 6/mês |
| RAM | 256 MB | 1 GB | 2 GB | 4 GB |
| CPU | 0,25 vCPU | 1 vCPU | 1 vCPU | 3 vCPU |
| Disco | 3 GB | 5 GB | 10 GB | 20 GB |
Um ano custa dez meses. O primeiro bot ou app é grátis para sempre em cada conta verificada.
Frequently asked questions
É grátis mesmo?
Sim. Um bot por conta verificada, com 256 MB, sempre ligado, sem cartão. Quando precisar de mais memória ou de um segundo bot, os planos começam em US$ 2 por mês.
Polling ou webhook para começar?
Polling. Não há nada para configurar e funciona no plano grátis. O webhook faz sentido quando o bot faz parte de um app web que já tem endereço.
Vejo Conflict: can't use getUpdates method while webhook is active
Há um webhook ativo ou uma segunda cópia do bot fazendo polling, por exemplo a do seu computador. Pare a cópia local e apague o webhook com deleteWebhook.
Quais linguagens funcionam?
Python (aiogram, python-telegram-bot, pyTelegramBotAPI), Node.js (grammY, Telegraf, node-telegram-bot-api) e também Go, Java, Bun, Deno, PHP e Ruby. A linguagem é detectada a partir do repositório.
Onde coloco o token?
Nas variáveis de ambiente do bot, nunca no repositório. O código lê com os.environ ou process.env.
O painel está em português?
Ainda não. O painel de controle e os e-mails estão em inglês, com rótulos curtos (Deploy, Console, Environment) que se entendem sem esforço. Os preços são em dólares americanos.