ホーム › 使い方ガイド › discord.py でチケット(お問い合わせ)機能を作る方法
GUIDE

discord.py でチケット(お問い合わせ)機能を作る方法

ボタンを押すと、本人とスタッフだけが見られる専用チャンネルが作られる「チケット機能」は、サポートや購入窓口、通報受付に便利です。このページでは、discord.py でボタン付きのチケットパネルを作り、専用チャンネルの作成・閉じる処理までを実装する方法を説明します。

できあがりの流れ

  1. 管理者が /ticket_panel で「チケットを作成」ボタン付きのメッセージを置く
  2. メンバーがボタンを押すと、本人とスタッフだけが見えるチャンネルが作られる
  3. 対応が終わったら「閉じる」ボタンでチャンネルを削除する

準備

  • チケット用のカテゴリを作り、その 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・回線・プログラムのエラー・メモリ不足・レート制限・トークンの順に解説。ログの見方と、止まりにくくする対策を紹介します。読む →