Troubleshooting

Most problems come from a missing permission or a department that isn't linked to a Discord category or channel.

Common errors

What you see	Likely cause	Fix
"I was unable to create the ticket channel"	The bot lacks Manage Channels (or Create Private Threads) where that department opens tickets	Grant the permission on that category or channel. The web dashboard's department editor flags this.
"The selected ticket category is misconfigured"	The department isn't linked to a Discord category	Dashboard → Manage Categories → 📁 Set Category Channel, or pick one in the web dashboard.
Thread tickets fail	Thread departments need a text channel, not a Discord category	Use 💬 Set Parent Channel and pick a text channel.
"Failed to generate transcript"	The bot can't read the channel's history	Grant Read Message History.
`Missing Permissions`	The bot's role is too low, or a permission is missing	Move the Ticket Nexus role higher, or grant the permission.
The panel doesn't show my changes	Changes made in Discord reach the panel on the next deploy or its 30-minute refresh	Click Deploy Ticket Panel again, or use Refresh on the web dashboard's Panel page.
The bot left my server right after joining	The server has been deactivated, or new signups are paused	Ask in the support Discord.