Tickets

Learn how to setup the Ticket module.

Replace [prefix] with your server's prefix.

You can also run these commands as slash commands, as they sometimes work better this way.

Setup the Ticket System

To setup a simple ticket system for your server, you'll just need to run [prefix]ticket send #channel. By using this, the bot will send the normal ticket embed with the open button. By using this, the bot will only create a category-less ticket channel for the user.

// Syntax
[prefix]ticket send [#channel]

// Example
;ticket send #create-ticket

Setup of the ticket panel

Setup a Support Role

If you want, that your staff gets pinged on an opened ticket and so that they can interact with the buttons, you'll need to run the command [prefix]ticket support @role

// Syntax
[prefix]ticket support [role]

// Example
;ticket support @staff

Set a support role (topic-less)

Create a Opened Embed

A opened embed is the embed that will be displayed, when a user opens a ticket. If you want to set a custom one, you can do this by running the command below. Also you can use the variables to display the support role mention, so that staff members get notified, when a user opens a ticket.

// Syntax
[prefix]ticket opened [code]

// Example
;ticket opened {content: {user.mention} | {support_role.mention}}{embed}{title: hi!}

The opened embed command output

The in-ticket embed you've set

Start with writing Embed Code

Embed Variables

Create a Category

Currently, the tickets will be created outside of any category - to change this, we need to set a category first using [prefix]ticket category [category]

// Syntax
[prefix]ticket category [category]

// Example
;ticket support ticket-category

Set a category for the tickets to get created (topic-less)

Tickets will now get created in the designated category

If you want to remove the support role or the category, just use [prefix]ticket support/category without a parameter (channel/role) behind it.

Create a Closed Category

Ticket categorys can get messy really quickly with closed and opened tickets. So lets clean up things with a category, where closed tickets will get moved into by serenity.

// Syntax
[prefix]ticket closed [category]

// Example
;ticket closed closed-tickets

Tickets will only get moved into the closed category, if you use the "Close"-Button in-ticket or with the [prefix]ticket close command.

Create a Transcript Channel

Serenity offers a way, to transcript closed tickets - Simply use [prefix]ticket logs #channel to set a channel where the transcript url embeds will get sent.

// Syntax
[prefix]ticket logs [channel]

// Example
;ticket logs #logging

Setup Auto-Transcripting

Normally transcripts will only get generated, if you use the "Transcript"-Button on the in-ticket embed. But if you want, that serenity generates a transcript, everytime you delete the ticket via [prefix]ticket delete or directly via the "Delete"-Button, you can toggle activate this using [prefix]ticket autotranscript

Setup Ticket-Topics

Community discord server normally need multiple topics for ticket systems (e.g., Support, Giveaways,...) - and serenity got you covered. You can create different topics, with different support roles and categories. But first things first, lets create a ticket topic.

// Syntax
[prefix]ticket topics

// Example
;ticket topics

By executing this command, you'll get prompted with this embed.

Click now on the "add topic"-Button to get your Topic Modal where you can created your first topic. Everything in there is pretty self-explanatory. The emoji input field is for the emoji, that will get displayed in the select menu when a user can choose which ticket topic he wants to open.

Emoji Markdown

If you don't know how to get the emoji markdown for the input field, you can use a backslash (\) in your chat field, and then select the emoji from the discord emoji menu to get the emoji markdown, like in the first image below. Also you can get the emoji markdown by using the serenity command [prefix]emoji info [emoji]

If you want to use the backslash method

Preview for the emoji info command

If you've successfully created a topic, users' will get greeted with this prompted to pick, which topic they preferly need.

You can only have up to 25 topics in your ticket system, as its a limit from the discord API itself.

Edit a Topic

If you want to change the topic name, description or emoji afterwards, you can do this by running the desired command below.

// Syntax
[prefix]ticket topic name [topic] [new_name]
[prefix]ticket topic description [topic] [new_description]
[prefix]ticket topic emoji [topic] [new_emoji]

// Example
;ticket topic name Support Helping
;ticket topic description Support Click this if you need help!
;ticket topic emoji support Support 💀

Create a Topic Support Role

You can setup different support roles for the different topics. Just simply run the following command

// Syntax
[prefix]ticket topic support [topic] [role]

// Example
;ticket topic emoji support Support @Support-Staff

Create a Topic Category

There's no need for one messy category where all topic tickets are in. Run the command below, to setup a category for different topics, so if someones open a ticket for topic "Support", serenity would create the topic ticket, in the right category.

// Syntax
[prefix]ticket topic category [topic] [category]

// Example
;ticket topic emoji category Support Support-Tickets

Create a Topic Opened Embed

Do you want to give users who have opened a ticket for a specific topic different information than for another topic? Execute the command below to create different in-embed tickets for different topics. See also our ticket variables below.

// Syntax
[prefix]ticket topic opened [topic] [code]

// Example
;ticket topic emoji category Support {embed}{description: welcome **{user.name}**!}

Start with writing Embed Code

Embed Variables

Remove a Ticket-Topic

To remove a ticket topic, you'll just need to run the ticket topics command again, just as you did when you created a topic.

// Syntax
[prefix]ticket topics

// Example
;ticket topics

You'll get promoted again with the embed to choose, as you want to delete a topic, you click on "delete topic".

After that, pick the category you want to delete in the dropdown, and delete it.

Reset the Ticket System

If you want to fully reset the ticket system, just run the command below.

Be aware, if you reset your ticket system, all the saved data will be irreversible removed!

// Syntax
[prefix]ticket reset

// Example
;ticket reset