Telegram es más que una aplicación de mensajería. Se ha convertido en una plataforma versátil para la automatización y el desarrollo de servicios interactivos. Especialmente en el ámbito de las aplicaciones de IA y herramientas como n8n, Telegram es cada vez más popular, ya que permite una comunicación bidireccional directa con las personas. Para los desarrolladores que deseen aprovechar estas posibilidades, existen dos enfoques fundamentales: la Bot API y la MTProto-API.
La Bot API: el camino estándar para la mayoría de los bots
La Bot API ofrece el método más sencillo y utilizado con mayor frecuencia para crear un bot de Telegram. Está diseñada específicamente para el desarrollo fácil de servicios automatizados.
Ventajas
Simplicidad: usa el protocolo HTTPS estándar.
Seguridad: la comunicación con los servidores de Telegram se gestiona automáticamente; el desarrollo se realiza mediante un token de API sencillo.
Automatización: ideal para reacciones automatizadas a ciertos eventos o comandos.
Desventajas
Funcionalidad limitada: está sujeta a estrictas normas de privacidad. No es posible recuperar datos privados como el estado en línea de un usuario.
Interacción limitada: no puede imitar completamente la interfaz de un cliente humano.
La MTProto-API: el camino para aplicaciones avanzadas
La MTProto-API es el protocolo básico que también utilizan las aplicaciones oficiales de Telegram. Es más compleja, pero ofrece un ámbito de funciones mucho más amplio.
Ventajas
Control total: permite el acceso a todas las funciones de Telegram, incluida la gestión de contactos, la consulta del estado en línea y la lectura de listas de miembros en grupos y canales.
Flexibilidad: es posible desarrollar una aplicación que actúe no como “bot”, sino como un usuario normal de Telegram.
Desventajas
Complejidad: el protocolo es exigente de implementar debido a su propio cifrado y gestión de sesiones.
Responsabilidad: el desarrollador es responsable del cumplimiento de las normas de privacidad, ya que se puede acceder a datos privados de los usuarios.
Elección de la API adecuada
Para la mayoría de los proyectos, especialmente para principiantes, se recomienda la Bot API. Es fácil de aprender y cumple con los requisitos de la mayoría de las aplicaciones de bots. La MTProto-API solo es relevante cuando una aplicación necesita funciones específicas que la Bot API no ofrece, como el monitoreo de la presencia en línea de usuarios o la extracción de listas completas de miembros.
Nos centraremos primero en la opción sencilla y veremos cómo crear un bot básico. Este tutorial aborda más adelante la implementación mediante la Bot API con ayuda de BotFather.
Bot API y BotFather
Para crear un bot de Telegram propio con la Bot API, el camino pasa por el oficial BotFather. Este bot es proporcionado directamente por Telegram y sirve como punto central para el registro de nuevos bots. Se encuentra fácilmente en la búsqueda de Telegram y se reconoce por el sello azul que confirma que es el original.
Al abrir el bot, aparece un menú que permite acceder a más ajustes y opciones. De esta forma comienza prácticamente cada proyecto con la Bot API, ya que aquí se configuran los datos básicos necesarios para el uso posterior.
Nombre del bot
Es el nombre visible que los usuarios ven en Telegram al interactuar con el bot. Puede contener espacios y no tiene que ser único. Varios bots pueden compartir el mismo nombre. Ejemplo: un bot puede llamarse “NetPerformance”, aunque existan otros bots con el mismo nombre.
Username
El username es la dirección única del bot en Telegram y siempre termina en “bot”. No puede contener espacios. Solo con este nombre se puede encontrar y acceder al bot de forma unívoca, por ejemplo mediante el enlace t.me/NetPerformance_bot. El username debe ser único, es decir, solo se puede asignar una vez en todo el sistema.
Con el comando /mybots, BotFather muestra todos los bots que ya has creado. En la lista aparecen los usernames de tus bots, es decir, las direcciones únicas que siempre terminan en “bot”. En la captura se ve que el bot con el username NetPerformance_bot se ha creado correctamente. Así puedes consultar en cualquier momento un resumen de tus propios bots.
Si seleccionas uno de tus bots en BotFather, se abre un menú con varias opciones. Cada una de ellas sirve para gestionar el bot o cambiar sus propiedades.
API Token
Aquí obtienes la clave de acceso única para tu bot. Este token es necesario para comunicarte con tu bot mediante la Telegram Bot API. Con él puedes enviar solicitudes a la API, obtener mensajes o enviar respuestas. El token equivale a una contraseña y debe mantenerse en un lugar seguro, ya que quien lo conozca puede controlar tu bot.
Edit Bot
Con esta función puedes cambiar datos básicos del bot, como el nombre visible o la foto de perfil.
Bot Settings
En esta sección puedes realizar ajustes adicionales, por ejemplo la descripción, el texto “About” o la lista de comandos que el bot ofrece a los usuarios.
Payments
Aquí puedes activar funciones de pago, con las que el bot puede gestionar pedidos o compras.
Transfer Ownership
Esta opción te permite transferir el bot a otra cuenta de Telegram.
Delete Bot
Con esta función puedes eliminar el bot de forma permanente. Después ya no estará accesible en Telegram.
Desde este menú gestionas todas las funciones centrales de tu bot, siendo el API Token la base más importante para trabajar con la Bot API.
Visualización del token de la API.
Esta pantalla muestra el bot en la ventana de chat normal de Telegram, tal como lo ve un usuario cuando lo abre por primera vez.
El botón Iniciar es necesario porque un bot solo puede interactuar con un usuario tras recibir un comando de inicio activo. Con ello se abre una llamada sesión. Telegram exige este paso para asegurar que el contacto parte conscientemente del usuario y no se envían mensajes sin su consentimiento.
Sin este inicio, el bot no sabría que puede comunicarse contigo.
En esta pantalla se ve que, como usuario, tras el comando de inicio he enviado mi primer mensaje propio con el texto “Hello Bot!” al bot.
Para comprobar si mi bot recibe mensajes, he llamado al método getUpdates de la Telegram Bot API mediante Postman. Para ello utilizo la URL https://api.telegram.org/bot
En el ejemplo se ve que mi mensaje enviado previamente /start aparece correctamente en el resultado. Además del texto se transmiten otros datos, por ejemplo el chat.id único, mi username y la configuración de idioma. Estos datos son importantes, ya que más adelante se usan para enviar respuestas al chat correcto.
Con esto se ha dado el primer paso: mi bot recibe mensajes y puedo seguir por la Bot API qué entradas llegan a él.
Después de obtener los mensajes entrantes con getUpdates, ahora envío yo mismo un mensaje de respuesta. Para ello uso el método sendMessage de la Telegram Bot API.
Con esto, el bot ha iniciado por primera vez una comunicación con un usuario y ha enviado una respuesta. Así se establece la primera comunicación completa.
Hasta aquí hemos visto que un bot puede recibir mensajes y devolverlos a un usuario. Con esto se establece el flujo de comunicación básico. Sin embargo, aún falta la lógica real en el fondo que hace útil al bot.
En un caso de uso real no basta con que el bot reciba mensajes y envíe respuestas simples. Se necesita un backend propio que procese los mensajes entrantes. Este backend puede, por ejemplo, verificar qué contenido ha enviado el usuario, aplicar ciertas reglas o recuperar datos de una fuente externa. Sobre esa base se crea la respuesta adecuada.
El proceso es así: el usuario envía un mensaje al bot. Este mensaje se reenvía a la Bot API, que lo pasa al backend. Allí corre la lógica real que decide qué respuesta enviar. Solo entonces, la Bot API entrega la respuesta al usuario.
Con este paso intermedio se crea un proceso completamente automatizado. El bot deja de ser un simple reflejo y se convierte en una herramienta que proporciona información, procesa entradas y realiza tareas complejas.
Bot API y OpenWeatherMap
Después de que mi bot pudiera recibir y devolver mensajes simples, quiero ampliarlo con una función real. Debe reaccionar al comando /wetter y ofrecer datos meteorológicos actuales de Düsseldorf.
Es importante entender que el bot en sí no tiene lógica propia. Es más bien como un buzón donde los usuarios depositan sus mensajes. A través de la Bot API puedo recoger esos mensajes. Solo mi backend decide si y cómo reaccionar a una determinada entrada. Si escribo “Banane” o “Kiwi”, no ocurre nada más que mostrar el mensaje. Si escribo “/wetter”, mi backend reconoce ese texto especial y ejecuta la acción deseada.
Para que esto funcione, mi backend debe recibir los mensajes entrantes de Telegram. Para ello, la Bot API ofrece dos opciones:
Long Polling
Con el método getUpdates, mi backend consulta a la Bot API si hay nuevos mensajes. Puedo establecer un tiempo de espera, por ejemplo 30 segundos. Durante ese tiempo la solicitud permanece abierta hasta que llega un mensaje o se agota el tiempo. En cuanto llega la respuesta, mi código inicia inmediatamente la siguiente consulta. Así se crea un flujo continuo sin enviar demasiadas solicitudes vacías. El long polling es especialmente útil para pruebas locales o configuraciones sencillas sin infraestructura de servidor fija.Webhook
Para el funcionamiento en producción, un webhook suele ser la mejor opción. Registros de una URL HTTPS accesible públicamente en Telegram. Cuando llega un mensaje nuevo, Telegram llama automáticamente a esa dirección y envía el mensaje por POST. Mi backend puede reaccionar de inmediato sin tener que hacer consultas constantes. Es obligatorio disponer de un certificado SSL válido.
Si se recibe un mensaje, mi código comprueba si el contenido coincide con “/wetter”. Solo en ese caso se desencadena una acción. Todos los demás mensajes se ignoran.
En el siguiente paso mi backend llama a una interfaz externa. En mi caso uso la API de OpenWeatherMap, que proporciona datos meteorológicos actuales. Con las coordenadas de Düsseldorf envío una solicitud al endpoint de información meteorológica actual. La respuesta llega en formato JSON e incluye valores como temperatura, descripción del tiempo, humedad o velocidad del viento.
Estos datos los convierto después en un texto legible y los envío mediante el método sendMessage al usuario. El usuario tiene la sensación de preguntar directamente al bot por el tiempo, aunque en realidad mi backend está consultando la API externa y devolviendo la información.
De este modo, de un bot simple que solo recibe y devuelve mensajes, se crea una pequeña aplicación con verdadero valor añadido. El proceso se puede ampliar a voluntad, por ejemplo extrayendo la ciudad de la entrada del usuario y enviándola dinámicamente a la API meteorológica.
En esta imagen se muestra el resultado del código mostrado anteriormente. Tras enviar el comando /wetter al bot, este responde con los datos meteorológicos actuales de Düsseldorf.
Con los pasos mostrados se sientan las bases para conectar un bot de Telegram mediante la Bot API con lógica externa. El bot en sí es solo la interfaz que recibe y reenvía mensajes. La inteligencia real reside en el backend, que decide si reacciona a una entrada como /wetter y cómo es la respuesta.
El principio está claro: recoger mensajes entrantes, comprobar si contienen un comando relevante, consultar fuentes de datos externas y devolver los resultados. Todo lo demás es sobre todo trabajo de implementación, es decir crear comandos adicionales, estructurar respuestas, agregar manejo de errores y hacer el código más robusto. Con esto se dispone ya de los cimientos para convertir un ejemplo sencillo en una aplicación completa.