Como hospedar um bot de Telegram 24/7 (API grátis, sempre online)

Por que usar a API oficial do Telegram

Diferente de outras plataformas, o Telegram oferece uma API de bots oficial e gratuita — sem risco de violar os termos de uso (ToS) por automação. Isso torna o Telegram um dos ambientes mais tranquilos para hospedar bots: você cria, hospeda e mantém online sem medo de banimento por usar a API como ela foi feita para ser usada.

1. Crie seu bot no BotFather

1. No Telegram, procure por @BotFather (o bot oficial de criação).
2. Envie o comando /newbot.
3. Escolha um nome e um username (que deve terminar em bot).
4. O BotFather vai te entregar um token — guarde-o com cuidado.

2. Proteja seu token

O token é a chave de acesso do seu bot. Nunca o exponha:

• Não suba o token para o GitHub.
• Guarde-o em uma variável de ambiente (ex.: TELEGRAM_TOKEN).
• Se vazar, use /revoke no BotFather para gerar um novo.

3. Prepare seu projeto

Escolha uma biblioteca para a linguagem que você preferir:

• Node.js: node-telegram-bot-api ou telegraf.
• Python: python-telegram-bot ou aiogram.

Exemplo mínimo com telegraf (Node.js):

const { Telegraf } = require('telegraf');
const bot = new Telegraf(process.env.TELEGRAM_TOKEN);

bot.start((ctx) => ctx.reply('Bot online na Square Cloud!'));
bot.launch();

4. Webhook ou polling?

• Polling: o bot pergunta ao Telegram se há novidades. Mais simples de configurar — ótimo para começar.
• Webhook: o Telegram envia as atualizações para uma URL pública do seu bot. Mais eficiente para bots grandes.

Para a maioria dos casos, comece com polling.

5. Faça o deploy e mantenha 24/7

1. Crie o arquivo squarecloud.app com as informações da sua aplicação.
2. Configure a variável de ambiente TELEGRAM_TOKEN.
3. Envie o projeto pelo Dashboard ou pela CLI.
4. Pronto: a Square Cloud mantém seu bot online 24 horas por dia.

Mantendo seu bot resiliente

Bots que rodam o tempo todo precisam lidar bem com erros e reconexões. Para boas práticas de estabilidade, veja Como manter bots online 24/7. Se estiver começando do zero, vale conferir também O que é deploy? Como colocar sua aplicação online.

Atualizado em: 11/06/2026