ホーム › 使い方ガイド › discord.py で埋め込み(Embed)メッセージを作る方法|色・画像・フィールドまで
GUIDE

discord.py で埋め込み(Embed)メッセージを作る方法|色・画像・フィールドまで

左に色の線が付いた、タイトルや項目つきのメッセージを「埋め込み(Embed)」と呼びます。お知らせ・ヘルプ・ステータス表示など、見やすい Bot を作るには欠かせません。このページでは、discord.py での Embed の作り方を、基本から画像・フィールド・よくあるエラーまで説明します。

基本の Embed

@bot.tree.command(name="info", description="サーバーの情報を表示します")
async def info(interaction: discord.Interaction):
    embed = discord.Embed(
        title="サーバー情報",
        description="このサーバーの基本情報です。",
        color=discord.Color.green(),
    )
    embed.add_field(name="メンバー数", value=str(interaction.guild.member_count))
    embed.add_field(name="作成日", value=interaction.guild.created_at.strftime("%Y/%m/%d"))
    await interaction.response.send_message(embed=embed)

Embed で設定できる項目

項目書き方表示される場所
タイトルtitle="..."一番上の太字
説明文description="..."タイトルの下
色color=0x22c55e左の線の色
リンクurl="https://..."タイトルがリンクになる
フィールドadd_field(name, value, inline)本文の項目
作成者set_author(name, icon_url)タイトルの上
サムネイルset_thumbnail(url)右上の小さい画像
画像set_image(url)下の大きい画像
フッターset_footer(text, icon_url)一番下の小さい文字
時刻timestamp=discord.utils.utcnow()フッターの横

画像・アイコン・フッターを付ける

embed = discord.Embed(title="プロフィール", color=0x22c55e, timestamp=discord.utils.utcnow())
member = interaction.user
embed.set_author(name=member.display_name, icon_url=member.display_avatar.url)
embed.set_thumbnail(url=member.display_avatar.url)
embed.add_field(name="参加日", value=member.joined_at.strftime("%Y/%m/%d"), inline=True)
embed.add_field(name="ロール数", value=str(len(member.roles) - 1), inline=True)
embed.set_footer(text="Steller Bot")

inline=True のフィールドは横に並び(最大3つ)、inline=False は1行を使います。

手元の画像ファイルを使う

インターネット上の URL ではなく、手元の画像を Embed に表示するには、ファイルとして一緒に送り、attachment://ファイル名 で指定します。

file = discord.File("images/banner.png", filename="banner.png")
embed = discord.Embed(title="お知らせ")
embed.set_image(url="attachment://banner.png")
await interaction.response.send_message(embed=embed, file=file)

送った Embed をあとから書き換える

msg = await channel.send(embed=embed)
embed.description = "更新しました"
await msg.edit(embed=embed)

ステータス表示やランキングなど、内容が変わるメッセージに便利です。

文字数などの上限

  • タイトル:256文字まで
  • 説明文:4096文字まで
  • フィールド:25個まで(名前256文字・値1024文字まで)
  • フッター:2048文字まで
  • 1つの Embed 全体で6000文字まで、1メッセージに Embed は10個まで

上限を超えると 400 Bad Request (error code: 50035): Invalid Form Body というエラーになります。長いデータは複数の Embed やページ分けにしましょう。

よくあるエラー

Embed が表示されない(リンクのテキストだけ出る)

Bot に「埋め込みリンク(Embed Links)」の権限がありません。サーバー設定のロールで権限を付けてください。

画像が表示されない

URL が画像そのものを指しているか(.png などで終わる直リンクか)、ローカル画像なら attachment:// のファイル名が一致しているかを確認します。

まとめ

  • discord.Embed(title, description, color) で作り、add_field で項目を足す
  • 画像は set_image、ローカル画像は attachment://
  • 文字数の上限と「Embed Links」権限に注意

Discord Bot を、月 ¥180 で24時間。

支払い後およそ2分で、日本のサーバーが自動で用意されます。 プランを見る →

ほかのガイド

discord.py でボタン・セレクトメニューを作る方法|再起動後も動く永続ボタンまでdiscord.ui を使ったボタン・セレクトメニュー・入力フォーム(モーダル)の作り方と、Bot を再起動しても押せる永続ボタンの作り方を解説します。読む → Discord Bot で参加時の歓迎メッセージ・ロール自動付与を作る方法discord.py でメンバーの参加・退出を検知し、歓迎メッセージ・ロールの自動付与・DM 送信を作る方法と、動かないときの確認ポイントを解説します。読む → Discord Bot のレート制限(429 Too Many Requests)の原因と対処法Bot のログに出る 429・We are being rate limited の意味と、ループでの連続送信や短すぎる定期処理などの原因、待ち時間を入れるなどの対処法を解説します。読む → discord.py のよくあるエラー一覧と解決方法【まとめ】LoginFailure・PrivilegedIntentsRequired・ModuleNotFoundError・Missing Permissions・インタラクションに失敗しました など、discord.py でよく出るエラーの意味と直し方を一覧にまとめました。読む → requirements.txt の書き方|Bot に必要なライブラリをサーバーに入れる方法サーバーで ModuleNotFoundError が出る原因と、requirements.txt の書き方・自動で作る方法・バージョン指定・import 名とインストール名が違うライブラリの一覧を解説します。読む → discord.py の Cog でコマンドをファイルごとに分ける方法discord.py 2.x の Cog を使って、コマンドやイベントを機能ごとのファイルに分ける方法を解説。setup・load_extension・再読み込み・よくあるエラーまで紹介します。読む →