Como hospedar um bot de Telegram 24/7 grátis

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

No Telegram, procure por @BotFather (o bot oficial de criação).
Envie o comando /newbot.
Escolha um nome e um username (que deve terminar em bot).
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

Crie o arquivo squarecloud.app com as informações da sua aplicação.
Configure a variável de ambiente TELEGRAM_TOKEN.
Envie o projeto pelo Dashboard ou pela CLI.
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: 13/06/2026

Este artigo foi útil?

Obrigado!