Documentation Index
Fetch the complete documentation index at: https://mintlify.com/astrxnomo/discord-ticket-bot-py/llms.txt
Use this file to discover all available pages before exploring further.
The Discord Ticket Bot exposes a single text command that administrators use to post the support panel, plus a set of button and select-menu interactions that drive the entire ticket lifecycle. Understanding each interaction’s custom_id, trigger, and effect makes it straightforward to trace exactly what the bot will do at every step.
Text Commands
tb!ticket
| Property | Detail |
|---|
| Prefix | tb! |
| Permission | Administrator only (has_permissions(administrator=True)) |
| Usage | tb!ticket |
- Delete the message that triggered the command, keeping the channel tidy.
- Send an embed titled Tickets with the description “Welcome to tickets system.” and a banner image.
- Attach a single green button — 🔧 Create a ticket — that members click to open a ticket.
@bot.command()
@commands.has_permissions(administrator=True)
async def ticket(ctx):
await ctx.message.delete()
embed = discord.Embed(
title='Tickets',
description='Welcome to tickets system.',
color=embed_color
)
embed.set_image(url='https://i.imgur.com/FoI5ITb.png')
await ctx.send(
embed=embed,
components=[
Button(custom_id='Ticket', label="Create a ticket",
style=ButtonStyle.green, emoji='🔧')
]
)
Because the bot is initialised with help_command=None, there is no tb!help command. The only text command exposed to users is tb!ticket.
All button interactions are handled inside the on_button_click event. Each button is identified by its custom_id.
Ticket — Create a ticket
| Property | Detail |
|---|
| custom_id | Ticket |
| Style | Green |
| Emoji | 🔧 |
| Trigger | Member clicks Create a ticket on the panel embed |
| Effect | Bot responds with a select menu asking “How can we help you?” |
tb!ticket. Clicking it does not yet create a channel; instead it shows the category select menu so the member can describe the nature of their request.
call_staff — Call staff
| Property | Detail |
|---|
| custom_id | call_staff |
| Style | Blue |
| Emoji | 🔔 |
| Trigger | Member clicks Call staff inside an open ticket channel |
| Effect | Bot sends an embed mentioning the staff role; message auto-deletes after 20 seconds |
🔔 {member mention} has called the staff. and pings the configured staff role so members of that role receive a notification.
elif interaction.component.custom_id == 'call_staff':
embed_llamar_staff = discord.Embed(
description=f"🔔 {interaction.author.mention} has called the staff.",
color=embed_color
)
await canal.send(f'<@&{id_staff_role}>', embed=embed_llamar_staff, delete_after=20)
close_ticket — Close ticket
| Property | Detail |
|---|
| custom_id | close_ticket |
| Style | Red |
| Emoji | 🔐 |
| Trigger | Member or staff clicks Close ticket inside a ticket channel |
| Effect | Bot sends a confirmation embed with Yes and No buttons |
close_yes — Confirm closure
| Property | Detail |
|---|
| custom_id | close_yes |
| Style | Green |
| Label | Yes |
| Trigger | User clicks Yes on the closure confirmation |
| Effect | Ticket channel is deleted; a log embed is posted to the logs channel |
id_channel_ticket_logs recording which ticket was closed and who closed it.
elif interaction.component.custom_id == 'close_yes':
await canal.delete()
embed_logs = discord.Embed(
title="Tickets",
description="",
timestamp=datetime.datetime.utcnow(),
color=embed_color
)
embed_logs.add_field(name="Ticket", value=f"{canal.name}", inline=True)
embed_logs.add_field(name="Closed by", value=f"{interaction.author.mention}", inline=False)
embed_logs.set_thumbnail(url=interaction.author.avatar_url)
await canal_logs.send(embed=embed_logs)
close_no — Cancel closure
| Property | Detail |
|---|
| custom_id | close_no |
| Style | Red |
| Label | No |
| Trigger | User clicks No on the closure confirmation |
| Effect | The confirmation message is deleted; the ticket channel remains open |
The select menu (custom_id="menu") is shown in response to the Ticket button click. It presents three options under the placeholder text “How can we help you?”. Selecting an option triggers the on_select_option event, which creates a private ticket channel.
| Option | Value | Emoji | Description shown in menu | Channel name created |
|---|
| Question | question | ❔ | If you have a simple question. | ❔┃{username}-ticket |
| Help | help | 🔧 | If you need help from us. | 🔧┃{username}-ticket |
| Report | report | 🚫 | To report a misbehaving user. | 🚫┃{username}-ticket |
The channel name embeds the selecting member’s Discord username, making it easy to identify who owns a ticket at a glance from the channel list.