Un bot de Telegram que responde a comandos, juega a los dados, suma y guarda notas. Primero chatea con la demo, luego constrúyelo en 5 pasos y llévalo en tu móvil. 📱
Esto es lo que vas a construir (simulado aquí mismo). ¡Escríbele! Prueba /start, /dado, /suma 5 3, /nota ... o simplemente salúdalo:
/newbot y sigue sus preguntas.bot (ej: mi_primer_bot_123_bot). Tiene que ser único.123456:ABC-DEF.... Cópialo, lo necesitarás en el código.t.me/...) y pulsa Iniciar..env en vez de pegarlo en el código. Crea un archivo .env junto a mi_bot.py con TELEGRAM_TOKEN=123456:ABC..., añade un .gitignore con la línea .env, e instala pip install pyTelegramBotAPI python-dotenv. En el código: from dotenv import load_dotenv, load_dotenv() y TOKEN = os.getenv("TELEGRAM_TOKEN") (necesitarás import os). Tienes el ejemplo completo en el capítulo 18 del manual 📖. Los talleres de app y web no usan secretos: no necesitan .env.Abre una terminal y escribe:
pip install pyTelegramBotAPI python-dotenv
Crea mi_bot.py con esto (pon tu token de verdad). Si lo ejecutas, no hará nada aún… ¡pero se conectará sin errores!
import telebot
TOKEN = "PON_AQUI_TU_TOKEN"
bot = telebot.TeleBot(TOKEN)
print("Bot en marcha… 🤖")
bot.infinity_polling()
bot.infinity_polling() significa «pregunta a Telegram sin parar si hay mensajes nuevos». Por eso la terminal debe quedarse abierta.Los bots escuchan con decoradores: líneas con @ que dicen «cuando pase ESTO, ejecuta esta función». mensaje trae lo que escribió el usuario:
@bot.message_handler(commands=["start"])
def saludar(mensaje):
bot.reply_to(mensaje, "¡Hola! Soy tu primer bot 🎉\nEscribe /ayuda para ver lo que sé hacer.")
@bot.message_handler(commands=["ayuda"])
def ayuda(mensaje):
bot.reply_to(mensaje,
"Puedo hacer esto:\n"
"/start - Saludarme\n"
"/ayuda - Ver esta ayuda\n"
"/dado - Tirar un dado 🎲\n"
"/suma 5 3 - Sumar números ➕\n"
"/nota comprar pan - Guardar una nota 📝\n"
"/notas - Ver tus notas\n"
"Y si me hablas… ¡te respondo! 💬")
bot.infinity_polling() final. bot.reply_to() responde al mensaje que llegó. ¡Pruébalo en Telegram!@bot.message_handler(commands=["start"])?
Con el módulo random tu bot puede jugar. Añade import random arriba del todo y esta función antes del polling:
@bot.message_handler(commands=["dado"])
def dado(mensaje):
numero = random.randint(1, 6)
bot.reply_to(mensaje, f"🎲 ¡Un {numero}!")
numero:
¿Y si el comando trae datos, como /suma 5 3? El texto completo llega en mensaje.text. Lo partimos con .split() → ["/suma", "5", "3"] y cogemos los trozos [1] y [2]:
@bot.message_handler(commands=["suma"])
def suma(mensaje):
try:
partes = mensaje.text.split()
a = float(partes[1])
b = float(partes[2])
bot.reply_to(mensaje, f"➕ {a} + {b} = {a + b}")
except (IndexError, ValueError):
bot.reply_to(mensaje, "Úsalo así: /suma 5 3")
try/except protege de dos meteduras de pata: escribir pocos números (IndexError) o escribir letras (ValueError). ¡Un bot profesional nunca se cuelga![1]) en decimal, guardándolo en a:
Guardaremos notas en un diccionario donde la clave es mensaje.chat.id (el nº que identifica a cada persona). ¡Así cada usuario tiene SUS notas!
notas = {} # chat_id -> lista de notas (ponlo arriba, con el token)
@bot.message_handler(commands=["nota"])
def guardar_nota(mensaje):
texto = mensaje.text.replace("/nota", "", 1).strip()
if not texto:
bot.reply_to(mensaje, "Escribe algo: /nota comprar pan")
return
chat = mensaje.chat.id
if chat not in notas:
notas[chat] = []
notas[chat].append(texto)
bot.reply_to(mensaje, f"📝 Nota guardada ({len(notas[chat])} en total).")
@bot.message_handler(commands=["notas"])
def ver_notas(mensaje):
chat = mensaje.chat.id
if chat not in notas or not notas[chat]:
bot.reply_to(mensaje, "(sin notas)")
return
lineas = [f"{i + 1}. {n}" for i, n in enumerate(notas[chat])]
bot.reply_to(mensaje, "📝 Tus notas:\n" + "\n".join(lineas))
notas es un diccionario con chat.id?
Esta función atrapa todo lo demás: mira si el texto contiene palabras clave y si no, hace eco. El truco: excluimos los comandos con not ... startswith("/") (¡si no, respondería dos veces a cada comando!).
@bot.message_handler(func=lambda m: not m.text.startswith("/"), content_types=["text"])
def responder(mensaje):
texto = mensaje.text.lower()
if "hola" in texto:
bot.reply_to(mensaje, "¡Hola, humano! 👋")
elif "python" in texto:
bot.reply_to(mensaje, "¡Python es el mejor lenguaje! 🐍")
elif "gracias" in texto:
bot.reply_to(mensaje, "¡De nada! 😊")
else:
bot.reply_to(mensaje, f"Me has dicho: {mensaje.text}")
lambda m: ... es una mini-función sin nombre: «responde a todo lo que NO empiece por /». Y content_types=["text"] ignora stickers y fotos para que no lo rompan.Todo junto en mi_bot.py. Descárgalo, pon tu token y ejecútalo:
# mi_bot.py — ¡Mi primer bot de Telegram! 🤖
import random
import telebot
TOKEN = "PON_AQUI_TU_TOKEN"
bot = telebot.TeleBot(TOKEN)
notas = {} # chat_id -> lista de notas
@bot.message_handler(commands=["start"])
def saludar(mensaje):
bot.reply_to(mensaje, "¡Hola! Soy tu primer bot 🎉\nEscribe /ayuda para ver lo que sé hacer.")
@bot.message_handler(commands=["ayuda"])
def ayuda(mensaje):
bot.reply_to(mensaje,
"Puedo hacer esto:\n"
"/start - Saludarme\n"
"/ayuda - Ver esta ayuda\n"
"/dado - Tirar un dado 🎲\n"
"/suma 5 3 - Sumar números ➕\n"
"/nota comprar pan - Guardar una nota 📝\n"
"/notas - Ver tus notas\n"
"Y si me hablas… ¡te respondo! 💬")
@bot.message_handler(commands=["dado"])
def dado(mensaje):
numero = random.randint(1, 6)
bot.reply_to(mensaje, f"🎲 ¡Un {numero}!")
@bot.message_handler(commands=["suma"])
def suma(mensaje):
try:
partes = mensaje.text.split()
a = float(partes[1])
b = float(partes[2])
bot.reply_to(mensaje, f"➕ {a} + {b} = {a + b}")
except (IndexError, ValueError):
bot.reply_to(mensaje, "Úsalo así: /suma 5 3")
@bot.message_handler(commands=["nota"])
def guardar_nota(mensaje):
texto = mensaje.text.replace("/nota", "", 1).strip()
if not texto:
bot.reply_to(mensaje, "Escribe algo: /nota comprar pan")
return
chat = mensaje.chat.id
if chat not in notas:
notas[chat] = []
notas[chat].append(texto)
bot.reply_to(mensaje, f"📝 Nota guardada ({len(notas[chat])} en total).")
@bot.message_handler(commands=["notas"])
def ver_notas(mensaje):
chat = mensaje.chat.id
if chat not in notas or not notas[chat]:
bot.reply_to(mensaje, "(sin notas)")
return
lineas = [f"{i + 1}. {n}" for i, n in enumerate(notas[chat])]
bot.reply_to(mensaje, "📝 Tus notas:\n" + "\n".join(lineas))
@bot.message_handler(func=lambda m: not m.text.startswith("/"), content_types=["text"])
def responder(mensaje):
texto = mensaje.text.lower()
if "hola" in texto:
bot.reply_to(mensaje, "¡Hola, humano! 👋")
elif "python" in texto:
bot.reply_to(mensaje, "¡Python es el mejor lenguaje! 🐍")
elif "gracias" in texto:
bot.reply_to(mensaje, "¡De nada! 😊")
else:
bot.reply_to(mensaje, f"Me has dicho: {mensaje.text}")
print("Bot en marcha… 🤖")
bot.infinity_polling()
.env (TELEGRAM_TOKEN=...) — o, solo para probar rápido, en TOKEN = "...".python mi_bot.py y deja la terminal abierta (si la cierras, el bot se duerme 😴).random.choice(["cara", "cruz"]).