Introduction
Welcome to the Partner Ticket documentation. This guide will walk you through setting up and using our powerful ticket management system for Discord servers.
Partner Ticket is designed to streamline your support workflow with an intuitive dashboard, customizable panels, advanced ticket forms, and much more.
Getting Started
Setting up Partner Ticket is quick and easy. Follow these simple steps to get your support system up and running.
Invite the Bot
Click the button below to invite Partner Ticket to your Discord server. You'll need the 'Manage Server' permission to do this.
Invite to DiscordLogin to Dashboard
After inviting the bot, log in to the dashboard using your Discord account. You'll need the 'Administrator' permission on the server to manage settings.
Login to DashboardCreate Your First Panel
Once logged in, select your server and navigate to the 'Panels' tab. Click 'Create Panel' to set up your first ticket panel with custom buttons and settings.
Dashboard Overview
The Partner Ticket dashboard is your central hub for managing all aspects of your ticket system. From here, you can configure panels, view active tickets, customize forms, and adjust automation settings.
Panel Configuration
Ticket panels are the entry points for users to create tickets. You can create multiple panels with different settings and custom buttons for various support categories.
Panel Core Settings
- Panel Name: A descriptive name for your panel that helps you identify it in the dashboard.
- Support Team Roles: Select which roles on your server have permission to manage tickets created from this panel.
- Ticket Category: Choose which category (channel folder) ticket channels will be created in.
- Transcript Channel: Select where ticket transcripts will be sent when a ticket is closed.
Tip: You can create multiple panels for different support categories (e.g., General Support, Billing, Technical Issues) by adding custom buttons in the 'Panel Categories' section.
Permissions
- Support Team Roles: Only users with the selected roles will be able to claim, close, and manage tickets from this panel.
Rating System
- Enable Ticket Rating: If enabled, users will receive a DM after their ticket is closed asking them to rate their support experience.
- Rating Log Channel: Select a channel where submitted ratings will be logged for staff to review.
Embed Customization
Customize your panel message's appearance with our live embed editor. You can add titles, descriptions, images, and more.
- Live Preview: The embed editor shows a real-time preview of your panel message as you make changes.
Panel Categories
Panel categories allow you to create custom buttons for different ticket types within the same panel. Each category can have its own settings.
- Button Name: The text that appears on the button users will click to create a ticket.
- Button Value: An internal identifier for this category (used in automations and integrations).
- Emoji: An optional emoji to display on the button for visual appeal.
- Color: The button color (Primary, Secondary, Success, Danger, or Link).
- Max Open: The maximum number of open tickets a user can have for this category (0 for unlimited).
Important: Each panel category creates its own ticket counter, so users can have multiple open tickets across different categories even if they're limited in a single category.
Ticket Form Configuration
Ticket forms allow you to collect specific information from users when they create a ticket. You can create multi-step forms with various question types.
- Form Name: A descriptive name for your form that helps you identify it in the dashboard.
- Panel Association: Select which panel this form will be used with. Each panel can have one form.
-
Questions:
- Question Text: The text users will see when asked to answer this question.
-
Question Type:
Text: A single-line text input.Paragraph: A multi-line text input for longer responses.Dropdown: A dropdown menu with predefined options (configured in the 'Options' field).
- Required: If enabled, users must answer this question before submitting the form.
- Options: For dropdown questions, enter the available options separated by commas.
Forms are displayed to users immediately after they click a panel button but before their ticket channel is created.
Open Ticket Management
The 'Open Tickets' tab shows all currently active tickets. From here, you can search tickets, view details, and take management actions.
Closed Tickets Archive
The 'Closed Tickets' tab shows recently closed tickets. You can view transcripts, ratings, and other details about resolved tickets.
- Transcripts: Each closed ticket generates a secure web-based transcript that can be viewed and downloaded.
- Ratings: If rating was enabled for the panel, you can view the user's rating and feedback for each closed ticket.
Automations Configuration
Automations allow you to send automatic messages at key points in the ticket lifecycle to improve user experience and staff efficiency.
- Welcome Message: Sent to the user when their ticket channel is first created.
- Rating DM: Sent to the user when their ticket is closed (if rating is enabled).
- Auto-Close Warning: Sent when a ticket has been inactive for a specified period (if auto-close is enabled).
Tip: You can use variables like {user}, {category}, and {ticket.name} in automation messages to personalize them.
Custom Messages
Customize the bot's system messages to match your server's brand and communication style.
- Ticket Welcome Message: The message sent to users when they first join their ticket channel.
- User Reminder Message: Sent to users who haven't responded to staff messages within the configured time.
- Staff Reminder Message: Sent to staff when users haven't responded within the configured time.
- Auto-Close Warning Message: Sent when a ticket is about to be automatically closed due to inactivity.
- Rating DM Message: The message sent to users asking them to rate their support experience.
Tip: You can use variables like {user}, {category}, and {ticket.name} in automation messages to personalize them.
Ticket Reminders
Set up automatic reminders to keep tickets moving and prevent them from being forgotten.
- Enable Ticket Reminders: Toggle to enable or disable the reminder system for this server.
- User Reminder Interval: How long to wait after a staff message before reminding the user (in hours). Set to 0 to disable.
- Staff Reminder Interval: How long to wait after a user message before reminding staff (in hours). Set to 0 to disable.
- Auto-Close Interval: How long a ticket can remain inactive before being automatically closed (in hours). Set to 0 to disable. (168 = 1 week)
Slash Commands
Partner Ticket provides several slash commands for both users and staff to manage tickets efficiently.
| Command | Description | Required Permission |
|---|---|---|
/ticket add [user] | Add a user to an existing ticket channel. | Support Team Role |
/ticket remove [user] | Remove a user from a ticket channel. | Support Team Role |
/ticket lock | Prevent the ticket owner from sending messages (lock the ticket). | Support Team Role |
/ticket unlock | Allow the ticket owner to send messages again (unlock the ticket). | Support Team Role |
/ticket rename [name] | Change the name of the ticket channel. | Support Team Role |
/ticket claim | Claim a ticket to show you're handling it. | Support Team Role |
/ticket unclaim | Release a ticket to make it available for other staff. | Support Team Role |
/ticket close [reason] | Close the ticket and generate a transcript. | Support Team Role |
/tickets | View a list of your open tickets. | Support Team Role |
/stats | View ticket statistics for the server. | Administrator |
/language [language] | Change the bot's language for this server. | Administrator |
User Experience Best Practices
Follow these tips to create an optimal support experience for your users.
- Use clear, descriptive names for your panels and categories so users know which button to click for their issue.
- Create specific forms for different ticket types to gather relevant information up front.
- Enable the rating system to collect feedback and identify areas for improvement.
- Set appropriate reminder intervals to keep tickets active without being intrusive.
- Use custom embeds with your brand colors and images to create a professional look.
- Set reasonable limits on open tickets per user to prevent abuse while remaining helpful.
- Regularly review closed tickets and ratings to identify common issues and improve your support process.
- Train your staff on effective use of commands and the dashboard to provide faster support.
Frequently Asked Questions
Need More Help?
If you have questions that aren't answered here, please join our official Discord server where our support team and community members can assist you.