Skip to main content
Documentation

Add Ticket Tool to Discord

Add the bot, run one setup command, and open a test ticket: most servers have a working ticket panel a few minutes after clicking the button below.

01
Add the bot
Pick your server and click Authorize.
02
Run /setup in Discord
Needs the Manage Server permission.
03
Test a ticket
Click the panel button to open your first ticket.

Which Ticket Tool is this?

This is Ticket Tool (ticket-tool.app, dashboard at dash.ticket-tool.app). It is a separate bot from tickettool.xyz, made by a different team. Settings and subscriptions don't carry over between them. How they compare.

Prerequisites

Admin Permissions Required

You must have Administrator or Manage Server permissions in your Discord server to add bots.

Authorization Process

When you click the invite link, you'll see Discord's authorization page:

01
Select a server
Choose the server to add Ticket Tool to from the dropdown.
02
Review permissions
Check the permissions the bot is requesting.
03
Authorize
Click Authorize to add the bot to your server.
04
Complete captcha
Finish the security verification if prompted.

Required Permissions

Ticket Tool needs these permissions to function, grouped by what each one does:

Channels & roles

  • View Channels: see ticket channels
  • Manage Channels: create and delete ticket channels
  • Manage Roles: set up ticket channel permissions
  • Manage Messages: manage messages in tickets

Messaging

  • Send Messages: send messages in tickets
  • Embed Links: send rich embeds
  • Attach Files: send transcript files
  • Add Reactions: add reactions to messages
  • Read Message History: read past messages to build transcripts
  • Pin Messages: pin the automations-paused notice, and a ticket's opening message if the category turns that on

Webhooks

  • Manage Webhooks: send messages with custom names

Threads

  • Manage Threads: manage each ticket's private staff thread
  • Create Private Threads: open private staff threads
  • Create Public Threads: let the Create Thread flow node open public threads
  • Send Messages in Threads: reply inside ticket threads

Tickets are channels; threads are only used for the optional private staff thread and for threads a support flow creates.

The bot does not ask for Mention Everyone. If you want the Tag Role flow node to ping a role that is not mentionable, grant the bot Mention Everyone in your server settings: Discord only lets a bot ping non-mentionable roles with that permission.

Missing Permissions

If you don't grant all requested permissions, some features may not work correctly. You can update bot permissions later in your server settings.

Verifying the Bot Joined

After authorizing, you should see Ticket Tool appear in your server's member list. The bot will show as online once it's fully connected.

Look for the Ticket Tool bot with a bot badge in your member list.

Troubleshooting

Bot Not Appearing?

If the bot doesn't appear after a few minutes:

  • Check if the bot was added to a different server by mistake
  • Ensure you have Administrator or Manage Server permissions
  • Try removing and re-adding the bot with the invite link

Bot Shows as Offline?

The bot may take a minute to connect. If it stays offline:

Next Steps

Now that the bot is in your server, configure your ticket system: