Neurocourse

Cómo funcionan los bots: BotFather, el token y getUpdates

Un bot de Telegram es un programa más una cuenta de Telegram, conectados por un token. El BotFather oficial registra los bots, y el programa recupera los mensajes por sí mismo —a través de la solicitud getUpdates, como revisar un buzón. Crearemos tu primer bot en esta misma lección.

Veamos qué es un bot en realidad; así quedará claro por qué cualquiera puede crear uno, incluso alguien que «no es una persona de informática».

Un bot = un programa + un «socket» de Telegram

Cada bot tiene dos partes:

  1. Una cuenta de bot en Telegram — un nombre, un avatar, un identificador como @your_bot. Se crea en dos minutos y por sí sola no puede hacer nada: es un escaparate y un «socket» al que se conecta la segunda parte.
  2. Un programa que recibe los mensajes de los usuarios a través de Telegram y envía respuestas. Puede vivir en cualquier lugar: en tu ordenador o en un servidor.

Telegram transporta los mensajes entre el usuario y tu programa — sin app, sin web, sin interfaz que construir. Botones, chats, notificaciones: todo ya está hecho y funcionando en miles de millones de teléfonos. Por eso los bots son la forma más fácil de crear productos: tú escribes solo el «cerebro», Telegram proporciona el «cuerpo».

BotFather: donde nacen los bots

Recuerda de la lección anterior: la plataforma de bots se abrió en 2015 junto con @BotFather. Es el bot registrador oficial: envíale /newbot, elige un nombre (la gente lo ve) y un identificador (debe terminar en bot) — y te entregará un token: una cadena larga como 7213…:AAH8…. BotFather es también donde más tarde configuras la «cara» del bot: descripción, avatar, el menú de comandos.

El token es la llave de contacto

El token vincula tu programa a la cuenta del bot: el programa lo presenta a Telegram y obtiene el derecho a hablar como el bot. Quien tiene el token controla el bot. Se derivan dos reglas de oro:

  • Nunca muestres el token a nadie — ni en chats, ni en capturas de pantalla, ni en código que publiques en ningún sitio. Alguien con tu token puede responder a tus clientes como tu bot — y ni siquiera te darás cuenta de inmediato.
  • Si se ha filtrado, reemplázalo. BotFather tiene /revoke: el token antiguo muere al instante, se emite uno nuevo. Eso lleva un minuto y no hay nada de qué avergonzarse; esperar que «nadie se diera cuenta» sí lo es.

Cómo un bot sabe que ha recibido un mensaje: getUpdates

Aquí tienes una pregunta que casi nadie hace, y deberían: ¿el mensaje de un usuario «vuela» a tu programa por sí solo? Piensa un segundo. En realidad, no. Telegram almacena todo lo escrito a tu bot en una cola en sus servidores — imagina un buzón registrado a tu bot. Y el programa va a buscar el correo él mismo: cada pocos segundos envía a Telegram una solicitud getUpdates — literalmente «entrega las actualizaciones» — y recoge los mensajes acumulados. Responde, pregunta de nuevo, y así sucesivamente en un bucle. Por eso un bot se queda en silencio cuando el programa está apagado: las cartas se acumulan, pero nadie viene a por ellas.

Este mecanismo tiene una consecuencia que te ahorrará horas: un buzón, una llave. Lanza dos copias del programa con el mismo token — por ejemplo, en tu portátil y en otro lugar — y empezarán a quitarse las cartas de las manos, y Telegram responderá con un error. Ten en cuenta la imagen del correo: en la lección sobre el despliegue de servidores, explicará el error más común de los principiantes.

Novedades para los bots en 2026

Los conceptos básicos anteriores no han cambiado en diez años — pero la «cosmética» crece con cada versión de la Bot API: los botones tienen colores, los chats tienen listas de verificación, los mensajes tienen un modo de desaparición. Buenas noticias: nuestro bot solo necesita lo básico, y puedes pedir los detalles sofisticados a ChatGPT más tarde con una sola frase — una vez que lo básico funcione.

Haz esto ahora

Abre @BotFather → /newbot → inventa un nombre y un identificador (que termine en bot). Guarda el token en tus notas — no en chats. En la próxima lección encargaremos el programa que da vida a este bot.

Pruébalo en el sandbox

Fija la regla del token a través de una historia — copia el prompt completo:

Actúa una escena y luego disecciónala. El héroe es Mitya, un principiante.
Creó un bot a través de @BotFather, obtuvo el token 7213456789:AAH8xQ…
(inventado) y, emocionado, envió una captura de pantalla con el token a un chat
de 200 amigos. Muestra paso a paso: qué puede hacer cualquiera en ese chat
con el token; qué verá Mitya (y qué no) desde su lado;
qué comando de BotFather salva su bot. Termina con una regla de una frase
para almacenar tokens.

Luego comprueba lo bien que entendiste el mecanismo del correo:

Usando una metáfora de buzón, explica cómo el programa de un bot de Telegram
recibe mensajes a través de la solicitud getUpdates: Telegram pone cartas
en un buzón, el programa viene a recogerlas él mismo. Luego ponme a prueba:
haz 3 preguntas de comprensión (incluyendo qué pasa si dos
programas recogen el correo con la misma llave) y revisa mis respuestas.
Practice · 5 задач

Short questions on the lesson — with an explanation for every answer.