Getting Started with Ticketly

Learn how to set up and configure the most advanced Discord ticket bot for your server.

Welcome to Ticketly! This documentation will guide you through every aspect of setting up and using Ticketly in your Discord server.

What is Ticketly?

Ticketly is a powerful Discord bot designed to streamline customer support and user inquiries through an organized ticket system. It creates private channels for each support request, allowing your staff to provide personalized assistance while keeping conversations organized.

Key Features

Smart Ticket System

Automated ticket creation with categories and priorities

Role Management

Advanced permission system for staff members

Analytics

Track performance and response times

Customizable

Fully customizable messages and workflows

System Requirements

  • Discord server with "Manage Server" permissions
  • Ability to create channels and manage roles
  • Recommended: Dedicated support category

Next Steps

Ready to get started? Follow these steps:

  1. Install Ticketly in your server
  2. Complete the Quick Setup
  3. Configure your permissions
  4. Start managing tickets!

Installation

Add Ticketly to your Discord server in just a few clicks.

1

Invite the Bot

Click the invite link below to add Ticketly to your server. You'll need "Manage Server" permissions.

Invite Ticketly
2

Select Your Server

Choose the Discord server where you want to add Ticketly from the dropdown menu.

Discord Authorization
Discord Server Selection
3

Grant Permissions

Ticketly requires specific permissions to function properly. Make sure all recommended permissions are checked:

Manage Channels Required for creating ticket channels
Manage Roles Required for managing channel permissions
Send Messages Required for bot responses
Embed Links Recommended for rich messages
4

Verify Installation

Once added, verify that Ticketly is online and ready:

Command 
/ticket help

If you see a response from Ticketly, the installation was successful!

Important: If Ticketly doesn't respond, check that it has the proper permissions and try moving its role higher in the role hierarchy.

Quick Setup

Get your ticket system running in under 5 minutes.

Setup Wizard

Follow these commands in order to set up your ticket system:

1. Initialize the Bot

Set up the basic ticket system with default settings.

Setup Command 
/ticket setup
Creates ticket category, support role, and default settings

2. Configure Support Role

Assign staff members who can manage tickets.

Role Configuration 
/ticket role @Support
Sets the support role for ticket management

3. Create Ticket Panel

Add a message with button for users to create tickets.

Panel Creation 
/ticket panel #support
Creates interactive ticket creation panel

🎉 Setup Complete!

Your ticket system is now ready. Users can click the button in your support channel to create tickets.

Recommended Next Steps:

Basic Commands

Essential commands for everyday ticket management.

User Commands

Commands that any user can use to interact with the ticket system.

/ticket create [category] [priority]

Create a new support ticket. Optionally specify a category and priority level.

Examples:
/ticket create
/ticket create category:billing
/ticket create category:support priority:high
/ticket close [reason]

Close the current ticket. Only usable within a ticket channel.

Examples:
/ticket close
/ticket close reason:"Issue resolved"
/ticket add @user

Add another user to the current ticket conversation.

Example:
/ticket add @username
/ticket remove @user

Remove a user from the current ticket conversation.

Example:
/ticket remove @username

Information Commands

Commands to get information about tickets and the bot.

/ticket info

Display information about the current ticket, including creation time, status, and assigned staff.

/ticket help

Show a help message with basic command information and links to documentation.

/ticket stats

View server ticket statistics including total tickets, resolution times, and active tickets.

Admin Commands

Administrative commands for server managers and support staff.

Permission Required: These commands require the "Manage Server" permission or the designated support role.

Setup & Configuration

/ticket setup

Initialize the ticket system with default configuration. Creates necessary channels, roles, and permissions.

What this command does:
  • Creates a "Tickets" category
  • Sets up channel permissions
  • Creates a default support role
  • Configures basic settings
/ticket panel #channel [title] [description]

Create an interactive ticket panel with buttons for users to create tickets.

Examples:
/ticket panel #support
/ticket panel #help title:"Need Help?" description:"Click below to create a ticket"
/ticket role @role

Set the support role that can manage tickets and access all ticket channels.

Example:
/ticket role @Support Team

Ticket Management

/ticket claim

Assign yourself to the current ticket as the primary support agent.

/ticket assign @staff

Assign a specific staff member to handle the current ticket.

Example:
/ticket assign @ModeratorName
/ticket rename new-name

Change the name of the current ticket channel.

Example:
/ticket rename billing-issue-urgent
/ticket transcript

Generate a transcript of the current ticket conversation and save it for records.

