Cómo alojar un bot de Telegram 24/7

​

Introducción

​

Requisitos previos

• Cuenta de Square Cloud: Regístrate a través de la página de registro usando tu correo electrónico.
• Plan activo: Garantiza recursos dedicados y un rendimiento optimizado para tu aplicación. Consulta nuestros planes disponibles y elige el más adecuado para tus necesidades.

​

Crear el proyecto

​

Aplicación del bot en Telegram

Buscar a BotFather

Accede a Telegram Web y busca el bot oficial BotFather, responsable de crear y administrar bots en la plataforma.

Obtener el token

Inicia una conversación con BotFather y escribe /start. Luego, selecciona la opción /newbot para crear un nuevo bot. El sistema pedirá un nombre para tu bot y, tras la confirmación, generará automáticamente el token de autenticación necesario.

​

Desarrollar el bot

npm init -y

npm install grammy

const { Bot } = require("grammy");

// The token comes from the TELEGRAM_BOT_TOKEN environment variable
const bot = new Bot(process.env.TELEGRAM_BOT_TOKEN);

// Reply to every text message with an echo
bot.on("message:text", async (ctx) => {
  await ctx.reply(`${ctx.me.username} responds: ${ctx.message.text}`);
});

// Long polling: the bot asks Telegram for new messages, so no public URL is needed
bot.start({
  onStart: (botInfo) => console.log(`Bot ${botInfo.username} started successfully!`),
});

pip install pyTelegramBotAPI

import os

import telebot

# The token comes from the TELEGRAM_BOT_TOKEN environment variable
bot = telebot.TeleBot(os.environ["TELEGRAM_BOT_TOKEN"])
bot_name = bot.get_me().username


# Echo every message that isn't a command
@bot.message_handler(func=lambda message: not message.text.startswith("/"))
def echo_handler(message):
    bot.reply_to(message, f"{bot_name} responds: {message.text}")


if __name__ == "__main__":
    print(f"Bot {bot_name} started successfully!")
    # Long polling: no public URL is needed
    bot.infinity_polling()

pyTelegramBotAPI

​

Configurar Square Cloud

DISPLAY_NAME=My Telegram Bot
MAIN=index.js
MEMORY=512
VERSION=recommended
AUTORESTART=true

DISPLAY_NAME=My Telegram Bot
MAIN=main.py
MEMORY=512
VERSION=recommended
AUTORESTART=true

• MAIN es el archivo que ejecuta Square Cloud, y MEMORY es la RAM del bot en MB. Los bots necesitan al menos 256 MB; 512 MB deja margen para crecer.
• AUTORESTART=true vuelve a iniciar el bot si falla. Consulta cómo funciona el auto restart.
• No hay SUBDOMAIN: con long polling, el bot no necesita una URL pública.

​

Definir el token del bot

• Dashboard: en la página de subida, abre Configuración avanzada y añade una variable llamada TELEGRAM_BOT_TOKEN con tu token como valor. Para un bot que ya está en línea, añádela en la página Variables de entorno de la aplicación y reinicia el bot.
• CLI: justo después de subir el bot (consulta Hacer deploy y verificar), defínela con squarecloud app env set y reinicia el bot:

squarecloud app env set TELEGRAM_BOT_TOKEN=your_token_here
squarecloud app restart

​

Qué va en el ZIP

• Tu archivo principal (index.js o main.py) y tus demás archivos de código.
• package.json o requirements.txt.
• squarecloud.app.

​

Hacer deploy y verificar

​

A través del panel

1

Accede a la página de subida

Accede a la página de subida y sube el archivo zip de tu proyecto.

2

Configura tu entorno

Después de subir tu zip, deberás configurar el nombre, el archivo principal o el entorno de ejecución y otros ajustes de tu proyecto.
Si estás subiendo un proyecto web, asegúrate de seleccionar “Publicación Web” y de definir un subdominio para tu proyecto.

3

Despliega tu proyecto

Por último, haz clic en el botón “Deploy” para alojar tu proyecto en Square Cloud.
Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.

4

Confirma que tu aplicación esté en vivo

Tu primer despliegue suele tardar menos de un minuto. En el dashboard, espera a que el estado de tu aplicación muestre “running” y revisa los logs por si hay errores de inicio.
Si desplegaste un sitio web o una API, abre https://<tu-subdominio>.squareweb.app en tu navegador: deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online.

¿La aplicación no inicia? Consulta la guía de solución de problemas para ver las causas y soluciones más comunes.

​

A través de la CLI

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

Probar el bot

​

Errores comunes

​

Error 409: Conflict: terminated by other getUpdates request

​

Error 401: Unauthorized

​

Token vacío o KeyError: 'TELEGRAM_BOT_TOKEN'

​

Próximos pasos

​

Contáctanos