> ## 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).

# Cómo alojar un bot de Telegram 24/7

## Por qué usar la API oficial de Telegram

A diferencia de otras plataformas, Telegram ofrece una **API de bots oficial y gratuita** — sin riesgo de violar los términos de uso (ToS) por automatización. Esto hace de Telegram uno de los entornos más tranquilos para alojar bots: lo creas, lo alojas y lo mantienes en línea sin miedo a un baneo por usar la API como fue diseñada.

## 1. Crea tu bot en BotFather

1. En Telegram, busca **@BotFather** (el bot oficial de creación).
2. Envía el comando `/newbot`.
3. Elige un nombre y un username (que debe terminar en `bot`).
4. BotFather te entregará un **token** — guárdalo con cuidado.

## 2. Protege tu token

El token es la clave de acceso de tu bot. Nunca lo expongas:

* No subas el token a GitHub.
* Guárdalo en una variable de entorno (ej.: `TELEGRAM_TOKEN`).
* Si se filtra, usa `/revoke` en BotFather para generar uno nuevo.

## 3. Prepara tu proyecto

Elige una biblioteca para el lenguaje que conoces:

* **Node.js**: `node-telegram-bot-api` o `telegraf`.
* **Python**: `python-telegram-bot` o `aiogram`.

Ejemplo mínimo con 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 o polling?

* **Polling**: el bot le pregunta a Telegram si hay novedades. Más simple de configurar — ideal para empezar.
* **Webhook**: Telegram envía las actualizaciones a una URL pública de tu bot. Más eficiente para bots grandes.

Para la mayoría de los casos, empieza con polling.

## 5. Haz el deploy y mantén 24/7

1. Crea el archivo `squarecloud.app` con la información de tu aplicación.
2. Configura la variable de entorno `TELEGRAM_TOKEN`.
3. Envía el proyecto por el Dashboard o por la CLI.
4. Listo: Square Cloud mantiene tu bot en línea 24 horas al día.

## Manteniendo tu bot resiliente

Los bots que se ejecutan todo el tiempo necesitan manejar bien los errores y las reconexiones. Para buenas prácticas de estabilidad, mira [Cómo mantener bots en línea 24/7](https://help.squarecloud.app/es/article/como-mantener-bots-en-linea-247-1fd1a1r/). Si estás empezando desde cero, vale la pena revisar también [¿Qué es un deploy? Cómo poner tu aplicación en línea](https://help.squarecloud.app/es/article/que-es-un-deploy-como-poner-tu-aplicacion-en-linea-1eqnle4/).