Crear un bot de Discord#7Pide texto al usuario con un modal (Modal) (ejemplo en Python)

📌 Episodio anterior de la serie: Crear un bot de Discord #6 - Implementa menús desplegables (Select Menu)

¡Hola! Soy Mojangcam 😎

En el episodio anterior aprendimos a ofrecer varias opciones de forma ordenada con un menú desplegable (Select Menu), ¿verdad? Pero tanto los botones como los menús desplegables te hacen elegir entre opciones definidas de antemano. ¿Qué haces cuando el usuario tiene que escribir y enviar texto libremente?

En este episodio vamos a crear justo lo que cumple esa función: ¡un modal (Modal)! Un modal es una ventana emergente de entrada que aparece en el centro de la pantalla cuando el usuario ejecuta un comando. Se usa en casi cualquier sitio donde "el usuario tiene que escribir texto": recepción de consultas, buzones de sugerencias, registro de apodos, formularios de reporte... Es mucho más limpio que hacerle escribir un texto largo en el chat, ¡y además puedes recibir varios campos de una sola vez!

📌 Lo que necesitas

• Python 3.8 o superior
• discord.py la última versión 2.x (los modales están disponibles desde la 2.0)
• Token del bot + el bot ya invitado a tu servidor (mira el episodio 1 de la serie)

pip install -U discord.py

Para comprobar la versión, haz esto:

pip show discord.py

Si ves algo como Version: 2.x, es decir, 2.x o superior, ¡todo OK! El modal (Modal) es una función disponible desde discord.py 2.0, así que no funciona en la versión 1.x.

📌 Paso 1 - Crear la clase Modal

La clave del modal es la clase discord.ui.Modal. Heredas de esta clase, defines los campos de entrada (TextInput) y escribes lo que ocurre cuando el usuario envía el formulario (on_submit).

import discord
from discord.ext import commands

class SuggestModal(discord.ui.Modal, title="Buzón de sugerencias 📮"):
    # Campo corto de una sola línea
    subject = discord.ui.TextInput(
        label="Título",
        placeholder="Escribe el título de tu sugerencia",
        max_length=50,
    )

    # Campo largo de varias líneas
    content = discord.ui.TextInput(
        label="Contenido",
        style=discord.TextStyle.long,
        placeholder="¡Escribe los detalles con total libertad!",
        required=True,
        max_length=500,
    )

    async def on_submit(self, interaction: discord.Interaction):
        await interaction.response.send_message(
            f"✅ ¡Hemos recibido tu sugerencia!\n**Título:** {self.subject.value}\n**Contenido:** {self.content.value}",
            ephemeral=True,
        )

Vamos a verlo parte por parte 💡

• title : el título grande que aparece arriba del todo en la ventana emergente del modal. Se pone al definir la clase, así: discord.ui.Modal, title="...".
• TextInput : un campo de entrada. Si los declaras como variables de clase, aparecen en pantalla en orden, de arriba abajo. (Puedes poner hasta 5 en un solo modal.)
• label : la etiqueta que se ve encima del campo.
• style : puedes elegir discord.TextStyle.short (por defecto, una línea) o discord.TextStyle.long (varias líneas).
• placeholder : el texto de ayuda en gris que se muestra cuando el campo está vacío.
• required / max_length : si el campo es obligatorio y el número máximo de caracteres. Con required=False se puede enviar aunque esté vacío.
• on_submit : la función que se ejecuta cuando el usuario pulsa el botón "Enviar". Los valores introducidos se sacan con self.입력칸이름.value (cambia la parte del medio por el nombre de tu campo).

💡 Aquí, ephemeral=True es la opción para responder con un "mensaje que solo ves tú". ¡Es perfecta para respuestas que los demás no deben ver, como sugerencias o reportes!

📌 Paso 2 - Abrir el modal con un Slash Command

Los botones y los menús desplegables los enviábamos dentro de una View, pero ¡el modal no necesita View! En su lugar, lo abres directamente con interaction.response.send_modal().

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

@bot.event
async def on_ready():
    await bot.tree.sync()
    print(f"✅ ¡{bot.user} ha iniciado sesión!")

@bot.tree.command(name="건의하기", description="¡Deja tu sugerencia para el servidor!")
async def suggest(interaction: discord.Interaction):
    await interaction.response.send_modal(SuggestModal())

La clave es que send_modal() tiene que ser la primera respuesta. Si ya respondiste con interaction.response.send_message() u otro método, ya no puedes abrir el modal. Por eso, lo normal es abrir el modal en cuanto el usuario ejecuta el slash command.

