> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.squarecloud.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como hospedar um bot de Telegram 24/7

## 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](https://help.squarecloud.app/pt-br/article/como-manter-bots-online-247-13kl8oc/). Se estiver começando do zero, vale conferir também [O que é deploy? Como colocar sua aplicação online](https://help.squarecloud.app/pt-br/article/o-que-e-deploy-como-colocar-sua-aplicacao-online-191ecnh/).