Tickets give your members a private way to talk to your staff. A member clicks a button, Miyu creates a private channel just for them and your staff, and when the issue is solved someone closes it. Miyu then saves the whole conversation to a log channel.
Ticket channels are private, and Miyu sets their permissions when it creates them. Miyu can only work in them reliably if its role has the Administrator permission. If tickets don't open or Miyu can't post in them, check this first.
You need the Administrator permission for all setup commands.
m!ticket setup
This one command creates everything you need:
| What | Name | Who can see it |
|---|---|---|
| A category for open tickets | Tickets | Only staff and the person who opened the ticket |
| A log channel inside it | #ticket-log | Nobody except admins, until you change it |
| A channel with the "Open Ticket" button | #support | Everyone can read it, nobody can write |
After setup, do two things:
Then give your staff access to new tickets. Until you do, only admins can see them.
m!ticket role add default @Moderators
default is the name of the ticket category that m!ticket setup created.
m!ticket user add @member inside the ticket channel.Closing a big ticket can take a moment. Please wait until the channel disappears.
You can have more than one kind of ticket, for example one for general support and one for appeals. Each category gets its own Discord category, its own log channel and its own staff roles.
| Command | What it does |
|---|---|
m!ticket category add <name> |
Creates a new ticket category. Miyu makes a Tickets category with a #-log channel and posts a new button in #support. |
m!ticket category remove <name> |
Removes the category from Miyu. Delete its button in #support by hand afterwards. |
m!ticket category channel <name> <category channel> |
New tickets of this category will be created under a different Discord category. Existing tickets stay where they are. |
The name has to be one word, like appeals or partners.
m!ticket add cat and m!ticket remove cat are short forms of category add and category remove.
Miyu recognizes a ticket's category by the name of the Discord category it sits in. Keep the names Miyu gave the categories, or
m!ticket user addstops working.
Choose which roles can see new tickets of a category:
| Command | What it does |
|---|---|
m!ticket role add <category> <@role> |
Members with this role can see and answer new tickets of this category |
m!ticket role remove <category> <@role> |
Members with this role won't be added to new tickets anymore |
Changes only apply to tickets opened after the change. Tickets that are already open keep their permissions.
If you want a nicer message than the one in #support, post your own with Embeds and add a ticket button to it:
m!ticket button add <#channel> <message ID> <category> [button color] [embed color]
blurple (or blue), grey (or gray), green, red. Blurple is the default.#RRGGBB, like #e62257.Example:
m!ticket button add #help 1234567890123456789 appeals red #e62257
m!ticket add-button works the same.
| Command | What it does |
|---|---|
m!ticket settings |
Shows every ticket category with its channels, staff roles and how many tickets were opened. Each message has a Dismiss button to delete it again. |
m!ticket user add <@member> |
Adds a member to the ticket you're typing in. Only works inside a ticket channel. |
m!ticket remove |
Removes the ticket system: deletes #support and the ticket categories. Log channels and open tickets stay, so you don't lose anything. |
m!ticket install and m!ticket uninstall work the same as setup and remove.
When a member reports someone through the right-click menu, Miyu opens a ticket in a special reports category. See Reports.