🤖

Construye tu primer bot

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. 📱

👀

La meta: chatea con la demo

Esto es lo que vas a construir (simulado aquí mismo). ¡Escríbele! Prueba /start, /dado, /suma 5 3, /nota ... o simplemente salúdalo:

🤖
MiBot● en línea
💡 Tu bot real hará exactamente esto, pero viviendo en Telegram y programado por ti en Python. ¡Vamos a crearlo!
1

Crea tu bot y prepáralo

🤖 1. Habla con BotFather (5 minutos)

  1. Abre Telegram y busca @BotFather (el que tiene ✓ verificado).
  2. Envíale /newbot y sigue sus preguntas.
  3. Elige un nombre (ej: Mi Primer Bot) y un usuario terminado en bot (ej: mi_primer_bot_123_bot). Tiene que ser único.
  4. ¡Listo! Te dará un token parecido a 123456:ABC-DEF.... Cópialo, lo necesitarás en el código.
  5. Abre tu bot (te da un enlace t.me/...) y pulsa Iniciar.
⚠️ El token es la contraseña de tu bot: quien la tenga puede controlarlo. No la publiques en internet ni la subas a GitHub.
🔐 Profesional: guarda el token en un archivo .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.

📦 2. Instala la librería

Abre una terminal y escribe:

pip install pyTelegramBotAPI python-dotenv

🐍 3. El esqueleto

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.
2

Tu primer comando: /start

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! 💬")
💡 Pega estas funciones antes del bot.infinity_polling() final. bot.reply_to() responde al mensaje que llegó. ¡Pruébalo en Telegram!
🎯 Mini-reto 1: ¿qué hace @bot.message_handler(commands=["start"])?
3

Juegos: el dado 🎲

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}!")
🎯 Mini-reto 2: escribe la línea que genera un número aleatorio del 1 al 6 en la variable numero:
4

Lee lo que escriben: /suma

¿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")
💡 El try/except protege de dos meteduras de pata: escribir pocos números (IndexError) o escribir letras (ValueError). ¡Un bot profesional nunca se cuelga!
🎯 Mini-reto 3: escribe la línea que convierte el primer número (trozo [1]) en decimal, guardándolo en a:
5

Memoria y charla + ¡a por todas! 🚀

📝 Notas por usuario

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))
🎯 Mini-reto 4: ¿por qué notas es un diccionario con chat.id?

💬 Responder cuando hablan (sin comandos)

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.

📦 El código completo

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()

▶️ Ponlo en marcha

  1. Pon tu token en el archivo .env (TELEGRAM_TOKEN=...) — o, solo para probar rápido, en TOKEN = "...".
  2. Ejecuta python mi_bot.py y deja la terminal abierta (si la cierras, el bot se duerme 😴).
  3. Habla con tu bot en Telegram desde el móvil. ¡Funciona de verdad! 📱

🚀 Retos de ampliación

  1. /moneda: cara o cruz con random.choice(["cara", "cruz"]).
  2. /chiste: una lista de chistes y uno al azar.
  3. Notas eternas: guárdalas en un archivo (¡como en el taller de la app!).
  4. Más charla: responde a «adiós», «quién eres» o tu nombre.