Cómo alojar bots de Telegram

Introducción

Para desarrollar y alojar en Square Cloud, es esencial seguir una secuencia estructurada de configuraciones y requisitos previos. Esta guía técnica cubrirá todo el proceso, desde la configuración inicial hasta el despliegue en producción.

Requisitos previos

Cuenta de Square Cloud: Regístrate a través de la página de registro usando tu correo electrónico.
Plan de pago 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.

Creando el proyecto

Una cuenta de Telegram es esencial para probar e interactuar con tu bot. Si no tienes una, visita el sitio web oficial de Telegram para crear tu cuenta gratis.

Aplicación del bot en Telegram

Primeros pasos

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

Obteniendo el token de autenticación

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.

Generando el token del bot de Telegram con BotFather

Seguridad crítica: Mantén el token de tu bot absolutamente secreto. Este token otorga control total sobre el bot y debe tratarse como información confidencial.

Desarrollando el proyecto

La elección de la biblioteca o framework depende del lenguaje de programación que pretendas usar. A continuación se presentan algunas de las opciones más populares:

Node.js - grammY
Python - telebot

Configuración del entorno

Verifica que Node.js esté instalado en tu sistema. De lo contrario, descárgalo desde el sitio web oficial de Node.js.
Inicializa un nuevo proyecto de Node.js:

Terminal

npm init -y

Instala la biblioteca grammY:

Terminal

npm install grammy

Implementación básica

Crea el archivo principal (index.js) con la siguiente estructura:

index.js

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

// Authentication token configuration
const token = "YOUR_TOKEN_HERE";

// Bot initialization
const bot = new Bot(token);

(async () => {
  // Get bot information
  const botInfo = await bot.api.getMe();
  const botName = botInfo.username;

  // Define handler for text messages
  bot.on("message:text", async (ctx) => {
    const userMsg = ctx.message.text;
    const responseMsg = `${botName} responds: ${userMsg}`;
    await ctx.reply(responseMsg);
  });

  // Start the bot
  bot.start();
  console.log(`Bot ${botName} started successfully!`);
})();

Configuración del entorno

Verifica que Python y pip estén instalados. De lo contrario, descárgalos desde el sitio web oficial de Python.
Instala la biblioteca pyTelegramBotAPI:

Terminal

pip install pyTelegramBotAPI

Implementación básica

Crea el archivo principal (main.py):

main.py

import telebot

# Authentication token configuration
TOKEN = "YOUR_TOKEN_HERE"

# Bot initialization
bot = telebot.TeleBot(TOKEN)

# Define handler for non-command messages
@bot.message_handler(func=lambda message: not message.text.startswith('/'))
def echo_handler(message):
    # Get bot information
    bot_info = bot.get_me()
    bot_name = bot_info.username
    # Format response message
    response_msg = f"{bot_name} responds: {message.text}"
    # Reply to the user
    bot.reply_to(message, response_msg)

# Main execution
if __name__ == '__main__':
    bot_info = bot.get_me()
    print(f"Bot {bot_info.username} started successfully!")
    # Start polling
    bot.infinity_polling()

Crea el archivo requirements.txt para gestionar las dependencias:

requirements.txt

pyTelegramBotAPI

Desplegando

Tras preparar los archivos de tu proyecto, ya puedes subirlos a Square Cloud y alojar tu proyecto. Para ello, crea un archivo ZIP que contenga todos los archivos de tu proyecto.

A través del panel

Accede a la página de subida

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

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.

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.

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

Para usar este método, necesitas crear un archivo de configuración llamado squarecloud.app en el directorio raíz de tu proyecto. Este archivo contendrá la configuración necesaria para tu proyecto.

Guía del archivo de configuración

Aprende a crear el archivo de configuración squarecloud.app que define el entorno de tu aplicación.

Instala la CLI

Primero, necesitas tener la CLI instalada en tu entorno. Si aún no la tienes, ejecuta el siguiente comando en tu terminal:

npm install -g @squarecloud/cli

Si ya la tienes, te recomendamos actualizarla. Para ello, ejecuta el siguiente comando en tu terminal:

Windows
Linux, macOS y WSL

squarecloud update

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

Autentícate

Ahora, para autenticarte y usar otros comandos de la CLI, encontrarás tu clave de autorización aquí haciendo clic en “Request API Key”. Después de obtener tu clave de autorización, ejecuta el siguiente comando:

squarecloud auth login

Sube tu proyecto

Por último, para desplegar tu aplicación en Square Cloud usando la CLI, necesitas ejecutar el siguiente comando:

squarecloud upload

O si creaste el zip manualmente, puedes usar:

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

Confirma que tu aplicación esté en vivo

Tu primer despliegue suele tardar menos de un minuto. Revisa el estado y los logs de tu aplicación directamente desde la terminal:

squarecloud app status
squarecloud app logs

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.

Probando el bot

Tras un despliegue exitoso, localiza tu bot en Telegram y envía un mensaje de prueba. El bot debería responder repitiendo tu mensaje, confirmando el correcto funcionamiento de la implementación.

Recursos adicionales

Para profundizar tus conocimientos sobre el desarrollo de bots de Telegram, consulta la documentación oficial de pyTelegramBotAPI. La documentación ofrece guías detalladas, tutoriales avanzados y una referencia completa de la API.

Contáctanos

Si continúas enfrentando dificultades técnicas, nuestro equipo de soporte especializado está disponible para ayudarte. Contáctanos y estaremos encantados de ayudarte a resolver cualquier problema — la calidad del soporte es una gran parte de por qué los desarrolladores califican a Square Cloud con 4.9/5 en 402 reseñas en Google y Trustpilot.

Tutoriales

Bots

Proyectos listos

Bases de datos

APIs

Sitios web

Guías de migración

Cómo alojar bots de Telegram

Introducción

Requisitos previos

Creando el proyecto

Aplicación del bot en Telegram

Desarrollando el proyecto

Desplegando

A través del panel

A través de la CLI

Guía del archivo de configuración

Probando el bot

Recursos adicionales

Contáctanos

​Introducción

​Requisitos previos

​Creando el proyecto

​Aplicación del bot en Telegram

​Desarrollando el proyecto

​Desplegando

​A través del panel

​A través de la CLI

Guía del archivo de configuración

​Probando el bot

​Recursos adicionales

​Contáctanos

Introducción

Requisitos previos

Creando el proyecto

Aplicación del bot en Telegram

Desarrollando el proyecto

Desplegando

A través del panel

A través de la CLI

Probando el bot

Recursos adicionales

Contáctanos