📌 Paso 3 - Añadir manejo de errores (opcional)

Si añades on_error por si algo falla al enviar el modal, el bot será más seguro.

async def on_error(self, interaction: discord.Interaction, error: Exception):
    await interaction.response.send_message(
        "⚠️ Ocurrió un error al procesarlo. Inténtalo de nuevo en un momento.", ephemeral=True
    )
    print(error)

Esta función va dentro de la clase SuggestModal de arriba, debajo de on_submit y con la misma sangría.

📌 Código completo (puedes copiar y pegar)

# discord.py 2.x / Python 3.8+
import discord
from discord.ext import commands

class SuggestModal(discord.ui.Modal, title="Buzón de sugerencias 📮"):
    subject = discord.ui.TextInput(
        label="Título",
        placeholder="Escribe el título de tu sugerencia",
        max_length=50,
    )
    content = discord.ui.TextInput(
        label="Contenido",
        style=discord.TextStyle.long,
        placeholder="¡Escribe los detalles con total libertad!",
        required=True,
        max_length=500,
    )

    async def on_submit(self, interaction: discord.Interaction):
        await interaction.response.send_message(
            f"✅ ¡Hemos recibido tu sugerencia!\n**Título:** {self.subject.value}\n**Contenido:** {self.content.value}",
            ephemeral=True,
        )

    async def on_error(self, interaction: discord.Interaction, error: Exception):
        await interaction.response.send_message(
            "⚠️ Ocurrió un error al procesarlo. Inténtalo de nuevo en un momento.", ephemeral=True
        )
        print(error)

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

@bot.event
async def on_ready():
    await bot.tree.sync()
    print(f"✅ ¡{bot.user} ha iniciado sesión!")

@bot.tree.command(name="건의하기", description="¡Deja tu sugerencia para el servidor!")
async def suggest(interaction: discord.Interaction):
    await interaction.response.send_modal(SuggestModal())

bot.run("TU_TOKEN_DEL_BOT")

📌 Resultado

Al escribir /건의하기 (sugerir), aparece en el centro de la pantalla la ventana emergente "Buzón de sugerencias" (건의함) con dos campos: Título (제목) y Contenido (내용). Al rellenarlos y pulsar Enviar, recibes un mensaje que solo ves tú: "¡Hemos recibido tu sugerencia!".

💡 Extra: si quieres enviar lo que recibes a un canal de administradores, busca ese canal dentro de on_submit y envíalo como embed. ¡Así tendrás un auténtico "bot de buzón de sugerencias"!

async def on_submit(self, interaction: discord.Interaction):
    log_channel = interaction.guild.get_channel(관리자채널_ID)
    embed = discord.Embed(title=f"📮 Nueva sugerencia: {self.subject.value}", description=self.content.value)
    embed.set_footer(text=f"Enviado por: {interaction.user}")
    await log_channel.send(embed=embed)
    await interaction.response.send_message("✅ ¡Hemos recibido tu sugerencia!", ephemeral=True)

📌 Errores frecuentes

1. InteractionResponded: This interaction has already been responded to

Este error aparece si vuelves a llamar a send_modal() en una interacción a la que ya respondiste. El modal siempre tiene que abrirse como primera respuesta. Si ya diste otra respuesta, por ejemplo en el callback de un botón, ya no puedes abrir el modal.

2. No aparece porque tiene 6 campos o más

En un solo modal caben hasta 5 TextInput como máximo. Si necesitas recoger más datos, divide el contenido y diséñalo en varios pasos.

3. AttributeError: 'str' object has no attribute 'value'

Al sacar el valor introducido, no uses self.subject: tienes que añadir .value, como en self.subject.value, para obtener el texto real. Si olvidas el .value, obtienes el propio objeto TextInput.

📌 Para terminar

¡Hoy vimos cómo pedir al usuario que escriba texto directamente con un modal (Modal)! Pasando por botones → menús desplegables → modales, ya hemos visto casi toda la UI de interacción de Discord 🙌 En el próximo episodio veremos cómo decorar los embeds (Embed) con imágenes y campos para que queden bonitos. ¡No te lo pierdas!

📚 Serie Crear un bot de Discord #4 Envía embeds con Slash Commands #5 Implementa interacciones con botones (Button) #6 Implementa menús desplegables (Select Menu) #7 Pide texto al usuario con un modal (Modal) ← ¡estás leyendo este!