Cómo crear el entorno de desarrollo para crear nuestro Bot de Telegram en Nodejs

Habitualmente, la forma más rápida de crear nuestro bot de Telegram es utilizar el bloc de notas o Notepad++. La diferencia entre los blocs de notas y los editores de texto profesionales de los que disponemos en la actual es que, estos últimos te ayudan a corregir tu código en el caso de que aparezca un error desconocido o bien, no sabemos de donde viene o que puede estar causando el error.

En este artículo, te enseñaremos a crear un entorno de trabajo bastante cómodo para que, si tienes problemas a la hora de crear tu código o bien, errores de sintaxis, puedas solventarlos.

Editor de texto recomendado

En la actualidad, hay muchos editores de texto de los que se puede hacer uso, algunos ofrecen más ventajas que otros. Por ejemplo, Atom y Visual Studio Code entre otros editores, permiten la instalación de extensiones que nos pueden ayudar a resaltar la sintaxis de un lenguaje especifico o bien, a autocompletar partes de nuestro código.

Desde mi punto de vista, el editor de texto que recomiendo es Visual Studio Code. Es el más completo que he conocido hasta la fecha. Es rápido, eficaz y con una gran variedad de extensiones que podemos instalar además de poder hacer uso de su terminal integrado. Al instalar este editor, también nos permite instalar Git, por lo que se puede utilizar la consola de Bash como si del terminal de Linux se tratase.

Lo podeis descargar de su sitio web oficial totalmente gratis

Para crear nuestro bot, no es necesario instalar ninguna de las extensiones de las que disponen estos editores, pero si no te gusta el interfaz que trae por defecto, puedes buscar temas y cambiarlo a tu antojo.

Requerimientos previos

Generando nuestro token con BotFather

Para generar nuestro token y hacer que nuestro bot funcione correctamente, en Telegram debemos ir a @BotFather

Si nuncas has iniciado este bot, pulsa Iniciar e introducimos /newbot
Nos solicitará un nombre y un @alias para el bot
Si el @alias está disponible y nos permite establecerlo nos devolverá un mensaje con el token parecido a este:

Use this token to access the HTTP API: 668219748:AAHRTZu6zNT5QO2bRfZfbPIXBLXb2U-ojVM

NodeJS

Dado que Javascript y NodeJS son un lenguaje de programación básico y de fácil aprendizaje, usaremos ambos para crear nuestro bot de Telegram. Bien porque la sintaxis de Javascript nos puede ayudar a manejar NodeJS de manera más sencilla.

Dicho esto, debemos descargar NodeJS de su sitio web oficial y proceder a su instalación.

Para comprobar que se ha instalado correctamente, inciamos el símbolo del sistema y añadimos node --version. En el caso de estar instalado correctamente nos devolverá la versión de NodeJS que hemos instalado.

Crear nuestro paquete de información

Creamos una carpeta en el escritorio llamada Bots, accedemos a ella mediante cd desktop/bots.

Dentro de la misma, en el caso de que utilices Visual Studio Code, en el terminal integrado debemos añadir el siguiente comando npm init.

Una vez presiones Enter te pedirá una serie de datos como el nombre, la versión, dependencias entre otras cosas. No obstante, si no quieres rellenar todos estos datos, puede hacer uso del comando npm init --yes y automáticamente se rellenarán.

Aunque no es imprescindible crearlo, es bueno tenerlo para que, en el caso de que se quiera compartir el código con otras personas, agilicemos el proceso de instalación de dependencias.

Instalación de la librería necesaria.

Para crear nuestro bot en NodeJS utilizaremos la API node-telegram-bot-api, la cual es muy sencilla de utilizar aunque existan otras alternativas. Esta API tiene una documentación bastante extensa para utilizar cada uno de sus métodos.

Ahora prodeceremos a su instalación mediante el terminal integrado de nuestro editor de texto:

Accedemos a la carpeta que creamos con anterioridad llamada Bots con el comando cd desktop/bots
Una vez dentro del directorio desktop/bots ejecutamos el siguiente comando: npm install --save node-telegram-bot-api
Veremos que dentro de la carpeta Bots se nos crea automaticamente una carpeta llamada node_modules. Este será el directorio donde se instalarán todas las APIs que utilizaremos en un futuro.

Una vez instalada la API, debemos crear nuestro archivo bot.js en la carpeta Bots, donde trabajaremos nuestro bot de Telegram.

Plantilla inicial

Para terminar, dejaremos hecha un pequeña plantilla que constará del requerimiento de la API, establecimiento de nuestro token que previamente hemos solicitado a BotFather y la creación de nuestro constructor que manejará nuestro token y actualizaciones.

No obstante, crearemos también un manejador de errores que nos permitirá identificar el error que nos pueda dar al utilizar cualquier método mal estructurado, además del comando /start que manejará el mensaje que se muestra al pulsar el botón Iniciar de nuestro bot.

const TelegramBot = require('node-telegram-bot-api');
const token = 'TokenDentroDeLasComillas';
const bot = new TelegramBot(token, {polling:true});

bot.on('polling_error', function(error){
    console.log(error);
});

bot.onText(/^\/start/, function(msg){
    var chatId = msg.chat.id;
    var nameUser = msg.from.first_name;
    
    bot.sendMessage(chatId, "Bienvenido a mi bot " + nameUser);
});

Para arrancar el bot, solo debemos escribir node bot.js en el terminal