Creando un bot de Telegram en JavaScript: guía para principiantes

Bot de Telegram en JavaScript: por dónde empezar y cómo no confundirse

¿Alguna vez te has preguntado cómo funcionan esos bots inteligentes de Telegram que envían el clima, recuerdan fechas límite o simplemente hacen bromas divertidas? ¿Y si te digo que puedes escribir tu propio bot de Telegram en JavaScript en una sola tarde? Sí, incluso si eres principiante. En esta guía, desglosaremos el proceso de creación de un bot paso a paso, con ejemplos de código reales y sin rodeos.

¿Por qué JavaScript? Porque es un lenguaje universal que funciona en todas partes: en servidores, en el navegador e incluso en Raspberry Pi. Y con la librería Telegraf, crear un bot de Telegram se convierte en un verdadero placer. ¿Listo? ¡Vamos allá!

Qué necesitamos para crear un bot de Telegram en JS

Antes de escribir código, preparemos las herramientas. Necesitarás:

\n
• Node.js (versión 14 o superior) — entorno de ejecución de JavaScript en el servidor.
\n
• Editor de texto — Visual Studio Code, Sublime Text o cualquier otro.
\n
• Cuenta en Telegram — no podemos prescindir de ella.
\n
• Terminal — línea de comandos para instalar paquetes.
\n

Si aún no tienes Node.js instalado, descárgalo desde el sitio oficial. El proceso de instalación es trivial: solo haz clic en "Siguiente".

Registro del bot y obtención del token

El primer paso para crear un bot de Telegram en JavaScript es obtener un token de API. Es una clave secreta que conecta tu código con Telegram.

\n
1. Abre Telegram y busca al bot @BotFather.
\n
2. Envía el comando /newbot.
\n
3. Inventa un nombre para el bot (por ejemplo, MiPrimerBotDePrueba).
\n
4. Inventa un nombre de usuario único que termine en bot (por ejemplo, mi_primer_bot_2025_bot).
\n
5. Guarda el token que recibas; se verá más o menos así: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz.
\n

Importante: el token es tu contraseña. No se lo muestres a nadie ni lo subas a GitHub de forma visible.

Instalación de librerías y configuración del proyecto

Ahora pasemos al código. Crea una carpeta para el proyecto, ábrela en la terminal y ejecuta:

npm init -y

Este comando creará un archivo package.json. Ahora instalemos la librería principal — Telegraf:

npm install telegraf

Telegraf es una librería potente y sencilla para trabajar con la API de Telegram Bot en JavaScript. Soporta comandos, teclados, modo inline y mucho más.

Para mayor comodidad, instala también dotenv — te ayudará a almacenar el token en un archivo separado:

npm install dotenv

Crea un archivo .env en la raíz del proyecto y escribe tu token allí:

BOT_TOKEN=tu_token_aqui

No olvides agregar .env al archivo .gitignore si planeas subir el código.

Escribimos nuestro primer bot de Telegram en JavaScript

Crea un archivo bot.js y ábrelo en el editor. Empecemos con lo más simple: un bot que responda al comando /start.

require('dotenv').config();\nconst { Telegraf } = require('telegraf');\n\nconst bot = new Telegraf(process.env.BOT_TOKEN);\n\nbot.start((ctx) => {\n    ctx.reply('¡Hola! ¡Soy tu primer bot en JavaScript!');\n});\n\nbot.launch();\nconsole.log('¡Bot iniciado!');

Ejecuta el bot con el comando:

node bot.js

Abre tu bot en Telegram y presiona Start. Si todo está correcto, el bot te responderá con un saludo. Felicidades — ¡acabas de crear un bot de Telegram en JavaScript funcional!