디스코드 봇 만들기 #5 - 버튼(Button) 상호작용 구현하기!

안녕하세요! Mojangcam입니다 😎

지난 #4편에서는 Slash Command로 임베드를 전송해봤죠? 이번에는 한 단계 더 나아가서, 메시지에 클릭할 수 있는 버튼(Button) 을 달아보겠습니다! 버튼을 누르면 봇이 반응하는, 진짜 "상호작용하는 봇"을 만들어봅시다.

완성되면 이런 것들이 가능해집니다:

✅ 확인 / ❌ 취소 버튼으로 유저에게 선택지 주기
🎫 티켓 생성, 역할 지급 같은 원클릭 기능
버튼을 누른 사람에게만 보이는 답장 보내기

📌 준비물

Python 3.8 이상
discord.py 2.x (버튼 기능은 2.0부터 지원됩니다!)
봇 토큰 + 서버에 봇 초대 완료 (1편 참고!)

터미널

pip install -U discord.py

버전이 낮다면 꼭 업데이트해주세요. 버전 확인은 pip show discord.py 로 할 수 있습니다.

📌 1단계 - 버튼의 핵심, View 이해하기

discord.py에서 버튼은 단독으로 못 쓰고, View라는 컨테이너에 담아서 메시지와 함께 보냅니다.

discord.ui.View → 버튼, 드롭다운 등을 담는 상자 📦
discord.ui.button 데코레이터 → View 안에 버튼을 만들고, 눌렀을 때 실행할 함수를 연결

구조만 먼저 볼게요!

Python

import discord

class MyView(discord.ui.View):
    @discord.ui.button(label="눌러봐!", style=discord.ButtonStyle.primary)
    async def my_button(self, interaction: discord.Interaction, button: discord.ui.Button):
        await interaction.response.send_message("버튼이 눌렸어요!")

⚠️ 콜백 함수의 매개변수 순서는 (self, interaction, button) 입니다. 다른 라이브러리(pycord 등) 예제와 순서가 반대라서 헷갈리기 쉬우니 주의하세요!

📌 2단계 - 버튼 스타일 알아보기

style= 에 넣을 수 있는 버튼 색상은 5가지입니다.

스타일	색상	용도 예시
`ButtonStyle.primary`	파란색	메인 동작
`ButtonStyle.secondary`	회색	보조 동작
`ButtonStyle.success`	초록색	확인/수락
`ButtonStyle.danger`	빨간색	삭제/거절
`ButtonStyle.link`	링크형	URL 이동 (url= 필요, 콜백 없음)

📌 3단계 - 확인/취소 버튼 만들기

실전에서 제일 많이 쓰는 확인/취소 패턴을 만들어보겠습니다.

Python

class ConfirmView(discord.ui.View):
    def __init__(self):
        super().__init__(timeout=60)  # 60초 뒤 버튼 비활성화

    @discord.ui.button(label="확인", style=discord.ButtonStyle.success)
    async def confirm(self, interaction: discord.Interaction, button: discord.ui.Button):
        await interaction.response.edit_message(content="✅ 확인되었습니다!", view=None)

    @discord.ui.button(label="취소", style=discord.ButtonStyle.danger)
    async def cancel(self, interaction: discord.Interaction, button: discord.ui.Button):
        await interaction.response.edit_message(content="❌ 취소되었습니다.", view=None)

포인트 정리 💡

timeout=60 : 60초가 지나면 버튼이 더 이상 동작하지 않습니다 (기본값은 180초)
edit_message(..., view=None) : 버튼을 누르면 원본 메시지를 수정하면서 버튼을 제거
interaction.response 는 3초 안에 딱 1번만 응답할 수 있습니다. 추가로 보내려면 interaction.followup.send() 를 사용하세요!

📌 4단계 - 전체 코드 (복붙 OK)

Slash Command와 합친 완성본입니다.

Python

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="확인", style=discord.ButtonStyle.success)
    async def confirm(self, interaction: discord.Interaction, button: discord.ui.Button):
        await interaction.response.edit_message(content="✅ 확인되었습니다!", view=None)

    @discord.ui.button(label="취소", style=discord.ButtonStyle.danger)
    async def cancel(self, interaction: discord.Interaction, button: discord.ui.Button):
        await interaction.response.edit_message(content="❌ 취소되었습니다.", view=None)

@bot.event
async def on_ready():
    await bot.tree.sync()
    print(f"{bot.user} 봇이 준비되었습니다!")

@bot.tree.command(name="확인", description="확인/취소 버튼을 보냅니다")
async def confirm_command(interaction: discord.Interaction):
    await interaction.response.send_message("진행할까요?", view=ConfirmView())

bot.run("Token")

📌 결과 확인하기

봇을 실행하고 디스코드 채널에서 /확인 을 입력하면 "진행할까요?" 메시지와 함께 초록색 확인, 빨간색 취소 버튼이 나타납니다! 버튼을 누르면 메시지가 "✅ 확인되었습니다!" 로 바뀌면서 버튼이 사라져요.

📌 자주 나는 에러

1. 버튼을 눌렀는데 "상호작용 실패"라고 떠요

콜백에서 3초 안에 응답하지 않았을 때 발생합니다. 처리에 시간이 걸린다면 await interaction.response.defer() 를 먼저 호출해주세요.

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

콜백 매개변수 순서 문제입니다! discord.py 2.x는 (self, interaction, button) 순서예요. (self, button, interaction) 으로 쓰면 이 에러가 납니다.

3. 봇을 재시작하면 이전 메시지의 버튼이 안 눌러져요

View는 기본적으로 메모리에만 존재합니다. 재시작 후에도 동작하게 하려면 timeout=None + custom_id 를 지정한 persistent view를 만들고 bot.add_view() 로 등록해야 해요. (이건 나중에 심화편에서 다룰게요!)

📌 마무리

오늘은 discord.py의 View와 버튼으로 클릭 상호작용을 구현해봤습니다.

버튼은 View에 담아서 전송
스타일 5종 (primary/secondary/success/danger/link)
응답은 3초 안에, 1번만!

다음 편에서는 드롭다운(Select Menu) 메뉴를 만들어볼 예정이에요. 기대해주세요 🙌

📚 디스코드 봇 만들기 시리즈