Tickets

Make sure that your tickets module is enabled before configuring the tickets module (!module tickets to enable, and !module list to see if it's enabled).

Setting Up Tickets Module

The command used for setting up the tickets module is pobox, which has a set of other subcommands that allows you to edit the module's current settings without the need to remember several commands. The tickets module allows for a modmail system in which your community members can interact with your staff about issues, suggestions, reports, etc.

The list below details the minimum needed permissions in order for the tickets module to function:

  • View Channels
  • Send Messages
  • Embed Links
  • Manage Channels (to open and close ticket system channels)

Pobox

As previously stated, this is the only command needed for the configuration of the tickets module. The other commands within the tickets module are solely used for moderation purposes, aside from !send

Make sure that your tickets module is enabled before configuring the tickets module (!module tickets to enable, and !module list to see if it's enabled).

Required Permissions (Staff)

Syntax

!pobox subcommand [input or arguments to set]

Examples

Instead of the conventional example list and because there are many subcommands for the pobox command, a detailed table for all the subcommands and their applicable inputs are listed below.

Subcommand Descriptive Example

current

!pobox current

 

- Displays all current settings in the tickets module

channel/category

!pobox channel #channel

!pobox category Tickets Category

 

- For channel, sets  which channel new ticket notifications are posted

- For category, sets the category where all ticket handling channels to be created

agelimit

!pobox agelimit number

 

- Sets how old an account must be before they can submit a ticket

responsetype

!pobox responsetype text/embed

 

- Sets the message type received after submitting a ticket to either text or embed

newmailtype

!pobox newmailtype text/embed

 

- Sets the notification's message type of new mail to either text or embed

newmail/response

Variables

!pobox newmail text/discohooklink

!pobox response text/discohooklink

 

- For newmail, sets what the notification for new mail will say or in a discohook link form

- For response, sets the message to be sent to the person who submits a ticket

Variables

forcedump

!pobox forcedump off/text/html


- After closing a ticket, the entire channel will be archived in either:

  • Text format
  • HTML format
  • No archive

 

NewMail & Response Variables

NOTE: When using newmail and response, you are allowed to use multiple variables listed below.

These variables can be used anywhere in the message.

The variables listed below provide a more tailored response and notification system for your modmail tickets system. As a reminder, these variables can be used anywhere in the response or newmail.

Variable Description Where Can I Place This?
%name Mention of ticket sender Anywhere
%tag Username#### of ticket sender Anywhere
%id UserID of ticket sender Anywhere
%date Date of ticket submission Anywhere
%tid TicketID Anywhere
%mid MessageID from ticketing channel Anywhere
%guild Server name Anywhere
%content Entire ticket contents Anywhere
%uimg Avatar URL of ticket sender Anywhere

 


 

Moderation Commands

The commands listed below are used solely for moderation purposes. It's possible to allow some of these commands for trusted senior moderators with the allow command. Restricting the command to a certain channel helps instill a process for your staff to utilize in the community's tickets system.

This table will get an update soon.

Command  Description Example
!assign userID ticketID Opens the ticket and assigns it to the staff !assign userID ticketID
!unassign userID ticketID Unassigns a staff from the ticket !unassign userID ticketID
!closeticket ticketID Closes and marks resolved the ticket, marks it resolved, and deletes the channel
If requested, creates a full dump of the channel
!closeticket ticketID
!ticketstatus ticketID Displays the ticket status !ticketstatus ticketID
!blockticket userID Prevents that user from sending tickets !blockticket userID
!unblock userID Re-allows that user to send tickets !unblock userID

 


 

Send (Public Command)

Anyone can use this command except for those in panicd or muted.

Command Description Example
!send Sends a completely private ticket to the server staff

Upon activation, the bot will DM you and ask for input, waiting up to 10 minutes.

NOTE:
You must allow DMs to be sent from server members in your privacy settings.
!send

 


 

FAQ

 

Q. Will kicking Gaius reset the bot?

- No, kicking/banning Gaius will never reset your settings or prefix.

Q. How do I see all the commands?

- The help command is man's best friend (not dogs).

 

 


 

Video

Not yet available

If you have or find a video on Gaius specifically for what is covered in this documentation page, you can send the info to Fairy 狐 紫#0001 via DM (You must be in the support server in order to make contact).

 


 

Points of Interest

Staff Handbook
Bot Logging/Exlog
Verification Module
Anti-Spam Protection
Wordlist Filtering

 

(Top of Page)

Previous Page   |   Next page

 

 


Revision #26
Created Sun, Mar 29, 2020 11:28 AM by Tommyfoxy2
Updated Mon, Sep 13, 2021 1:41 AM by Fairy