Tickets

The complete ticket system with categories, questions, panels, ratings, AI support and transcripts.

In the panel under: Support, Tickets

The biggest module in AlphaCloud. Members open a ticket through a panel, optionally answer questions while doing so, and get a private channel with your support team. When the ticket is closed, a permanent transcript is created.

The structure

Panel          eine Nachricht im Kanal mit einem Kategorie Menü
  └─ Kategorie  Support Rollen, Limits, KI Einstellungen
       └─ Frage  Formularfelder, die beim Öffnen abgefragt werden
            └─ Ticket  der eigentliche Kanal
                 └─ Transkript  das dauerhafte Archiv

Quick start

  1. Enable the module

  2. Create a category

    Under Categories, enter a name and add it. Then set the support roles and the Discord category the ticket channels should be created in.

  3. Optional: add questions

    What the member should fill in when opening a ticket.

  4. Create a panel

    Under Panels, add a panel and set the channel, title and description.

  5. Send the panel

    Click Send. Only then is it in Discord.

  6. Set the log channel and save

General settings

Setting Meaning
Main Color Color of the ticket embeds
Log Channel Ticket logs end up here
Ratings Channel Where submitted ratings are posted
Rating Voice Channel A voice channel whose name shows the rating average
Rating Count Voice Channel The same for the number of ratings
Closed Category Where a closed ticket channel is moved to
Auto-delete closed tickets Deletes the channel instead of moving it
Enable ticket ratings Asks for a rating after closing
Show category load in ticket panel Shows in the panel how busy support is right now
DM on new staff reply The creator gets a DM when the team replies
Claim function Shows the claim button in new tickets and allows /ticket claim. Off means: no more button, tickets that are already claimed stay claimed
Close without confirmation The close button closes the ticket immediately, without asking
Only the claimer sees claimed tickets After claiming, only the claimer, the creator, administrators and the roles from These roles still see it can see the ticket channel. When released, the category's support roles get the channel back. Only applies in channel mode, the bot needs the Manage Roles permission for this
Show typical response time in ticket The greeting states how quickly your team usually replies for the first time, as the median of the last 30 days. Under 5 answered tickets, nothing is shown
Footer Text Custom footer for ticket embeds
Embed Thumbnail Thumbnail image
Panel Image Image in the selection panel

Panels

A panel is the message used to open a ticket.

Field Meaning
Panel Channel Where it is
Title and Description The content of the default embed
Assigned Categories Which categories show up in the menu. Empty means all
Panel design Your own design in the Message Builder. The category menu is always attached

With Send you post the panel, with Resend / Edit you update it.

Categories

Field Meaning
Category Name The name in the selection menu
Emoji Optional, in front of the name
Description Short explanation in the menu
Support Roles Who can see and handle tickets in this category
Open tickets as Own channel (default), Forum post or Private thread, see below
Discord Ticket Category The Discord category new channels are created in (own channel only)
Forum The forum the ticket posts are created in (forum post only)
Channel for the threads The text channel the private threads are created in. Empty means: the channel the panel is in (private thread only)
Max Tickets per User How many open tickets a member can have at the same time
Only the team can close The creator and added members can't close the ticket themselves, only the category's support roles and administrators. A close request via /closerequest still works
Medium Load from From how many open tickets the load counts as medium
High Load from The same for high

You change the order of the categories in the menu with the arrows.

Tickets as a forum post

Instead of creating a separate channel for every ticket, a category can open its tickets as posts in a forum. This keeps the channel list short, and all tickets sit neatly in one place.

  1. Create a forum

    Create a forum channel in Discord, for example "tickets".

  2. Switch the category

    In the category, set Open tickets as to Forum post and select the forum.

  3. Save the category

Step What happens in the forum
Open a ticket A new post, and the welcome message is the post itself. If the forum requires a tag, the bot sets the first available one
Close The post is locked, only members with "Manage Threads" can still write
Reopen The post is unlocked
Delete, transcript, claim, rename, AI support Same as with an own channel

Tickets as a private thread

