Tickets
Let server members contact staff through a ticket!
Last updated
Let server members contact staff through a ticket!
Last updated
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.
Here you can find the settings for the Tickets module and modify them to your liking.
Here you may choose roles from your server which will have access to /ticket setup.
Here you may choose the color of all embeds in the panel messages.
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.
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.
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.
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.
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.
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.
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.
Here you may customize the text users will click to create a ticket, which will be shown on the Layout option you chose.
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.
Here you may choose the emoji, if any, should be displayed to the left of the Button / Select Menu Label text you customized.
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.
Here you may choose roles from your server which will have access to all created tickets on this panel, even when they're closed.
Here you may choose roles from your server which cannot create tickets on this panel.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Here you may choose whether tickets will be created as new text channels or as new private threads in an existing text channel.
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.
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.
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.
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.
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 /ticket setup 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.
Here you may toggle whether /ticket create can be used.
Here you may choose the panel that the /ticket create 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.
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.
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.
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.
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.
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..
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.
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.
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.
Public Thread
Requires the View Channel permission to be enabled in the Transcripts Channel to see the transcript. A link may be sent to that channel when a transcript is created. Recommended for private channels.
Private Thread
Requires the Manage Threads permission to be enabled in the Transcripts Channel to see the transcript. This permission also allows users to modify and delete transcripts. Recommended for public channels.
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.
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.
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.
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.
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.
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 /ticket update-counts command to update the module's data.
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 /ticket update-counts command to update the module's data.
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 /ticket update-counts command to update the module's data.
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 /ticket update-counts 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.
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.
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.
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.
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.
Here you may toggle whether the ticket should automatically be closed after a set number of 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.
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.
Here you may toggle whether the ticket should automatically be deleted after a set number of 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.
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.
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.
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.
{ticket}
Returns a channel link to the current ticket
{ticket_name}
Returns the name of the current ticket
{ticket_id}
Returns the channel ID of the current ticket
{controls}
Returns the available Commands to be used in the current ticket
{form}
Returns the creator's Send Form responses for the current ticket, if applicable
{ping}
Returns an @mention for all Support Roles of the current panel. A notification will not be sent if placed in an embed
{total_count}
Returns the number of created tickets on your bot. You can optionally set a specific number of digits for the variable to return with {total_count[DIGITS]}
, replacing DIGITS with the number of digits to return. Example: {total_count[3]}
= 007
{panel_count}
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 {panel_count[DIGITS]}
, replacing DIGITS with the number of digits to return. Example: {panel_count[3]}
= 007
Here you can find the commands for the Tickets module and modify them to your liking.
The Add Command button allows premium members to create a Custom Command which will have access to this module's Settings and Variables.
Here you can find the events for the Tickets module and modify them to your liking.
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.