Discord Bot Tutorial#5Implementing Button Interactions!

Hi there! This is Mojangcam 😎

In Part #4, we sent embeds with slash commands, right? This time we're going one step further and adding clickable buttons to our messages! Let's build a truly "interactive bot" that responds when someone clicks a button.

Once you're done, you'll be able to do things like:

• Give users a choice with ✅ Confirm / ❌ Cancel buttons
• One-click features like 🎫 creating tickets or granting roles
• Send replies that only the person who clicked the button can see

📌 What You Need

• Python 3.8 or later
• discord.py 2.x (buttons are supported starting from 2.0!)
• A bot token + the bot already invited to your server (see Part 1!)

pip install -U discord.py

If your version is older, make sure to update it. You can check your version with pip show discord.py.

📌 Step 1 - The Core of Buttons: Understanding the View

In discord.py, you can't use a button on its own. You put it in a container called a View and send it along with a message.

• discord.ui.View → a box that holds buttons, dropdowns, and so on 📦
• The discord.ui.button decorator → creates a button inside the View and connects the function to run when it's clicked

Let's look at the structure first!

import discord

class MyView(discord.ui.View):
    @discord.ui.button(label="Click me!", style=discord.ButtonStyle.primary)
    async def my_button(self, interaction: discord.Interaction, button: discord.ui.Button):
        await interaction.response.send_message("The button was clicked!")

⚠️ The callback's parameter order is (self, interaction, button). It's the reverse of examples from other libraries (like pycord), so it's easy to mix up. Watch out!

📌 Step 2 - Getting to Know Button Styles

There are 5 button colors you can pass to style=.

📌 Step 3 - Building Confirm/Cancel Buttons

Let's build the Confirm/Cancel pattern, the one you'll use most in real projects.

class ConfirmView(discord.ui.View):
    def __init__(self):
        super().__init__(timeout=60)  # disable the buttons after 60 seconds

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

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

Key points 💡

• timeout=60 : after 60 seconds, the buttons stop working (the default is 180 seconds)
• edit_message(..., view=None) : when a button is clicked, it edits the original message and removes the buttons
• interaction.response can respond exactly once, within 3 seconds. If you need to send more, use interaction.followup.send()!

📌 Step 4 - Full Code (Copy-Paste OK)

Here's the finished version combined with a 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="Confirm", style=discord.ButtonStyle.success)
    async def confirm(self, interaction: discord.Interaction, button: discord.ui.Button):
        await interaction.response.edit_message(content="✅ Confirmed!", view=None)

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

@bot.event
async def on_ready():
    await bot.tree.sync()
    print(f"{bot.user} bot is ready!")

@bot.tree.command(name="확인", description="Sends Confirm/Cancel buttons")
async def confirm_command(interaction: discord.Interaction):
    await interaction.response.send_message("Shall we proceed?", view=ConfirmView())

bot.run("Token")

📌 Checking the Result

Run the bot and type /확인 (confirm) in a Discord channel, and you'll see the "Shall we proceed?" message along with a green Confirm button and a red Cancel button! When you click a button, the message changes to "✅ Confirmed!" and the buttons disappear.

📌 Common Errors

1. I clicked the button and it says "This interaction failed"

This happens when the callback doesn't respond within 3 seconds. If your processing takes a while, call await interaction.response.defer() first.

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

This is a callback parameter order problem! In discord.py 2.x, the order is (self, interaction, button). If you write (self, button, interaction), you'll get this error.

3. After restarting the bot, the buttons on older messages don't work

By default, a View only exists in memory. To keep it working after a restart, you need to create a persistent view with timeout=None + a custom_id, and register it with bot.add_view(). (I'll cover this in an advanced part later!)

📌 Wrapping Up

Today we implemented click interactions using discord.py's View and buttons.

• Buttons are sent inside a View
• 5 styles (primary/secondary/success/danger/link)
• Respond within 3 seconds, and only once!

In the next part, we'll build a dropdown (Select Menu). Stay tuned 🙌

📚 Discord Bot Tutorial Series

1. Mastering Slash Commands
2. Adding Options (Arguments) to Slash Commands
3. Adding Subcommands to Slash Commands
4. Sending Embeds with Slash Commands
5. Implementing Button Interactions ← You are here!