Telegram Serverless es una infraestructura oficial de la plataforma que permite ejecutar el código de backend de bots y Mini Apps directamente sobre los sistemas de Telegram, sin necesidad de aprovisionar servidores, mantener contenedores activos ni preocuparse por el escalado. El desarrollador escribe módulos en JavaScript, los despliega con un único comando y Telegram los ejecuta en un entorno aislado V8, integrado con la Bot API y con una base de datos incorporada.
El flujo de trabajo se organiza en tres piezas: una carpeta local con los módulos (manejadores de actualizaciones, librerías compartidas y definición de tablas en schema.js), la copia desplegada en la nube junto a la base de datos del bot, y la CLI tgcloud, que actúa como puente entre ambos entornos y sincroniza los cambios con npx tgcloud push.
Para empezar es necesario activar la función Serverless desde @BotFather y vincular el proyecto mediante npx tgcloud login, usando un token de acceso específico distinto del token de API del bot. La CLI se instala como dependencia local (o global con npm install -g @tgcloud/cli) y ofrece comandos como push, migrate, run y status. Los cambios de esquema y de datos se aplican en pasos separados: push sube el código sin tocar la base de datos, mientras que migrate propone y aplica las migraciones pendientes tras confirmación.
La documentación incluye un bot de demostración que responde a cada mensaje y registra en una tabla cuántas conversaciones ha visto por chat, lo que ilustra el ciclo completo: recibir una actualización, ejecutar el manejador correspondiente, leer y escribir en la base de datos con el SDK integrado y responder a través de la Bot API. Telegram Serverless está pensado como backend general para bots y Mini Apps, no como una plantilla cerrada, y se apoya en Node.js 18 o superior.
