discord.py でチケット(お問い合わせ)機能を作る方法
ボタンを押すと、本人とスタッフだけが見られる専用チャンネルが作られる「チケット機能」は、サポートや購入窓口、通報受付に便利です。このページでは、discord.py でボタン付きのチケットパネルを作り、専用チャンネルの作成・閉じる処理までを実装する方法を説明します。
できあがりの流れ
- 管理者が
/ticket_panelで「チケットを作成」ボタン付きのメッセージを置く - メンバーがボタンを押すと、本人とスタッフだけが見えるチャンネルが作られる
- 対応が終わったら「閉じる」ボタンでチャンネルを削除する
準備
- チケット用のカテゴリを作り、その ID をメモします。
- 対応するスタッフ用のロールを作り、その ID をメモします。
- Bot に「チャンネルの管理」「ロールの管理」の権限を付けます。
コード
import asyncio
import discord
from discord import ui, app_commands
from discord.ext import commands
CATEGORY_ID = 123456789012345678 # チケット用カテゴリ
STAFF_ROLE_ID = 234567890123456789 # スタッフのロール
class CloseView(ui.View):
def __init__(self):
super().__init__(timeout=None)
@ui.button(label="閉じる", style=discord.ButtonStyle.danger, custom_id="ticket:close")
async def close(self, interaction: discord.Interaction, button: ui.Button):
await interaction.response.send_message("5秒後にこのチャンネルを削除します。")
await asyncio.sleep(5)
await interaction.channel.delete(reason=f"チケットを閉じた: {interaction.user}")
class TicketView(ui.View):
def __init__(self):
super().__init__(timeout=None)
@ui.button(label="チケットを作成", style=discord.ButtonStyle.green, emoji="🎫", custom_id="ticket:open")
async def open(self, interaction: discord.Interaction, button: ui.Button):
guild = interaction.guild
name = f"ticket-{interaction.user.name}".lower()
if discord.utils.get(guild.text_channels, name=name):
return await interaction.response.send_message("すでにチケットがあります。", ephemeral=True)
overwrites = {
guild.default_role: discord.PermissionOverwrite(view_channel=False),
interaction.user: discord.PermissionOverwrite(view_channel=True, send_messages=True, attach_files=True),
guild.get_role(STAFF_ROLE_ID): discord.PermissionOverwrite(view_channel=True, send_messages=True),
guild.me: discord.PermissionOverwrite(view_channel=True, send_messages=True, manage_channels=True),
}
channel = await guild.create_text_channel(
name, category=guild.get_channel(CATEGORY_ID), overwrites=overwrites,
)
await channel.send(
f"{interaction.user.mention} さん、お問い合わせ内容を書いてください。スタッフが対応します。",
view=CloseView(),
)
await interaction.response.send_message(f"チケットを作成しました:{channel.mention}", ephemeral=True)
class MyBot(commands.Bot):
async def setup_hook(self):
self.add_view(TicketView()) # 再起動後もボタンが動くように
self.add_view(CloseView())
await self.tree.sync()
bot = MyBot(command_prefix="!", intents=discord.Intents.default())
@bot.tree.command(name="ticket_panel", description="チケット作成パネルを設置します")
@app_commands.default_permissions(administrator=True)
async def ticket_panel(interaction: discord.Interaction):
embed = discord.Embed(title="お問い合わせ", description="下のボタンを押すと、専用のチャンネルが作られます。", color=0x22c55e)
await interaction.channel.send(embed=embed, view=TicketView())
await interaction.response.send_message("設置しました", ephemeral=True)
ポイント
権限の上書き(overwrites)
guild.default_role(@everyone)を「見えない」にして、本人・スタッフ・Bot だけを「見える」にしています。これで他のメンバーからは見えないチャンネルになります。
永続ボタン
チケットパネルは長く置いておくので、timeout=None・固定の custom_id・add_view() の3つで、再起動後も押せるようにしています。詳しくは「ボタン・セレクトメニューの作り方」を見てください。
二重作成の防止
同じ名前のチャンネルがあれば作らないようにしています。より確実にするなら、作ったチャンネルの ID をデータベースに保存しておく方法もあります。
うまく動かないとき
- Missing Permissions:Bot に「チャンネルの管理」「ロールの管理」があるか確認
- チャンネルがカテゴリの外にできる:
CATEGORY_IDが正しいか確認 - ボタンを押しても反応しない:Bot が止まっていないか、
add_viewしているか確認
チケット機能は、問い合わせが来たときに Bot が動いていないと使えません。24時間動かすなら、StellaHost(月額 ¥180〜)のような止まらないサーバーがおすすめです。
まとめ
- ボタンで
create_text_channelし、overwritesで本人とスタッフだけに見せる - パネルとボタンは永続ビューにする
- 閉じるボタンで
channel.delete()
Discord Bot を、月 ¥180 で24時間。
支払い後およそ2分で、日本のサーバーが自動で用意されます。 プランを見る →ほかのガイド
discord.py で NG ワード削除・スパム対策・タイムアウトを作る方法discord.py で NG ワードを含むメッセージの自動削除、連投スパムの検知、タイムアウトを作る方法と、Discord 標準の AutoMod との使い分けを解説します。読む →
Discord Bot のステータス(プレイ中・視聴中)を表示・変更する方法discord.py で Bot の「○○をプレイ中」などのステータスを設定する方法、オンライン状態の変え方、導入サーバー数を表示して定期的に切り替える方法を解説します。読む →
Discord Bot がメッセージを読めない?Message Content Intent の設定方法コマンドに反応しない・message.content が空になる原因は Message Content Intent。Discord Developer Portal とコード(discord.py)の両方で有効にする手順を解説します。読む →
Discord Bot を24時間動かす方法|PCを閉じても止まらないPC を閉じると止まってしまう Discord Bot を、24時間動かし続ける方法を解説。自分の PC・無料ホスティング・Bot 用サーバーの違いと、月額 ¥180 から始められる手順を紹介します。読む →
Python で作った Discord Bot をサーバーで動かす手順discord.py などで作った Bot を、main.py と requirements.txt を置くだけでサーバーで動かす手順を解説。トークンの安全な置き方や、よくあるエラーの対処も紹介します。読む →
Discord Bot が勝手に止まる・落ちる原因と対処法Discord Bot がいつの間にかオフラインになる原因を、PC・回線・プログラムのエラー・メモリ不足・レート制限・トークンの順に解説。ログの見方と、止まりにくくする対策を紹介します。読む →