Page cover

Custom Ticket System

Need a custom application/ticket system? Read on!

Output Example
CTS Process

What is this?

CTS is a module that allows you to setup Google Form like interactions right from discord!

An example of a discord form/modal.

You'll be able to set this up without creating a developer commission and link it with any channel or category from any server!

If you want to change something that is read only or just want to reset everything, ping Space to delete the configuration so you can set it up again.

Setup Tickets

Start the configuration process here!

  • Permission Level Required: Permit 2

  • Usage: /cts setup-tickets <title> <channel_identifier> <button_label> <category_id> <start_channel> <transcript_channel> <role_id> <limit>

  • Description: Creates a CTS Configuration for you.

    • title

      • Title (also serves as a description for refrence on what this ticket system does) for the Modal/Form.

    • channel_identifier

      • A string that will be attached to every channel name in order to identify what type of ticket it is. This will be consistent for all tickets!

        • Ex: #spaceturtle-channelidhere

    • button_label

      • Label for the button in order to start the process.

    • category_id

      • Category ID for where all tickets will go.

    • start_channel

      • Where all tickets originate or where the button will be sent.

        • NOTE: This can be modified with the send-button command later on.

    • transcript_channel

      • Where all transcripts get sent.

    • role_id

      • A comma separated list of role ids that should have access to the ticket channel when created. Leave blank if it should be for administators only.

        • Accepted Input Examples:

          • 988438003246596148, 951302660118683659, 951302641512763433

          • 951302660118683659

          • nothing

    • limit

      • A limit to how many tickets a user can have open. Leave blank if there should be no limit.

  • NOTE: You will be able to specify questions after the command has been parsed by the bot. At least one question is required as of inital release.

Send Button

  • Permission Level Required: Permit 2

  • Usage: /cts send_button <conf_id> <channel> <message_id>

  • Description: Sends a pre-configured button to a channel.

    • conf_id

      • Configuration ID that associates with the button you want to send.

    • channel

      • The destination channel to where the button should be sent. Leave this blank for the bot to send it to the channel on-file when this configuration was created.

    • message_id

      • NOTE:

        • If you input a message ID, make sure the message is PRESENT in the channel you provided. You must provide channel as well due to a discord limitation.

        • The message must be owned by Timmy, otherwise the bot will not be able to edit the message.

      • ID of the message you want Timmy to attach the button to so its all in one message.

      • Use the +say command to send instructions and then use this command to attach the button to the same message.

  • NOTE: Buttons are compatible in different channels within the same server, buttons will not work cross-servers!

Edit Questions

  • Permission Level Required: Permit 2

  • Usage: /cts edit_modal <conf_id> <edit_mode>

  • Description: Edits content that is directly on the form (questions and restrictions on answers)

    • conf_id

      • Configuration ID that associates with the button you want to edit.

    • edit_mode

      • Select Edit Questions to add/remove/edit the questions itself. Eg; if you wanted to rename the questions to something else.

      • Select Edit Attributes to edit min/max character limit and field type (short/big box's).

        • When you select this option, you will see a form pre-filled with your questions. In the answer box, use the following format:

          • S/L, Min Char. Limit, Max Char. Limit

          • MAKE SURE IT FOLLOWS THE ORDER, HAS COMMAS SEPARATING EACH ARGUMENT, AND HAS A NUMBER FOR THE CHARACTER LIMITS!

        • S for short box and L for long/tall box.

        • Min Char. Limit for the minimum character limit.

        • Max Char. Limit for the maximum character limit.

  • NOTE: You are still able to remove and add questions after setting or editing them!

Edit Configuration

  • Permission Level Required: Permit 2

  • Usage: /cts edit_config <conf_id> <element> <value>

  • Description: Edits the configuration.

    • conf_id

      • Configuration ID that associates with the button you want to edit.

    • element

    • value

      • NOTE:

        • Please send the correct data type for the appropriate elements.

          • Ex: Don't send characters in any of the channel elements, it wants its ID, not text.

      • The value you want the element to be updated with.

Last updated

Was this helpful?