Every ticket becomes a private thread in a text channel, just like with many other ticket bots. The channel list stays short, and unlike a forum post, a private thread is really private: only the creator, the team and those who can "Manage Threads" in that channel can see it.

  1. Choose the channel

    Either the channel your panel is in or a separate text channel. Announcement channels cannot have private threads.

  2. Switch the category

    In the category, set Open tickets as to Private thread and optionally choose the Channel for the threads.

  3. Set up team roles

    Give your support roles the Manage Threads permission in this channel. Then they see every ticket without being added one by one.

  4. Save the category

Step What happens in the private thread
Open a ticket A new private thread, the creator is added and the welcome message is pinned. Only the bot and the team can add more people
Team Roles with "Manage Threads" see every ticket. From all other support roles, the bot adds up to 25 members individually
Close The thread is locked, only members with "Manage Threads" can still write
Reopen The thread is unlocked and the creator is added again
/ticket add and /ticket remove Really grant or remove access. For a role, this affects its members, and the creator always stays in
/ticket transfer The team of the new category is added
Delete, transcript, claim, rename, AI support Same as with an own channel

Questions

For each category you can define a small form that appears when a ticket is opened.

Field Meaning
Label The question itself
Placeholder Example text in the input field
Required Whether the question has to be answered
Type Text (Short) for one line, Text (Paragraph) for more

AI Ticket System

Setting Meaning
AI Greeting The message the AI introduces itself with when the ticket opens
System Prompt Your instructions to the AI. Leave empty for the default
Disable AI when team member writes As soon as a team member writes, the AI switches off

You choose which AI backend is used under Setup.

The 22 customizable messages

Tickets has more customizable messages than any other module. They all live in one shared editor, grouped by phase and searchable.

Main messages

Message When it appears
Panel design The message with the category menu
Welcome message design When a ticket is opened, separate per category
Close message (channel) In the ticket channel when closing
Close message (DM) As a DM to the creator when closing
Reopen message In the channel when reopening

The 19 lifecycle notices

Group Messages
Close Close confirmation, Close request (DM to the creator), Close request (in the ticket)
Auto close Activated, Warning (DM), Cancelled, Timer reset, Closed automatically
Rating Rating request (DM), Rating posted in the rating channel
Team actions Ticket claimed, Ticket released, Ticket renamed, Ticket transferred, New reply (DM to the creator)
AI support AI support switched off, AI handed over to the team
Blacklist Ticket ban (DM), Ticket ban lifted (DM)

Variables

{user}, {actor}, {closedBy}, {reopenedBy}, {category}, {channel}, {reason}, {messageUrl}, {closeAt}, {newName}, {rating}, {feedback}, {answers}, {guild}, {memberCount}.

In the welcome message there are also {responseTime} (the usual response time as above, empty when there is too little data) and {answers.1} to {answers.5}: each one only the answer to a single question, in the order of the questions of the category. This way you can place the answers individually in their own fields instead of listing them all together with {answers}.

The editor itself shows you which of them are available in which message.

Commands

Command Effect
/ticket close Close the current ticket
/ticket add Add a user or role to the ticket
/ticket remove Remove a user or role
/ticket rename Rename the ticket channel
/ticket claim Claim the ticket
/ticket transfer Hand it over to another category
/ticket-blacklist add Ban a user from tickets
/ticket-blacklist remove Lift the ban
/closerequest Ask the creator to confirm closing
/autoclose Enable auto close for this ticket
/cancel-autoclose Cancel auto close again
/summarize Let the AI summarize the ticket

Transcripts

When a ticket is closed, a permanent transcript is created on transcript.alphacloud.bot. The close DM and the log contain a button that leads there.

Ticket transcriptsClosed tickets as a permanent, searchable archive in your browser.

Danger Zone

Delete closed ticket channels removes the Discord channels of all closed tickets at once. The ticket records and transcripts are kept.

Free and Premium

Feature Free Premium
Panels 2 unlimited
AI ticket support only with your own AI key included
Ad banner on the transcript page yes no

Required permissions

Manage Channels, Send Messages, Embed Links, Manage Messages, Read Message History, Manage Roles (for the channel permissions of the support roles). For tickets as forum posts, additionally in the forum: Send Messages in Threads and Manage Threads. For tickets as private threads, additionally in the channel: Create Private Threads, Send Messages in Threads and Manage Threads.

Support NotifyNotify the team as soon as someone is sitting in the support waiting room.