Getting Started
Welcome to Ticket System! This guide will help you set up and configure your professional ticket management system.
Overview
Ticket System is a Discord-based ticket management solution that provides:
- Thread-based tickets with automatic numbering
- Button interface for easy ticket creation
- Auto-close system with configurable timers
- Transcript generation for closed tickets
- Multi-guild support for managing multiple servers
- Subscription tiers with different feature limits
Prerequisites
Before getting started, ensure you have:
- A Discord server where you have Administrator permissions
- Basic understanding of Discord permissions and roles
- Node.js 18+ and MongoDB for self-hosting
Quick Setup
Step 1: Add the Bot
- Click here to add the bot to your Discord server
- Select your server from the dropdown
- Ensure all permissions are checked (required for full functionality)
- Click "Authorize"
Step 2: Configure Categories
- Set up ticket categories in your Discord server
- Configure channels for ticket creation
- Set up role permissions for staff access
- Configure auto-close settings
Step 3: Test Your Setup
- Go to your Discord server
- Use the ticket creation buttons in configured channels
- A new ticket thread will be created with automatic numbering
- Test the auto-close functionality
🎉 Congratulations! Your ticket system is now active.
Architecture Overview
Understanding the system architecture helps with configuration and troubleshooting:
Discord Bot
Handles Discord interactions (buttons, threads, auto-close)
→
Database
Stores tickets, guilds, users, and configurations
→
Transcripts
Generates HTML transcripts for closed tickets
Key Concepts
Tickets
- Thread-based: Each ticket is a Discord thread
- Automatic numbering:
ticket-0001,ticket-0002, etc. - Status tracking: open, closed, pending_close
- Auto-close: Configurable inactivity timer (default: 72 hours)
Categories
- Channel routing: Direct tickets to specific channels
- Permission control: Require or block specific roles
- Custom branding: Unique emojis and descriptions
- Role-based access: Control who can create tickets
Guilds (Servers)
- Multi-guild: Manage multiple Discord servers
- Per-guild config: Each server has independent settings
- Subscription tiers: Free, Pro, Enterprise plans
- Custom tokens: Use your own bot token (Pro+)
Subscription Tiers
Choose the plan that fits your needs:
Free
$0
- 1 Discord Server
- 50 Monthly Tickets
- 7 days Transcript Retention
- ❌ Custom Bot Token
- ❌ Custom Domain
- ❌ Priority Support
Pro
$9.99/mo
- 5 Discord Servers
- 500 Monthly Tickets
- 30 days Transcript Retention
- ✅ Custom Bot Token
- ❌ Custom Domain
- ✅ Priority Support
Enterprise
$49.99/mo
- Unlimited Discord Servers
- Unlimited Monthly Tickets
- 365 days Transcript Retention
- ✅ Custom Bot Token
- ✅ Custom Domain
- ✅ Priority Support
Security & Privacy
We take security seriously:
- Password Hashing: Argon2id with configurable parameters
- Token Encryption: AES-256-GCM with unique IVs
- JWT Signing: EdDSA (Ed25519) for authentication
- Data Encryption: All sensitive data encrypted at rest
- GDPR Compliance: Data export and deletion tools
Next Steps
Now that you have the basics working:
- Configure permissions - Set up role-based access
- Customize categories - Create specialized ticket types
- Configure auto-close - Automate ticket management
- Set up dashboard - Configure the web interface
Need Help?
📚 Documentation
Browse our complete guides