Tu Bot de Telegram es una cadena de caracteres, y tres reglas deciden lo que puede hacer.

Dos frases de búsqueda aparecen una al lado de la otra cada vez que alguien consulta esto: el token y el chat id. Esa combinación es todo el problema del principiante en miniatura. La gente consigue el primero en un minuto y luego descubre que el bot no tiene dónde hablar.

Así que esto no es una comparación de frameworks. Es qué es el token, qué frena al bot una vez que lo tienes, y los tres límites publicados que deciden la forma de cualquier cosa que construyas.

Lo que BotFather realmente te da

Abre un chat con el propio bot de Telegram para crear bots, envía /newbot, responde dos preguntas. La documentación de Telegram describe el intercambio exactamente: pide un nombre y un nombre de usuario, y luego genera un token de autenticación.

Ese token es el bot. Es una cadena con un prefijo numérico y un secreto largo después de los dos puntos, y las propias palabras de Telegram son que autoriza al bot y es necesario para enviar solicitudes a la API. No hay contraseña aparte, ni cuenta a la que iniciar sesión, ni una segunda credencial. Cualquiera que tenga la cadena controla el bot por completo, por eso va en una variable de entorno y nunca en un repositorio, una captura de pantalla o un chat grupal.

En ese momento tienes un bot funcional que no hace nada, porque nada está escuchando. Ese es el estado correcto y ahí es donde empieza el trabajo real.

Regla uno: en un grupo, tu bot es deliberadamente sordo

Este es el informe de "mi bot está roto" más común, y es comportamiento documentado, no un error. Telegram establece que, por defecto, todos los bots añadidos a grupos funcionan en modo privacidad y solo ven mensajes y comandos relevantes.

Así que un bot en un grupo no recibe conversación ordinaria. Recibe mensajes que lo mencionan y comandos, y eso es el diseño. Si estás construyendo un bot de moderación que necesita leerlo todo, cambias esa configuración a través de BotFather deliberadamente. Si estás construyendo un asistente que responde preguntas, déjalo como está: el valor por defecto es el que preserva la privacidad y también te ahorra un volumen enorme de actualizaciones irrelevantes.

Una regla relacionada que atrapa a quienes construyen flujos bot-a-bot: Telegram decidió que los bots no verán mensajes de otros bots en absoluto, sin importar el modo, específicamente para evitar que se queden atrapados en bucles. Dos de tus propios bots no pueden hablarse directamente.

Regla dos: un mensaje por segundo, por chat

La guía de Telegram es directa. En un solo chat, evita enviar más de un mensaje por segundo. Lo plantea como consejo más que como un muro duro, lo que en la práctica significa que el límite se aplica haciendo que tu bot espere en lugar de rechazarlo rotundamente.

La consecuencia de diseño vale la pena absorberla pronto: un bot que responde una pregunta en seis mensajes cortos es seis veces más lento para ese usuario que uno que responde en un solo mensaje, y se nota. Compón una sola respuesta en lugar de narrar.

Regla tres: treinta por segundo, en volumen, y la aritmética que sigue

Para notificaciones masivas, Telegram establece que los bots no pueden transmitir más de unos treinta mensajes por segundo.

Haz la aritmética antes de diseñar una función de difusión, porque no perdona. Diez mil suscriptores a treinta por segundo son un poco más de cinco minutos y medio de envío continuo, asumiendo que nada falla y que no hay reintentos. Cien mil es casi una hora. Cualquier bot cuyo propósito sea anunciar algo a una lista grande es en realidad una cola con un bot al final, y construirlo como un bucle simple producirá una difusión que seguirá saliendo mucho después de que la noticia esté vieja.

Las respuestas prácticas son las habituales: envía a un canal y deja que los suscriptores tiren, en lugar de empujar a cada usuario individualmente; o acepta la cola y muestra el progreso. Elige deliberadamente, desde el principio.

Una primera versión que es pequeña a propósito

Telegram pide a todos los desarrolladores que soporten un pequeño conjunto de comandos básicos, y pone /start al principio de la lista como el que inicia la interacción con un usuario. También pide que respondas a todos los mensajes enviados a tu bot. Entre esas dos líneas tienes una especificación para una primera versión.

• Responde a /start con una declaración breve de lo que hace el bot. Es lo primero que ve cada usuario y es la única pantalla en la que puedes contar.
• Iguala un puñado de preguntas repetidas reales, tomadas de los mensajes que ya estás respondiendo a mano en lugar de una lista adivinada.
• Nunca te quedes en silencio. La entrada no reconocida debería recibir una respuesta de que alguien te seguirá, porque un bot que no dice nada se lee como roto y un bot que dice "no entendí eso, alguien te responderá" se lee como funcional.

Haz que ese bucle sea fiable y todo lo que venga después —publicaciones programadas, moderación de grupos, una consulta a base de datos— es una adición en lugar de una reconstrucción.

Dos cosas que no puedes comprar, y una que sí

Una nota sobre lo que este mercado tiene y no tiene, ya que es la pregunta obvia en un sitio como este.

No hay bot que comprar. Buscar las 16.735 listas activas por la palabra en un título devuelve tres resultados, y los tres son otra cosa: un juego de consola con "Bot" en el nombre, una lista de Telegram donde un bot es el mecanismo de entrega, y una lista de Facebook donde el vendedor transfiere derechos de administrador a través de uno. Nadie vende bots aquí, porque el token es gratis y toma un minuto.

Lo que quizás quieras es una cuenta normal de Telegram para probar, para no estar añadiendo tu número personal a un bot que todavía estás depurando, y un número para registrarlo. Ambos existen: cuentas de Telegram y números de verificación SMS. La garantía en el estante de cuentas dura doce horas en la mediana, así que prueba el inicio de sesión en cuanto llegue, no el fin de semana.

Una asimetría que vale la pena saber si estás construyendo algo orientado al público: la verificación de Telegram aplica a canales, bots y grupos públicos. Tu bot está en la lista elegible. La cuenta desde la que lo ejecutas no.

La referencia que debes tener abierta mientras construyes es la documentación de la API de Bot de Telegram. Todo lo citado en esta página proviene de ella, y es la única fuente que se mantiene al día.