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.

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.

Aprende más sobre: cómo crear el archivo de configuración para Square Cloud.

El archivo squarecloud.app es un archivo de configuración que se usará para configurar tu aplicación; se utilizará para definir tu entorno.

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>

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.

​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

Aprende más sobre: cómo crear el archivo de configuración para Square Cloud.

​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