discord.py 슬래시 임베드 생성 시 흔한 오류와 빠른 해결법

Question

도와주실분

파이썬입ㄴ디ㅏ

입니다

그

제가 코드를 지피티한테 맡기긴했는데

코드좀 보여드릴게요

import discord
from discord.ext import commands
from discord import app_commands

TOKEN = "봇토큰"

intents = discord.Intents.default()

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

@bot.event
async def on_ready():
    try:
        synced = await bot.tree.sync()
        print(f"슬래시 명령어 {len(synced)}개 동기화 완료")
    except Exception as e:
        print(e)

print(f"{bot.user} 로그인 완료")

@bot.tree.command(name="임베드생성", description="임베드를 생성합니다.")
@app_commands.describe(
    채널="보낼 채널",
    제목="임베드 제목",
    내용="임베드 내용",
    색상="red, blue, green, gold, purple",
    이미지="이미지 URL (선택)",
    버튼이름="버튼 이름 (선택)",
    버튼링크="버튼 링크 (선택)"
)
async def 임베드생성(
    interaction: discord.Interaction,
    채널: discord.TextChannel,
    제목: str,
    내용: str,
    색상: str,
    이미지: str = None,
    버튼이름: str = None,
    버튼링크: str = None
):

색상목록 = {
        "red": discord.Color.red(),
        "blue": discord.Color.blue(),
        "green": discord.Color.green(),
        "gold": discord.Color.gold(),
        "purple": discord.Color.purple()
    }

embed = discord.Embed(
        title=제목,
        description=내용,
        color=색상목록.get(색상.lower(), discord.Color.blurple())
    )

if 이미지:
        embed.set_image(url=이미지)

view = None

if 버튼이름 and 버튼링크:
        view = discord.ui.View()

button = discord.ui.Button(
            label=버튼이름,
            url=버튼링크
        )

view.add_item(button)

await 채널.send(embed=embed, view=view)

await interaction.response.send_message(
        f"✅ {채널.mention} 채널에 임베드를 전송했습니다.",
        ephemeral=True
    )

bot.run("")

마지막에 토큰은 공개되면 안돼서 지웠어요

고쳐야되거나 지워야되는거 등 그런거 있을까요?

ㅜㅜ

오 감사합니다 ㅜㅜ

예외 처리는 어떻게 하는걸까요?

gpt랑 재미나이는 이제 못믿을거같아서 제가 프롬프트를 잘못입력하는지는 모르겠지만 자꾸 틀린걸 알려줘서..

오오 넵

도와주셔서 감사합니다

그

여기쪽에 := 여기에 오류가 있다고 떠서
[이미지 1개 생략 — 원본 스레드 참고]

넵

네넵

잠시만용

고쳤습니다

잠시만용

이제 실행해보면 되나요?

그리고 그

토큰에 오류가 있다는데 그건 원래 그런거겠죠?

아 토큰 양 옆에다가 ""이걸 하면되는구나

네넵

이건
[이미지 1개 생략 — 원본 스레드 참고]

dㅡㅁ

음

dㅏ아

네네 이제 없어졌어ㅛ

이제 실행 하면 되나용?

오류 그런거 다 없는데

네ㅂ

넵

흠

!임베드생성 명령어를 해도 뭐가 안뜨네요..

/ 명령어도 안뜨고 음

사용이 안됩니다

ㅜㅜ

재로딩 해봤어요

흠

네

아 늦으셔도 전

감사해용

그냥 도와주시는것만으로도 감사합니당

부족하거나 새로 추가해야할거 있나요?

수정이나

옹

오 네넵

잠시만용

바꾸고 토큰도 넣어봤어용

이제 한번 해볼게용

흠

왜 안되는거징.. 뭐 잘못한게 있는걸까용?

뭐 등록같은걸 해야되나요?

네넵

안뜨네요..

ㅎ므

흠

진짜 봇 개발자분들 대단하시네요

흠

```python
import discord
from discord.ext import commands
from discord import app_commands

TOKEN = "YOUR_BOT_TOKEN"

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} 로그인 완료")

@bot.tree.command(name="임베드생성", description="임베드를 생성합니다.")
@app_commands.describe(
    채널="보낼 채널",
    제목="임베드 제목",
    내용="임베드 내용",
    색상="red, blue, green, gold, purple",
    이미지="이미지 URL (선택)"
)
async def 임베드생성(
    interaction: discord.Interaction,
    채널: discord.TextChannel,
    제목: str,
    내용: str,
    색상: str,
    이미지: str = None
):

colors = {
        "red": discord.Color.red(),
        "blue": discord.Color.blue(),
        "green": discord.Color.green(),
        "gold": discord.Color.gold(),
        "purple": discord.Color.purple()
    }

embed = discord.Embed(
        title=제목,
        description=내용,
        color=colors.get(색상.lower(), discord.Color.blurple())
    )

if 이미지:
        embed.set_image(url=이미지)

await 채널.send(embed=embed)

await interaction.response.send_message(
        "✅ 임베드가 생성되었습니다.",
        ephemeral=True
    )

bot.run(TOKEN)
```

지피티가 코드 만들어줬는데

음

저 그

윈도우여서

해봤는데

새로고침도 안되서..

진짜 귀찮게 해서 죄송해용..

저 지피티한테

해달라해서

버전 업글하고 해서

성공했어요

디스호스트 · Accepted Answer

