Set up TicketBot

This page will guide you through the initial setup of TicketBot.

1. Invite TicketBot to your server

Firstly, you need to invite TicketBot to your server. You can do that by clicking Add to Discord or by navigating to https://ticketbot.xyz/invite.

For simplicity, we recommend giving the bot ADMINISTRATOR permissions. While the bot doesn't necessarily require administrator access, it can function with fewer permissions if they are configured correctly. However, proper setup requires both the right permissions AND the right role hierarchy to be in place.

Setup permissions manually

If you choose to configure permissions manually, be aware that both specific permissions and role hierarchy must be properly set up for the bot to function correctly.

Role Hierarchy: The bot's role must be positioned above all roles that need to interact with the bot. For example, if the bot role is below a moderator or admin role, the bot cannot add members with those roles to tickets or manage their permissions for ticket visibility.

Required Permissions: The bot requires the following permissions to fully function:

• Manage Roles – Change who can see tickets
• Manage Channels – Create and manage ticket channels
• Read Messages/View Channels – Access ticket channels
• Send Messages – Send messages in tickets
• Read Message History – Read ticket messages
• Embed Links – Display formatted messages
• Attach Files – Upload files to tickets
• Mention @everyone, @here, and All Roles – Mention roles that are set up
• Manage Messages – Manage ticket content
• Add Reactions – Add reaction buttons to messages

2. Enter your Admin Dashboard

Once you've added the bot, you can open the dashboard for your desired server. On the "My servers" page, you can also invite the bot to other servers you own.

3. Customize settings

Now you are ready to configure the bot. In the top menu on the dashboard, click on "Settings". Here you are presented with one default subject.

In order to categorize tickets, you must have one or more subjects. Every ticket that you or your server members create on your server must be a part of a subject.

You can read more about subjects on the subjects documentation.

4. Create a panel

When you have created your desired amount of subjects, you are ready for the next and final step.

In order for users on your server to create tickets without writing commands, you can create a panel with buttons or selection menus that, when clicked, will open a ticket under the corresponding subject. Panels usually look something like this:

More

Success! The bot is now set up and working (hopefully). You are free to continue reading through the documentation and learn how to configure and adjust all of the bot's settings.

If you have any questions regarding the setup guide or documentation in general, please do not hesitate to join our Discord support server and open a support ticket with us. We would be happy to help.

You can explore our documentation here.