Tickets
Let server members contact staff through a ticket!
Some of the features of this module require a Premium Subscription to function. You can however use the module with a free subscription.
With the Tickets module you can setup a system that allows users to privately contact a role in your server through a temporary channel. Users can create tickets, close tickets, and more. Your server's moderators may add or remove users from your server's tickets.
Settings
Here you can find the settings for the Tickets module and modify them to your liking.
Panels
Manager Roles
Here you may choose roles from your server which will have access to .
Embeds Color
Here you may choose the color of all embeds in the panel messages.
Cooldown
Here you may choose the number of seconds users must wait between creating tickets. The minimum number of seconds you can make this cooldown is 10.
Create a Panel
Here you may setup a ticket panel that can be sent to a channel in your server using the /ticket setup
command. Use the settings below to customize the panel, then click "Add" to save the panel. The new panel will appear in Active Panels.
To add more than one panel, you need a Premium Subscription.
Panel Name
Here you may choose the name of the panel. This will be used to identify it during setup, transcripts, and automations, and can only contain letters and numbers.
Panel Message
Here you may customize a plain text or embed message that will be sent to the channel in which the panel is setup, along with a button to create a ticket. All Variables can be used.
Layout
Here you may choose whether users can create a ticket with a Button or a Select Menu. Your choice will be attached to the Panel Message.
Button Color
Here you may choose the color for your button, which will show in the background of the Button / Select Menu Label text you customized. The Button Color setting is only visible if Layout is set to Button.
Select Menu Placeholder
Here you may customize the text that is displayed before selecting an option from your select menu. The Select Menu Placeholder setting is only visible if Layout is set to Select Menu.
Button / Select Menu Label
Here you may customize the text users will click to create a ticket, which will be shown on the Layout option you chose.
Select Menu Description
Here you may customize the text that will be displayed below the Button / Select Menu Label in your select menu. The Select Menu Description setting is only visible if Layout is set to Select Menu.
Emoji
Here you may choose the emoji, if any, should be displayed to the left of the Button / Select Menu Label text you customized.
Connected Panels
Here you may choose the names of the panels that should have their ticket creation button or select menu included on this panel. Use a name from the ones you created in the Active Panels settings. Do not include the # or the number that follows it at the end.
Support Roles
Here you may choose roles from your server which will have access to all created tickets on this panel, even when they're closed.
Blacklisted Roles
Here you may choose roles from your server which cannot create tickets on this panel.
Send Form
Here you may toggle whether or not to send a form or modal which will allow users to answer up to two questions with text responses before creating a ticket.
Question 1 Type
Here you may choose the size of the input box for the first question in the form or modal. The Question 1 Type setting is only visible if Send Form is toggled on.
Question 1 Text
Here you may customize the label for the first question in the form or modal. The Question 1 Text setting is only visible if Send Form is toggled on.
Question 2 Type
Here you may choose the size of the input box for the second question in the form or modal, or choose None if you would not like to add a second question. The Question 2 Type setting is only visible if Send Form is toggled on.
Question 2 Text
Here you may customize the label for the second question in the form or modal, or leave it empty if you would not like to add a second question. The Question 2 Text setting is only visible if Question 2 Type is set to Short Text Input or Long Text Input.
Ticket Name
Here you may customize the channel name for each created ticket on this panel. All Variables that are correctly formatted for channel names can be used.
Ping Support Members
Here you may toggle whether the bot will send a separate message before the Ticket Creation Message, which pings the Support Roles you chose. This can also be done using the {ping} variable anywhere in the Ticket Creation Message, if it is a plain text message.
Ticket Creation Message
Here you may customize a plain text or embed message that will be sent to tickets that are created on this panel. All Variables can be used.
Logging Channel
Here you may choose a channel from your server which will receive logs for ticket creation, closure, reopening, deletion, transcription, automation updates, member additions and removals, and errors from this panel. Leave this option empty to disable logs.
DM Ticket Creator
Here you may toggle whether the bot will direct message logs for ticket creation, closure, reopening, and member additions and removals from this panel to the creator of the logged ticket.
Ticket Mode
Here you may choose whether tickets will be created as new text channels or as new private threads in an existing text channel.
Two Step Close
Here you may choose whether tickets, when closed, will be instantly deleted (off) or will close/lock the ticket to only the Support Roles and allow them to use a new set of controls.
Open Category
Here you may choose a category from your server which will store closed tickets from this panel. The Open Category setting is only visible if Ticket Mode is set to Channel.
Close Category
Here you may choose a category from your server which will store closed tickets from this panel. The Close Category setting is only visible if Ticket Mode is set to Channel.
Channel for Tickets
Here you may choose a channel from your server which will store tickets from this panel. The Channel for Tickets setting is only visible if Ticket Mode is set to Thread.
To save the panel's settings, you need to click "Add" in the bottom-right corner of the settings. This will reset the fields so you can set up another panel.
Active Panels
When adding a new ticket panel, it and its settings will appear in this section. All ticket panels will be ordered by the number in which they were created. To view, edit, and delete the settings you selected for that panel, simply click the ticket panel you wish to do so for. You can find detailed information about each of the settings in the Create a Panel section.
To save the edits you made on the ticket panel's settings, you need to click "Edit" in the bottom-right corner of the settings. Additionally, you must re-send the panel with the command for the changes to take effect on a panel. You do not need to re-send the panel if it is used only for the /ticket create command.
/ticket create Command
/ticket create
Here you may toggle whether can be used.
Panel Name
Here you may choose the panel that the command will follow the settings for and contribute to its {panel_count} variable. Use a name from the ones you created in the Active Panels settings. Do not include the # or the number that follows it at the end.
Channel Restrictions
Here you may customize channel restrictions to allow the usage of the /ticket create command only in certain channels. Below you can find detailed information about each restriction type and how it can be used.
Restriction Type | Restriction Details |
---|---|
No channel restrictions | Users will be able to use the command everywhere. |
Disable for these channels... | Set this blacklist type if you want the command to work in all channels except the channels provided in the menu below. |
Enable for these channels... | Set this blacklist type if you want the command to work only in the channels provided in the menu below. |
Role Restrictions
Here you may customize role restrictions to allow the usage of the /ticket create command only to certain roles. Below you can find detailed information about each restriction type and how it can be used.
Restriction Type | Restriction Details |
---|---|
No role restrictions | Everyone will be able to use the command. |
Disable for these channels... | Set this blacklist type if you want the command to work for all users, except users with at least one of the roles provided in the menu below. |
Enable for these channels... | Set this blacklist type if you want the command to work only for users with at least one of the roles provided in the menu below. |
Transcripts
Here you may setup ticket transcripts for specific panels and manage how they are stored. Use the settings below to customize the transcript, then click "Add" to save the transcript. The new transcript will appear in Active Transcripts.
To add more than one panel, you need a Premium Subscription..
Affected Panels
Here you may choose the names of the panels that will be subject to this transcript. Use a name from the ones you created in the Active Panels settings. Do not include the # or the number that follows it at the end.
If the same panel name is included in multiple Active Transcripts that have overriding settings, the first listed transcript will be the one that takes effect.
Transcripts Channel
Here you may choose a channel from your server which transcript threads will be stored in. This will only apply to new transcripts.
Be cautious about the channel permissions used in your Transcripts Channel. Deleting a channel which contains transcript threads will also delete those transcripts. Additionally, modifying or deleting a thread which contains a transcript will modify or delete that transcript respectively. These changes are permanent and cannot be undone.
Thread Privacy
Here you may choose who can view transcript threads. Your setting choice will only apply to new transcripts, but any changes to channel permissions will apply to all transcript threads in that channel. Below you can find detailed information about each thread privacy type and how it can be used.
Option | Details |
---|---|
Public Thread | |
Private Thread |
Add Support Members to Transcript
Here you may toggle whether all members with any of theSupport Roles, if they have the View Channel permission enabled in the Transcripts Channel, should have access to and be pinged in the transcript thread when the transcript is created.
Add Creator of Ticket to Transcript
Here you may toggle whether the creator of the ticket, if they have the View Channel permission enabled in the Transcripts Channel, should have access to and be pinged in the transcript thread when the ticket is deleted.
To save the transcript's settings, you need to click "Add" in the bottom-right corner of the settings. This will reset the fields so you can set up another transcript.
Active Transcripts
When adding a new ticket transcript, it and its settings will appear in this section. All ticket transcripts will be ordered by the number in which they were created. To view, edit, and delete the settings you selected for that transcript, simply click the ticket transcript you wish to do so for. You can find detailed information about each of the settings in the Transcripts section.
To save the edits you made on the ticket transcript's settings, you need to click "Edit" in the bottom-right corner of the settings.
Limits
Here you may setup ticket creation limits for specific panels and manage the amount of created tickets. Use the settings below to customize the limit, then click "Add" to save the limit. The new limit will appear in Active Limits.
Features in this section are limited to Premium users.
[👑] Affected Panels
Here you may choose the names of the panels that will be subject to this limit. Use a name from the ones you created in the Active Panels settings. Do not include the # or the number that follows it at the end.
If the same panel name is included in multiple Active Limits that have overriding settings, the first listed limit will be the one that takes effect.
[👑] Maximum of Open Tickets
Here you may choose the number of tickets that can be open at the same time. If a ticket is manually deleted, you may need to use the command to update the module's data.
[👑] Maximum of Active Tickets (Open + Closed)
Here you may choose the number of tickets that can exist, while opened or closed, at the same time. If a ticket is manually deleted, you may need to use the command to update the module's data.
[👑] Maximum of Open Tickets by User
Here you may choose the number of tickets that can be open with the same ticket creator at the same time. If a ticket is manually deleted, you may need to use the command to update the module's data.
[👑] Maximum of Active Tickets by User (Open + Closed)
Here you may choose the number of tickets that can exist, while opened or closed, with the same ticket creator at the same time. If a ticket is manually deleted, you may need to use the command to update the module's data.
To save the limit's settings, you need to click "Add" in the bottom-right corner of the settings. This will reset the fields so you can set up another limit.
Active Limits
When adding a new ticket limit, it and its settings will appear in this section. All ticket limits will be ordered by the number in which they were created. To view, edit, and delete the settings you selected for that limit, simply click the ticket limit you wish to do so for. You can find detailed information about each of the settings in the Limits section.
To save the edits you made on the ticket limit's settings, you need to click "Edit" in the bottom-right corner of the settings.
Automations
Here you may setup ticket auto-closure and auto-deletion for specific panels and manage if and when they are triggered. Use the settings below to customize the automation, then click "Add" to save the automation. The new automation will appear in Active Automations.
Features in this section are limited to Premium users.
[👑] Affected Panels
Here you may choose the names of the panels that will be subject to this limit. Use a name from the ones you created in the Active Panels settings. Do not include the # or the number that follows it at the end.
If the same panel name is included in multiple Active Automations that have overriding settings, the first listed automation for that panel will be the one that takes effect.
[👑] Action on Leave
Here you may choose what action will be taken if the creator of the ticket leaves the server. You can choose None (does nothing), Close Ticket, or Delete Ticket.
[👑] Auto Close
Here you may toggle whether the ticket should automatically be closed after a set number of hours of inactivity.
[👑] Hours of Inactivity
Here you may choose the duration, in hours, of inactivity that should occur before the ticket should automatically be closed. The [👑] Hours of Inactivity setting is only visible if [👑] Auto Close is enabled.
[👑] Ignore Inactivity by Supporter
Here you may toggle whether the thread should automatically be closed only if the ticket creator is responsible for the inactivity. The [👑] Ignore Inactivity by Supporter setting is only visible if [👑] Auto Close is enabled.
[👑] Auto Delete
Here you may toggle whether the ticket should automatically be deleted after a set number of hours of inactivity.
[👑] Hours of Inactivity
Here you may choose the duration, in hours, of inactivity that should occur before the ticket should automatically be deleted. The [👑] Hours of Inactivity setting is only visible if [👑] Auto Delete is enabled.
[👑] Ignore Inactivity by Supporter
Here you may toggle whether the thread should automatically be deleted only if the ticket creator is responsible for the inactivity. The [👑] Ignore Inactivity by Supporter setting is only visible if [👑] Auto Delete is enabled.
To save the automation's settings, you need to click "Add" in the bottom-right corner of the settings. This will reset the fields so you can set up another automation.
Active Automations
When adding a new ticket automation, it and its settings will appear in this section. All ticket automations will be ordered by the number in which they were created. To view, edit, and delete the settings you selected for that automation, simply click the ticket automation you wish to do so for. You can find detailed information about each of the settings in the Automations section.
To save the edits you made on the ticket automation's settings, you need to click "Edit" in the bottom-right corner of the settings.
Variables
The Tickets module allows you to use variables to reference data while customizing its Settings, Commands, and Events. You can use Basic Variables, which are available across BotGhost, and Module Variables, which are available specifically for the Tickets module. Below you can find detailed information about each module variable and how it can be used.
Variable Reference | Variable Details |
---|---|
| Returns a channel link to the current ticket |
| Returns the name of the current ticket |
| Returns the channel ID of the current ticket |
| |
| |
| |
| Returns the number of created tickets on your bot. You can optionally set a specific number of digits for the variable to return with |
| Returns the number of created tickets on the current panel. You can optionally set a specific number of digits for the variable to return with |
Commands
Here you can find the commands for the Tickets module and modify them to your liking.
[👑] Add Command
The Add Command button allows premium members to create a Custom Command which will have access to this module's Settings and Variables.
Events
Here you can find the events for the Tickets module and modify them to your liking.
[👑] Add Event
The Add Event button allows premium members to create a Custom Event which will have access to this module's Settings and Variables.
It's advised that you do not edit the commands and events unless you have a good understanding of BotGhost and its Command Builder. If you encounter any issues, you might want to reset the module for it to work again as intended.
Additionally, a copy of the edited commands / events will be created if you update the module.
Last updated