문제 상황: discord.py로 만든 슬래시 임베드 명령어가 작동하지 않거나 에러가 나는 주요 원인은 message_content 인텐트 미설정, interaction.response를 늦게 호출해 타임아웃 발생, discord.ui.View를 None으로 넘겨주는 오류, 잘못된 이미지/버튼 URL로 인한 예외, 토큰 하드코딩 등입니다.
해결책: Developer Portal에서 필요한 인텐트 활성화 및 봇 초대에 application.commands 스코프 포함, interaction.response.send_message()나 defer()로 빠르게 응답 후 channel.send를 실행하며 view는 값이 있을 때만 전달하고 URL은 startswith 검사/try-except로 검증하고 토큰은 .env로 분리한 뒤 bot.tree.sync()로 슬래시 명령어를 동기화하세요.

지혜로운 하프물범 · Answer

혹시 파이썬 이신가여? 아님 자바이신가요?

만약 파이썬중에서도 discord.py 사용하신다면
```py
embed = discord.Embed(
            title="임베드 제목",
            description="임베드 내용",
            color=0x808080
        )
```
위와 같은 코드블럭 이용해서 임베드 작성 할 수 있습니다. 정확히 어떤 임베드를 원하시는 지 몰라 기본적인 에제만 알려드려요

맡긴 코드도

같이 보여주실레요?

# 1. intents.message_content 누락
`intents = discord.Intents.default()`로 설정 하셨는데, 디스코드 API 정책상, 슬래시 명령어를 등록하고 봇이 정상적으로 작동하려면 `message_content` 인텐트가 활성화되어 있어야 하는 경우가 많습니다. 디스코드 개발자 포털(Developer Portal)에서도 해당 인텐트를 켜주세요.

# 2. view 매개변수 오류 (view=None 처리)
버튼 이름이나 링크를 입력하지 않았을 때, view 변수는 None으로 유지 됩니다. 이를  `채널.send(embed=embed, view=view)`에서 `view=none` 그대로 넘겨주면 디스코드 라이브러리 버전에 따라 오류가 발생할 수 있습니다. 조건문으로 분기하거나, 값이 있을 때만 넘겨주셔야 할거 같습니다.

# 3. 유효하지 않은 URL 입력 시 에러 (예외 처리 필요)
사용자가 이미지나 버튼링크에 올바르지 않은 형식의 URL을 입력하면, 봇이 임베드를 보내다가 에러가 나서 멈춰버립니다. 이 부분에 대한 예외 처리(try-except)가 필요합니다.

일단 이렇게 3가지 문제점을 찾았습니다.

제가 간단히 수정한걸 올려드릴게요
[첨부파일 1개 생략]

그리고 변수명 한글로 쓰신거 있으신데, 프로그래밍 하실때는 변수명은 한글보다는 영어로 쓰시는거 권장드려요.

토큰도 하드코딩되어있으면 보안에 많이 취약합니다. `.env`로 토큰 분리하시는거 권장 드립니다.

넵

그 원문 코드에서 있던 오류인데

잠시만여

```py
if view:
        if button_link.startswith(("http://", "https://")): 
            button = discord.ui.Button(label=button_name, url=button_link)
            view.add_item(button)
        else:
            await interaction.response.send_message("❌ 올바른 버튼 링크 URL 형식이 아닙니다.", ephemeral=True)
            return```
로 고치시면 될거 같습니다.

`token="봇토큰"`에서 봇토큰 자리에 원래 토큰 넣으셔야해요

저 조건문 대신에

if button_link.startswith(("http://", "https://")): 로 바꿔주세요

네 혹시 오류 더 있으면 채팅 주세요

네네

잠시만요

코드를 다시 봤는데요..

## interaction.response 응답 이전에 channel.send를 먼저 처리함 (가장 큰 원인)
디스코드 슬래시 명령어는 유저가 명령어를 입력한 후 최대 3초 이내에 `interaction.response.send_message()`나 `defer()`를 통해 디스코드 서버에 응답을 보냅니다. 하지만 현재 코드에서는 `channel.send()`로 다른 채널에 메시지를 보내는 작업을 먼저 처리하고,  `interaction.response.send_message()`을 호출하고 있습니다. 만약 다른 채널에 메세지를 보내는 과정에서 약간의 지연이 발생하면 서버는 이 명령어가 실패했다고 판단하고 에러를 띄우면서 명령어를 취소합니다.

## 봇의 권한 및 인텐트(Intents) 문제
코드에서 `intents.message_content = True`를 설정했지만, 정작 슬래시 명령어를 연동하기 위한 `application.commands` 스코프(Scope)를 봇 초대 링크에 포함하지 않았거나, 봇이 지정된 채널을 볼 수 없는 상태일 수 있습니다.

이렇게 수정했어요
[첨부파일 1개 생략]

슬래시 명령어 말씀하시는거면

새로고침 한번 하고 해보세요

저 소스코드로

전 작동이 됬었는데...

그 캐시새로고침이라고

맥은 커맨드 + 시프 트 + R 로 하눈

새로고침이 있거든요?

그걸로 새로고침 하고 작동 해보셨을까요?

타임스탬프 생성기

웹훅 제너레이터

임베드 빌더

마크다운 에디터

봇 권한 계산기

discord.py 슬래시 임베드 생성 시 흔한 오류와 빠른 해결법

AI 요약 (TL;DR)

원본 디스코드 대화 기록 (105개 메시지)

1. intents.message_content 누락

2. view 매개변수 오류 (view=None 처리)

3. 유효하지 않은 URL 입력 시 에러 (예외 처리 필요)

interaction.response 응답 이전에 channel.send를 먼저 처리함 (가장 큰 원인)

봇의 권한 및 인텐트(Intents) 문제

연관 트러블슈팅 질문

디스코드 봇 토큰·패스키 문제 빠른 해결법

사이트 내 백업 보관기간은 무기한인가요?

디스코드 미니게임 상점이 명령어마다 초기화되는 문제 해결법