Ticket System

1. Feature Brief

The Ticket System provides a complete support workflow for your community. A persistent ticket panel lives in your designated support channel. Members select their issue type from a dropdown, fill out custom modal questions, and receive an organized private channel. Staff handle tickets via an in-channel control panel or slash commands, with full transcript generation on close.

1. Type-based intake - members pick from customizable ticket types; each type presents its own modal intake questions
2. Dedicated channel creation - tickets spawn as private channels visible only to the opener, support staff, and administrators
3. Priority routing - route specific ticket types into separate destination categories with dedicated support role mentions
4. Pinned control panel - in-channel embed with Claim, Add User, and Close buttons for immediate staff action
5. Fast slash commands - participants can run /close directly in the channel to initiate ticket completion
6. Ticket blacklist manager - block problematic users from opening tickets directly via /ticket admin with persistent storage
7. Encrypted online transcripts Premium - view interactive HTML transcripts online with secure Discord OAuth2 authentication (Standard tier receives static HTML files via DM)
8. Sequential ticket numbering - protected ticket incrementing prevents ID collisions during high-traffic support surges

Who can use this?

Any member can open a ticket. Running /ticket setup, /ticket remove, or accessing the admin panel via /ticket admin requires Manage Channels permission. Any participant can run /close.

---

2. Sub-Systems

Intake & Routing

Interactive Menu Embed:

• Displays active ticket types, current open ticket count, and an intake dropdown
• Automatically refreshes counts as tickets open and resolve

Per-Type Question Modals:

• Each ticket type supports up to 5 custom intake questions
• Supports single-line short fields (up to 100 chars) and multi-line paragraph fields (up to 1,000 chars)
• Responses are formatted neatly into the opening channel embed

Priority Routing & Support Roles:

• Assign dedicated destination categories for different ticket types (e.g. billing, bug reports, staff applications)
• Specify dedicated support roles to ping per ticket type rather than alerting all staff

In-Channel Controls

A control panel embed is pinned inside each active ticket channel:

Button	Permitted Roles	Action
Claim	Support Role / Manage Channels	Assigns the ticket to the clicking staff member and updates embed status
Add User	Support Role / Manage Channels	Opens a modal to grant channel view and send permissions to another user
Close	Ticket Opener / Support Staff	Triggers close confirmation prompt and begins transcript compilation

Slash Command Alternative:

• Run /close anywhere inside an active ticket channel for rapid ticket resolution without scrolling to the pinned embed.

Transcripts & Online Viewer

When a ticket closes, a complete record of messages, embeds, and attachments is compiled.

• Standard (Free) Tier: A static .html transcript file is delivered directly to the ticket creator via DM and logged to your staff log channel
• Premium Tier Premium: Generates an Encrypted Online Web Transcript. Staff and the ticket creator log in with Discord OAuth2 to view an interactive, searchable web view with embeds and attachments preserved

Secure Access

Online transcripts require Discord authentication and are strictly limited to ticket participants and authorized server staff.

Blacklist Manager

Prevent abusive or spam accounts from opening new tickets.

• Managed directly through /ticket admin → Blacklist Manager
• Search and select users by mention or ID
• Paginated interface with instant add and remove controls
• Blacklisted accounts receive a clear notification explaining that their ticket access has been restricted

---

3. Setup Guide

1. Run the setup command - execute /ticket setup with the following parameters:

   • menu-channel: Channel where the interactive ticket panel will be posted
   • category: Default category where new ticket channels will be created
   • log-channel (optional): Channel to receive audit logs and completed transcripts
   • support-role (optional): Default staff role with view and manage permissions

2. Customize ticket types & questions - open /ticket admin and navigate to Manage Types to create custom categories, configure destination categories, and set up modal questions.

3. Verify blacklist settings - use /ticket admin to view or manage the persistent ticket blacklist.

Ticket Commands

Command	Permission	Description
/ticket setup	Manage Channels	Sets up menu channel, default category, log channel, and support role
/ticket admin	Manage Channels	Administrative GUI for types, questions, blacklist, and settings
/ticket remove	Manage Channels	Decommission the ticket system and clean up active configurations
/close	Ticket Participants	Closes the active ticket channel and generates transcripts