Bulk Operations

/ticket list [status] [user]

List all tickets with optional filtering by status or user.

Examples:
/ticket list
/ticket list status:open
/ticket list user:@username
/ticket cleanup [days]

Clean up old closed tickets. Default is 30 days.

Example:
/ticket cleanup days:7

Premium Commands

Advanced features available with Ticketly Premium subscription.

Premium Features

Unlock advanced automation, analytics, and customization options with Ticketly Premium.

Upgrade to Premium

Analytics & Reporting

/ticket analytics [period] Premium

Generate detailed analytics reports with charts and insights about ticket performance.

Examples:
/ticket analytics
/ticket analytics period:weekly
/ticket analytics period:monthly
/ticket export [format] [period] Premium

Export ticket data and statistics in various formats (CSV, JSON, PDF).

Examples:
/ticket export format:csv
/ticket export format:pdf period:monthly

Automation

/ticket autoclose days [category] Premium

Set up automatic closure of inactive tickets after specified days.

Examples:
/ticket autoclose days:7
/ticket autoclose days:3 category:billing
/ticket autoassign @role [category] Premium

Automatically assign tickets to available staff members based on category or workload.

Example:
/ticket autoassign @Support category:technical
/ticket ai enable/disable [category] Premium

Enable AI-powered auto-responses for common questions and ticket categorization.

Examples:
/ticket ai enable
/ticket ai disable category:billing

Advanced Customization

/ticket branding logo [color] [footer] Premium

Customize ticket embeds with your server's branding, colors, and logo.

Example:
/ticket branding logo:https://... color:#ff0000
/ticket templates create/edit/delete name Premium

Create custom message templates for different ticket scenarios.

Example:
/ticket templates create billing-response

Frequently Asked Questions

Common questions and solutions for Ticketly users.

How many tickets can I have open at once?

Free users can have up to 5 concurrent tickets open. Premium subscribers have unlimited concurrent tickets.

Can I customize the ticket creation message?

Yes! Use the /ticket customize command to modify embed colors, messages, and footer text. Premium users can add custom logos and advanced branding.

How do I add multiple support roles?

You can assign multiple roles by using the /ticket role command for each role you want to add. All assigned roles will have access to manage tickets.

Can users create tickets via DM?

Currently, tickets can only be created within your Discord server using the panel or slash commands. DM-based ticket creation is planned for a future update.

What happens to closed tickets?

Closed tickets are archived and their channels are deleted after 24 hours. Transcripts are automatically saved and can be accessed through the dashboard. Premium users can configure custom retention periods.

How do I backup my ticket data?

Ticket transcripts are automatically saved. Premium users can export all data using /ticket export command in various formats including CSV and JSON.

Troubleshooting

Solutions to common issues and problems.

Bot Not Responding

Commands not working

Solutions:
  1. Check if the bot is online (green status)
  2. Verify bot has "Send Messages" permission
  3. Ensure you're using slash commands (/ticket)
  4. Try reinviting the bot with proper permissions

Bot appears offline

Solutions:
  1. Check Discord's status page for outages
  2. Wait a few minutes - Discord may be experiencing delays
  3. Contact support if the issue persists

Permission Issues

Cannot create channels

Required Permissions:
  • Manage Channels
  • Manage Roles
  • View Channels

Fix: Go to Server Settings → Roles → Ticketly → Enable these permissions

Role hierarchy issues

Solution:

Move Ticketly's role above the support roles in Server Settings → Roles. The bot's role must be higher than any role it needs to manage.

Ticket Creation Problems

Button not working

Troubleshooting Steps:
  1. Refresh Discord or restart the app
  2. Check if you already have an open ticket
  3. Verify the panel was created correctly with /ticket panel
  4. Ensure the bot has permissions in the channel

Ticket limit reached

Solutions:
  • Free users: Close existing tickets or upgrade to Premium
  • Check for old tickets that can be closed
  • Contact staff to help resolve open tickets

Still Need Help?

If you can't find a solution to your problem, don't hesitate to reach out to our support team.

Join Support Server Contact Support

Permissions Setup

Configure Discord permissions for optimal bot functionality.

Permissions Configuration

Detailed permission setup guide coming soon.

Ticket Categories

Set up and manage ticket categories for better organization.

Category Management

Category configuration guide coming soon.

Customization

Customize Ticketly to match your server's branding and style.

Customization Options

Branding and customization guide coming soon.

API Reference

Developer documentation for Ticketly's API endpoints.

API Documentation

API reference and examples coming soon.