ACLClouds
ACLClouds

Tutorial: crear un bot de Telegram y alojarlo gratis

Crear un bot de Telegram con BotFather, escribir el código mínimo en Python o en Node.js y alojarlo gratis 24/7: cada paso, con los errores habituales.

Para alojar un bot de Telegram gratis hacen falta tres cosas: un token entregado por BotFather, unas diez líneas de código en Python o en Node.js y una máquina que permanezca encendida por usted. Este tutorial sigue esos tres pasos en orden, hasta la primera respuesta del bot al comando /start. Usa el polling: el bot no necesita ni dirección pública ni certificado HTTPS.

  • BotFather crea el bot y entrega su token con el comando /newbot.
  • El código lee el token en la variable de entorno TELEGRAM_TOKEN, nunca escrito directamente en un archivo.
  • En polling, el bot no necesita ni dirección pública ni certificado HTTPS.
  • El plan Free de ACLClouds ejecuta 1 bot Node.js o Python con 315 MB de RAM, sin tarjeta bancaria.
  • Un error 409 Conflict significa que dos copias del bot funcionan con el mismo token.

Crear el bot con BotFather

En Telegram, abra una conversación con @BotFather, la cuenta oficial que gestiona los bots, y envíe /newbot. Pide un nombre para mostrar y luego un nombre de usuario que debe terminar en bot, por ejemplo mon_premier_bot. Responde con el token, una serie de cifras y letras separadas por dos puntos.

  • El token da el control total del bot: no lo ponga ni en el código ni en una captura de pantalla.
  • Si se ha filtrado, envíe /revoke a BotFather: el token antiguo deja de funcionar y se crea uno nuevo.
  • En un grupo, un bot solo recibe por defecto los comandos. Para leer todos los mensajes, desactive el modo de privacidad con /setprivacy.

El código mínimo en Python

La biblioteca más utilizada es python-telegram-bot. Cree un archivo requirements.txt que contenga la línea python-telegram-bot y luego un archivo bot.py. El programa lee el token en la variable de entorno TELEGRAM_TOKEN, declara un comando /start e inicia la recepción de mensajes.

  • Cree la aplicación: Application.builder().token(os.environ["TELEGRAM_TOKEN"]).build().
  • Escriba una función asíncrona start(update, context) que responda con await update.message.reply_text("Hola").
  • Asóciela al comando con add_handler(CommandHandler("start", start)) y termine con run_polling().
  • El paquete que se instala se llama python-telegram-bot, mientras que el import se escribe from telegram.ext import Application, CommandHandler.

El mismo bot en Node.js

En Node.js, Telegraf y grammY hacen el mismo trabajo. Con Telegraf, el package.json contiene la dependencia telegraf y un script start que ejecuta node index.js. El archivo index.js ocupa cuatro líneas.

  • Cargue la biblioteca: const { Telegraf } = require("telegraf").
  • Cree el bot con el token leído del entorno: const bot = new Telegraf(process.env.TELEGRAM_TOKEN).
  • Responda a /start con bot.start((ctx) => ctx.reply("Hola")) y luego ejecute bot.launch().

Alojar el bot gratis

El plan Free del alojamiento de bots de ACLClouds ejecuta un programa Node.js o Python de forma continua, sin tarjeta bancaria. Se presenta para Discord, pero un bot de Telegram en polling funciona allí de la misma manera: es un programa que abre una conexión saliente. Al hacer el pedido, elija Python o Node.js y sustituya el proyecto de ejemplo por sus archivos desde la pestaña Archivos o por SFTP en el puerto 2222.

  • En la pestaña Inicio, añada una variable de entorno llamada TELEGRAM_TOKEN con el token de BotFather. El campo «Token del bot de Discord» queda vacío.
  • No suba node_modules ni .venv: las dependencias se instalan en el servidor a partir de requirements.txt o de package.json.
  • Para subir los archivos con FileZilla, siga la guía desplegar un bot por SFTP.

Iniciar y probar

Inicie el bot desde la consola, abra la conversación con su bot en Telegram y envíe /start. La respuesta llega en uno o dos segundos. Si no llega nada, la consola muestra la causa: lea la primera línea de error.

  • 401 Unauthorized: el token es incorrecto o ha sido revocado. Cópielo de nuevo desde BotFather.
  • 409 Conflict: otra copia del bot ya funciona con el mismo token, a menudo en su ordenador. Deténgala. Si alguna vez se configuró un webhook, elimínelo con el método deleteWebhook.
  • No module named telegram: falta la línea python-telegram-bot en requirements.txt. Consulte la guía ModuleNotFoundError.
  • Ningún mensaje recibido en un grupo: el modo de privacidad está activo, solo llegan los comandos.

Qué permite el plan Free

Un bot de Telegram de comandos consume poco: el plan Free le basta en la mayoría de los casos. Sus límites son públicos, y la contrapartida de la gratuidad es una renovación que se hace a mano.

  • 1 bot por cuenta, 315 MB de RAM, 0,25 vCPU y 715 MB de almacenamiento.
  • Renovación gratuita cada 4 días desde la página del bot. Sin renovación, el bot queda suspendido.
  • El bot no se pone en reposo entre dos mensajes, y se reinicia solo tras una parada inesperada.
  • Polling o webhook, ritmo de los envíos y memoria: la guía bot de Telegram 24/7 detalla estas opciones.

Preguntas frecuentes

¿Un bot de Telegram puede funcionar en un plan pensado para Discord?

Sí. El plan ejecuta un programa Node.js o Python: un bot de Telegram en polling se inicia allí igual que un bot de Discord. Solo cambia el nombre de la variable del token.

¿Hace falta un nombre de dominio o un certificado HTTPS?

No, en polling no: es el bot quien consulta a Telegram. Un webhook, en cambio, requiere una dirección HTTPS accesible desde Internet.

¿El bot responde cuando mi ordenador está apagado?

Sí. Se ejecuta en la infraestructura de ACLClouds. Basta con renovar el plan Free gratis cada 4 días desde la página del bot.

¿Qué biblioteca elegir para empezar?

python-telegram-bot en Python, Telegraf o grammY en Node.js. Las tres están documentadas y bastan para un bot de comandos. Elija el lenguaje que ya conoce.