Crear un bot de Discord#5¡Implementa interacciones con botones (Button)!

¡Hola! Soy Mojangcam 😎

En el episodio #4 enviamos embeds con Slash Commands, ¿verdad? Esta vez vamos un paso más allá y añadiremos botones (Button) en los que se puede hacer clic a los mensajes. ¡Vamos a crear un bot que reacciona cuando pulsas un botón, un auténtico "bot interactivo"!

Cuando lo termines, podrás hacer cosas como estas:

• Dar opciones al usuario con los botones ✅ Confirmar / ❌ Cancelar
• 🎫 Funciones de un solo clic, como crear tickets o asignar roles
• Enviar respuestas que solo ve la persona que pulsó el botón

📌 Lo que necesitas

• Python 3.8 o superior
• discord.py 2.x (¡los botones están disponibles desde la 2.0!)
• Token del bot + el bot ya invitado a tu servidor (¡mira el episodio 1!)

pip install -U discord.py

Si tu versión es antigua, actualízala sí o sí. Puedes comprobar la versión con pip show discord.py.

📌 Paso 1 - La clave de los botones: entender View

En discord.py, los botones no se pueden usar solos: se meten en un contenedor llamado View y se envían junto con el mensaje.

• discord.ui.View → la caja que contiene botones, menús desplegables, etc. 📦
• El decorador discord.ui.button → crea un botón dentro de la View y lo conecta con la función que se ejecuta al pulsarlo

¡Veamos primero la estructura!

import discord

class MyView(discord.ui.View):
    @discord.ui.button(label="¡Púlsame!", style=discord.ButtonStyle.primary)
    async def my_button(self, interaction: discord.Interaction, button: discord.ui.Button):
        await interaction.response.send_message("¡Se pulsó el botón!")

⚠️ El orden de los parámetros de la función callback es (self, interaction, button). Es fácil confundirse porque en los ejemplos de otras librerías (pycord, etc.) el orden es el contrario, ¡así que ten cuidado!

📌 Paso 2 - Los estilos de botón

Hay 5 colores de botón que puedes poner en style=.

📌 Paso 3 - Crear botones de Confirmar/Cancelar

Vamos a crear el patrón Confirmar/Cancelar, el que más se usa en la práctica.

class ConfirmView(discord.ui.View):
    def __init__(self):
        super().__init__(timeout=60)  # Desactiva los botones tras 60 segundos

    @discord.ui.button(label="Confirmar", style=discord.ButtonStyle.success)
    async def confirm(self, interaction: discord.Interaction, button: discord.ui.Button):
        await interaction.response.edit_message(content="✅ ¡Confirmado!", view=None)

    @discord.ui.button(label="Cancelar", style=discord.ButtonStyle.danger)
    async def cancel(self, interaction: discord.Interaction, button: discord.ui.Button):
        await interaction.response.edit_message(content="❌ Cancelado.", view=None)

Puntos clave 💡

• timeout=60 : pasados 60 segundos, los botones dejan de funcionar (el valor por defecto es 180 segundos)
• edit_message(..., view=None) : al pulsar un botón, se edita el mensaje original y se quitan los botones
• interaction.response solo puede responder una vez y dentro de 3 segundos. Si quieres enviar algo más, ¡usa interaction.followup.send()!

📌 Paso 4 - Código completo (puedes copiar y pegar)

Esta es la versión final, combinada con un Slash Command.

import discord
from discord.ext import commands

intents = discord.Intents.default()
bot = commands.Bot(command_prefix="/", intents=intents)

class ConfirmView(discord.ui.View):
    def __init__(self):
        super().__init__(timeout=60)

    @discord.ui.button(label="Confirmar", style=discord.ButtonStyle.success)
    async def confirm(self, interaction: discord.Interaction, button: discord.ui.Button):
        await interaction.response.edit_message(content="✅ ¡Confirmado!", view=None)

    @discord.ui.button(label="Cancelar", style=discord.ButtonStyle.danger)
    async def cancel(self, interaction: discord.Interaction, button: discord.ui.Button):
        await interaction.response.edit_message(content="❌ Cancelado.", view=None)

@bot.event
async def on_ready():
    await bot.tree.sync()
    print(f"¡El bot {bot.user} está listo!")

@bot.tree.command(name="확인", description="Envía los botones Confirmar/Cancelar")
async def confirm_command(interaction: discord.Interaction):
    await interaction.response.send_message("¿Continuamos?", view=ConfirmView())

bot.run("Token")

📌 Comprobar el resultado

Ejecuta el bot y escribe /확인 (confirmar) en un canal de Discord: ¡aparecerá el mensaje "¿Continuamos?" con un botón verde de Confirmar y uno rojo de Cancelar! Al pulsar un botón, el mensaje cambia a "✅ ¡Confirmado!" y los botones desaparecen.

📌 Errores frecuentes

1. Pulso el botón y aparece "La interacción ha fallado"

Ocurre cuando el callback no responde en 3 segundos. Si el proceso tarda, llama primero a await interaction.response.defer().

2. TypeError: ... missing 1 required positional argument

¡Es un problema del orden de los parámetros del callback! En discord.py 2.x el orden es (self, interaction, button). Si escribes (self, button, interaction), aparece este error.

3. Al reiniciar el bot, los botones de los mensajes anteriores ya no funcionan

Por defecto, una View solo existe en memoria. Para que siga funcionando después de reiniciar, tienes que crear una persistent view con timeout=None + custom_id y registrarla con bot.add_view(). (¡Esto lo veremos más adelante en un episodio avanzado!)

📌 Para terminar

Hoy implementamos interacciones de clic con las View y los botones de discord.py.

• Los botones se envían dentro de una View
• 5 estilos (primary/secondary/success/danger/link)
• ¡Responde en 3 segundos y solo una vez!

En el próximo episodio vamos a crear un menú desplegable (Select Menu). ¡No te lo pierdas! 🙌

📚 Serie Crear un bot de Discord

1. Domina por completo los Slash Commands
2. Añade opciones (argumentos) a tus Slash Commands
3. Añade subcomandos a tus Slash Commands
4. Envía embeds con Slash Commands
5. Implementa interacciones con botones (Button) ← ¡estás leyendo este!