Staff Tools

Staff commands for notes, tags, transcripts, canned replies, priority, statistics, claims, AI assistance, translation, and ModMail evidence

These commands are for people holding a staff role selected in the dashboard under Staff → Staff roles. They help staff work faster inside a ticket and keep tickets organised for the dashboard.

All commands on this page are staff only. /reply and /stats need the Basic plan or higher; /ai-help, /ai-style and /summary need Pro or higher. Everything else works on every plan.

Open ticket from a message

Right-click a member's message, then choose Apps → Open ticket. TicketCord opens a private ticket for that member and copies the message, its attachments, and a link to the original. The original message stays where it is.

The copied text shares one card with the source channel, original-message link, message author and staff member who opened the ticket. The welcome message and its controls stay above it. On Basic or higher, edit this card under Messages → Message ticket source. Very long messages continue in another card only when needed to fit Discord's text limit.

The command uses your server's ticket categories and ticket type from Opening tickets → Ticket categories, with the normal welcome message and staff access. It does not choose a panel or apply per-button settings. The member's blacklist, business hours, ticket limits, and creation cooldown still apply. Servers using ModMail must use the bot's DMs instead. Public thread tickets are not supported by this command: select private threads or ticket channels first.

Only staff can use the command. Discord hides it by default without Manage Messages; you can adjust command visibility in Server Settings → Integrations, but TicketCord still checks the staff role when it runs. Bot and webhook messages, and messages from members who have left, cannot open tickets.

The result is private. Press Notify in channel if you also want a public reply linking to the ticket. The notice does not ping anyone. On Basic or higher, customize its text under Messages, in Message ticket notice. Creating the ticket and sending the built-in notice work on every plan.

Attachments are copied as files, up to 8 MB each and 20 MB total, with at most three non-media files per message. If an attachment cannot be copied, no ticket opens. If copying fails after the ticket has opened, the private reply links to both the ticket and original message so staff can copy any missing content manually.

Errors: TC002 (not staff), TC012 (unsupported message or attachments), TC018 (public thread tickets enabled). The normal ticket-creation errors also apply.

/note

Keep internal notes on a ticket. Notes are visible to staff only, never to the ticket creator.

/note add <content>
/note view
/note remove <number>
SubcommandOptionTypeRequiredAllowed values
addcontentTextYesUp to 1000 characters
viewnone
removenumberIntegerYes1 or higher; the number shown by /note view

What happens: add stores the note with your name and the time. view lists the ticket's notes newest first, each with the number remove uses (note 1 is the oldest). Each note is shown in full; when the notes do not all fit in one message, the oldest are left out and counted at the end. remove deletes one note; you can only remove notes you wrote yourself.

Examples

/note add content:Customer is a VIP, prioritise the reply
/note view
/note remove number:2

Errors: TC002 (not staff, or removing someone else's note), TC012 (note over 1000 characters, or number out of range), TC017 (not in a ticket).


/tag

Label the ticket so it can be filtered in the dashboard.

/tag add <name>
/tag remove <name>
/tag list
/tag clear
SubcommandOptionTypeRequiredAllowed values
addnameText (autocomplete)YesUp to 50 characters; letters, numbers, hyphens, and underscores only
removenameText (autocomplete)YesA tag currently on the ticket
listnone
clearnone

Autocomplete suggests the Suggested tags set in the dashboard (Staff → Tags), but you can type any valid name. A ticket holds up to 10 tags by default; a server administrator can raise this to 25 with Tags per ticket on the same block.

Examples

/tag add name:billing
/tag remove name:urgent
/tag clear

Errors: TC012 (empty, too long, or invalid characters), TC015 (tag already exists, or nothing to clear), TC004 (removing a tag that is not on the ticket), TC016 (tag limit reached), TC017 (not in a ticket).


/transcript

Generate an HTML transcript of the current ticket.

/transcript [channel] [user] [limit] [evidence]
OptionTypeRequiredAllowed valuesDefault
channelText channelNoAny text channel (staff only)The transcripts channel from the dashboard, or the logs channel when it is Same as logs
userUserNoAny member (staff only)none
limitIntegerNo1 to 1000All messages
evidenceBooleanNoTrue or False (staff only)False

Who can run it: staff. Members who are not staff, the ticket creator included, cannot run it (TC002). The Transcript buttons on a ticket are staff only too.

What happens:

  1. The conversation is rendered as an HTML file with timestamps, usernames, message content, and references to attachments and embeds.
  2. The file goes to the dashboard transcripts channel by default (the logs channel when Transcripts is Same as logs), to the channel you name with channel, or as a DM to the member you name with user.
  3. A transcript posted in a channel also has a View online button, which opens the whole saved conversation in the browser, whatever limit says, for those allowed to read it online. A transcript sent by DM never has it.
  4. With evidence:True the file also includes Discord IDs and message links. Evidence transcripts can only be sent to staff members or staff-only channels.
  5. If limit cut the transcript short, the posted transcript says how many of the total messages were included.
  6. Your private reply shows the progress, then confirms where the transcript went. For a transcript posted in a channel it has an Open transcript button that jumps to the posted message.

The server needs a transcripts channel or a logs channel in the dashboard (General → Where the bot posts) before this command works, even when you override the destination (TC011).

Errors: TC002 (you are not staff, an evidence transcript targeted a non-staff recipient or channel, the member named with user does not accept direct messages, or the bot cannot post in the destination channel), TC008 (Discord did not return the server or channel), TC011 (neither a transcripts nor a logs channel configured), TC017 (not in a ticket).


/reply

Send a canned response by its shortcut.

/reply <shortcut>
OptionTypeRequired
shortcutText (autocomplete)Yes, up to 20 characters

Plan: Basic or higher. Basic and Pro can use up to 25 canned responses (the first 25 by creation date); Enterprise has no limit.

What happens: the saved response is posted in the ticket with its variables filled in, for example {user} becomes the creator's mention and {ticket.number} (or {ticketNumber}) becomes the ticket number such as #0042. Variables use single braces; double braces such as {{user}} do not work. See Canned Responses for every variable.

The response is not sent in a closed ticket, or when, with its variables filled in, it is longer than Discord's 2,000 character limit for one message (ModMail tickets excepted); shorten it in the dashboard.

Create responses in the dashboard under Staff → Quick replies (New reply), each with a name, a shortcut, and content.

Errors: TC014 (Free plan, or the response is beyond your plan's limit), TC004 (no response with that shortcut), TC002 (not staff), TC012 (the filled-in response is over 2,000 characters), TC015 (the ticket is closed).


/priority

Set the ticket priority. The channel name gets a coloured indicator and the dashboard shows the level.

/priority <level>
OptionTypeRequiredAllowed values
levelChoiceYesurgent (🔴), high (🟠), medium (🟡), low (🟢), none (removes the indicator)

What happens: the channel is renamed to 🔴-ticket-0001 (or the matching emoji), any previous indicator is removed, pin and claim markers stay in front of it (Channel name markers), and a private confirmation shows the old and new level and who changed it. none clears the indicator. If you use Response targets, the ticket's running timers switch to the new level's targets (urgent uses the Critical priority targets, none the Medium ones).

Discord allows only two renames per channel every 10 minutes. Changing priority a third time in that window returns TC001 and the dashboard shows the same message. The priority is not saved, so set it again after 10 to 15 minutes.

Errors: TC001 (rename rate limit), TC002 (not staff), TC012 (invalid level), TC017 (not in a ticket).


/stats

Show ticket statistics for this server. The response is visible only to you.

/stats [period]
OptionTypeRequiredAllowed values
periodChoiceNo7d, 30d, 90d, all

Plan: Basic or higher.

What it shows: one card with the tickets opened in the period and how many of them are still open or closed (closed includes deleted tickets, matching the dashboard), the average first response time (from ticket creation to the first staff message), and the average time to close. Like the dashboard, the averages leave out first replies of 7 days or more, messages from the staff member who opened the ticket, and closes that took over a year. Without a period it shows the last 30 days. Open in dashboard opens this server's Stats page, with charts, priorities, and exports.

Errors: TC014 (Free plan), TC002 (not staff), TC000 (the statistics could not be loaded; try again).


/staff-stats

See how your staff are doing in this server: the numbers of the dashboard's team page, in Discord. The response is visible only to you and never pings anyone.

/staff-stats [member] [period]
OptionTypeRequiredNotes
memberUserNoOne staff member's numbers. Anyone on staff can pick themselves; anyone else needs Manage Server
periodChoiceNoLast 7 days, Last 30 days (default), or Last 90 days

Plan: Basic or higher.

Who sees what: staff see their own numbers. Members with Manage Server (or Administrator) and the bot's owner also see the whole team and any member. Run without member, they get the team; everyone else gets their own card.

The team card shows the server's tickets, share handled by staff, median first reply, and rating, then one line per staff member, ten per page: tickets, closed, median first reply, rating with how many ratings, reopened share, and, only when there are any, late replies, handoffs, and idle claims.

Few tickets marks members with fewer than 10 tickets in the period. Pick a member from the menu to open their card. Turning pages, switching between the team and a member, and opening the card again within 30 seconds show the numbers already loaded; Refresh always loads them again.

A member's card shows tickets, closed, median first reply, median time to close, rating, and reopened share, each with the team median beside it, then handoffs, idle claims right now, and late replies.

Every number is counted exactly as on the team page, for this server only; see The team page for what each one means.

Calendar months, custom ranges, comparisons with the period before, business-hours medians, and reply activity are on the dashboard only: Open in dashboard opens the same view there. Both cards can be changed on the Messages page (Staff stats: team and Staff stats: one member).

Errors: TC014 (Free plan), TC002 (not staff, another member's numbers without Manage Server, or using someone else's controls), TC010 (controls from an old card; run /staff-stats again), TC000 (the numbers could not be loaded; try again).


/claims

List claimed tickets, five per page, with the creator, claim time, and last activity.

/claims [user]
OptionTypeRequiredNotes
userUserNoShow another staff member's claims instead of your own

The card has controls to switch between open and closed claims, sort by oldest claim, newest claim, highest priority, or longest since last activity, and page through results. The controls only respond to the person who ran the command; anyone else gets TC002 and must run /claims themselves. When Ticket summary (AI assistant → Atlas) is on for the server, each row also shows a one-line summary and urgency.

When you look at another member's claims, tickets you could not open yourself are left out of the list, for example a ticket in exclusive claim mode, one limited to staff roles you do not have, or one handed to another team. The card says how many were hidden on the page. Administrators and the bot owner see every row.

Errors: TC002 (not staff, or using another member's controls), TC010 (controls from an old card; run /claims again), TC000 (the list could not be loaded; try again).


/unclaimed

List the open tickets nobody has claimed, ten per page, the one waiting longest first, so you can see who still needs help.

/unclaimed

Each line links to the ticket and shows its name, who opened it, how long ago, and its priority when it has one. Previous and Next turn the page and Refresh loads the list again; they only respond to the person who ran the command. Tickets you could not open yourself are left out, for example one limited to staff roles you do not have or one handed to another team, and the card says how many were hidden on the page. Administrators and the bot owner see every ticket. The list is shown only to you, never pings anyone, and can be changed on the Messages page (Unclaimed tickets list).

Errors: TC002 (not staff, or using another member's buttons), TC010 (buttons from an old list; run /unclaimed again), TC000 (the list could not be loaded; try again).


/ai-help

Draft a reply with AI, based on the ticket conversation and your knowledge base. The draft is shown only to you.

/ai-help [instructions]
OptionRequiredDescription
instructionsNoWhat the draft should say or how to write it, up to 500 characters. For example tell them the refund is approved, keep it short or ask which platform they play on, in German.

Plan: Pro or higher.

Needs: the Atlas switch and the AI Help drafts card both on, under AI assistant → Atlas → AI Help drafts. The same switches control the AI Help button on the welcome message.

What happens: the bot reads the ticket, searches the knowledge base, and shows a suggested reply with its sources. Choose Send Now to post it as is, Edit & Send to change it first, or Try Again for a new draft. The draft is shown in a quote block under Send Now posts this to the customer:, and only the quoted text is sent. Anything only staff should see appears above it as Note for you (not sent):; when Atlas has no draft to suggest, you see only that note and Try Again. A draft is at most 1,800 characters: a longer one is shortened at the end of its last paragraph or sentence that fits. Drafts never count toward the Limit per member of the member who opened the ticket.

With instructions: the draft follows them, even when the latest question was already answered, and can use facts and links you give in them. On Topics to leave to staff Atlas tries to pass on your message without answering the topic; if it does not, reword the instruction as what the member should be told. They are shown under the draft's heading (Your instructions:), never sent to the member, and Try Again keeps them for 30 minutes. They cannot make the draft share anything Atlas would not share otherwise, such as restricted links or secrets. The AI Help button on the welcome message drafts without instructions.

Errors: TC014 (plan below Pro, or the owner's AI tokens or trial AI token allowance are used up), TC018 (Atlas or AI Help drafts is off; or the ticket's member is on Keep Atlas away from or the ticket was opened from a panel button that turns Atlas off), TC002 (not staff), TC015 (the ticket is closed), TC017 (not in a ticket), TC000 (the draft took too long or could not be written this time; try again or reply by hand).


/ai-style

Set how your own AI Help drafts sound on this server. The card is shown only to you and never pings anyone.

/ai-style

Plan: Pro or higher. If you already saved a style, the card still opens on any plan so you can pause or delete it; Use examples and Preview always need Pro or higher.

Needs: for your style to be used, and for Use examples and Preview, the Atlas switch and the AI Help drafts card both on, under AI assistant → Atlas → AI Help drafts. When AI Help cannot be used on the server, the card says AI Help is not available on this server right now, so your style is not in use.

What happens: a private card, Your AI Help style, shows whether your style is on, your five choices, and one menu per choice. A change in a menu is saved at once. Your style is used for the drafts you ask for on this server with this bot: the AI Help button, /ai-help, Try Again, and Draft a reply on the /summary and /claim cards. It never changes answers Atlas posts by itself, /summary, translation, or other staff members' drafts. When your style was used, the draft shows Using your style preferences. Change them with /ai-style above the quoted draft.

ChoiceOptions
LengthShort (as few sentences as the answer needs) or Detailed (step by step, with helpful context)
ToneCasual (relaxed, like messaging someone you know) or Formal (polite and professional, formal address)
WarmthMatter-of-fact (straight to the answer) or Warm (friendly, and acknowledges the member's problem)
EmojiNo emoji or Some emoji (one or two where they fit)
WordingPlain words (everyday words, technical terms explained) or Technical (precise terms for people who know the subject)

Each menu also offers Server default: no preference, so the server's setting applies.

What it never changes: a draft's facts, links and language, and whether a draft is written at all, stay the same. Where your choices conflict with the server's Instructions for Atlas, the server's instructions come first, and instructions you type in /ai-help instructions: for one draft come before your style. Your Length replaces the server's Reply length for your drafts.

Use examples: opens a form, Replies you wrote, with three fields (Reply 1 to Reply 3) for replies you sent. Reply 1 is required and needs at least 40 characters; each field takes up to 1,000. Your replies are read once to suggest choices, and TicketCord does not keep them. The card then shows From your examples: with the suggested choices, and the buttons Use this style and Discard. Use this style saves the suggested choices and keeps any choice your examples did not show. The suggestion stays on the card while you preview or change a choice, until you use or discard it. When your examples show no clear style, the card says Your examples did not show a clear style. Pick what you prefer below.

Preview: shows a Sample question and a Sample draft in your style. It is disabled while nothing is chosen or your style is paused.

Use examples and Preview use the bot owner's AI tokens and are limited per staff member and server: Use examples 5 times an hour, Preview 10 times an hour. A preview already shown in the last hour for the same choices and server settings is shown again without counting and costs nothing.

Pause, Resume and Reset: Pause keeps your choices but stops using them; Resume turns them on again. Reset deletes your saved style.

When you are no longer staff: if you still have a saved style, /ai-style shows it with Reset only, so you can delete it; nothing else works. Leaving the server deletes your saved style.

The card can be changed on the Messages page (AI Help style card).

Errors: TC002 (not staff, or using another member's controls), TC014 (a plan below Pro, when you open the card with no saved style or use Use examples or Preview; or the owner's AI tokens or trial AI token allowance are used up, for Use examples and Preview), TC018 (Use examples or Preview while Atlas or AI Help drafts is off), TC001 (Use examples or Preview used too often in the last hour; try again later), TC010 (controls from an old card; run /ai-style again), TC008 (your staff role could not be checked; try again), TC000 (your style could not be saved or loaded, or your examples or the preview could not be read or written this time; try again in a moment).


/summary

Summarize the ticket in a few lines: what the member needs, where it stands, and what to do next. Use it to catch up on a long ticket or before handing it to a colleague. Works in every kind of ticket: channel tickets, thread tickets, and ModMail. Shown only to you.

/summary

What you see:

  • Status line: whether the ticket is waiting on staff, waiting on the member, looks resolved, or was escalated (closed tickets show Closed), with High urgency or Critical urgency when the conversation shows it, and who claimed the ticket. Below it: when the ticket was opened and who replied last, and when.
  • What's happening: two or three sentences on the member's problem and where things stand.
  • Already tried: up to three steps that were already tried, each with its outcome. Left out when nothing has been tried yet.
  • Next step: the most useful thing to do next, such as the follow-up question to ask the member, the answer staff owe, or closing a ticket once the member has confirmed the problem is fixed.
  • Draft a reply: writes a reply for the ticket with AI Help, which you can send as is, edit first, or try again. In a ModMail ticket the reply goes to the member as your ModMail reply. Shown on open tickets when the AI Help drafts card is on.

The summary is written in your bot language (General → Bot language), like the rest of the card, whatever language the member writes in.

Plan: Pro or higher.

Needs: the Atlas switch on, at the top of AI assistant → Atlas. The Ticket summary card does not need to be on.

Errors: TC014 (plan below Pro, or the trial AI token allowance is used up), TC018 (Atlas is off, or the ticket's member is on Keep Atlas away from or the ticket was opened from a panel button that turns Atlas off), TC002 (not staff), TC017 (not in a ticket), TC004 (the ticket has no messages to summarise), TC000 (the summary could not be written this time; try again in a moment).


/context

Show how much of the AI conversation context this ticket is using. Shown only to you.

/context

What it shows: a bar and how many tokens of the context window Atlas's conversation in this ticket uses, how many messages it holds, and a status: Healthy, Moderate (from 50%), Compacting soon (from 70%), or Critical (from 90%). When older messages were already summarized to save room, it says so. If Atlas has not answered in the ticket yet, it says there is no conversation history.

Errors: TC002 (not staff), TC017 (not in a ticket), TC000 (the conversation could not be loaded; try again).


/translation

Turn AI translation on or off for the current ticket.

/translation <enabled>
OptionTypeRequiredAllowed values
enabledBooleanYesTrue to enable, False to disable

Translation must first be on for the server: the Atlas switch and the Translate tickets card (Enterprise), under AI assistant → Atlas → Translate tickets. In a ModMail ticket, Translate ModMail (Pro or higher) is enough: with either direction on, the command turns that ticket's ModMail translation on or off; Polish staff replies keeps running. See Translation for what gets translated.

The reply is one line, only for you, saying whether translation is now on or off for the ticket and how to switch it back.

Errors: TC018 (Atlas or Translate tickets is off for the server; in a ModMail ticket, Translate ModMail is also off), TC002 (not staff), TC017 (not in a ticket).


/modmail

Inspect evidence for a ModMail ticket. Works only in ModMail ticket channels.

/modmail message <number>
/modmail evidence
SubcommandOptionTypeRequiredAllowed values
messagenumberIntegerYes1 up to the number of messages in the ModMail transcript
evidencenone

message returns the linked Discord IDs for one message by its position in the transcript. evidence shows a compact evidence pack for the whole ticket. Attachment links point to the copy TicketCord stored when there is one (open it while signed in to the dashboard), so they keep working after Discord's own links expire.

Errors: TC004 (message number out of range), TC002 (not staff), TC017 (not a ModMail ticket).

Common questions

Can the ticket creator see my notes? No. Notes are only shown to staff through /note view and in the dashboard.

Why does /reply say a response is not available on my plan? Basic and Pro include the first 25 canned responses by creation date. Delete unused ones under Staff → Quick replies or upgrade to Enterprise for an unlimited number.

Why did /priority fail with TC001? Discord limits channel renames to two every 10 minutes and priority changes rename the channel. Wait 10 to 15 minutes and try again.

Can I send a transcript to someone who is not staff? Yes, with user:@name, as long as evidence is off. Evidence transcripts only go to staff or staff-only channels.

Why does /transcript say no transcript channel is configured when I passed a channel? The command needs a transcripts channel or a logs channel set in the dashboard, even when you override the destination. Set Staff logs (or Transcripts) under General → Where the bot posts.

Where do tag suggestions come from? From the Suggested tags configured in the dashboard under Staff → Tags. You can still type any name made of letters, numbers, hyphens, and underscores.

Does /ai-help post anything automatically? No. The draft is private until you press Send Now or Edit & Send.

Do other staff or members see my /ai-style choices? No. The card is shown only to you, and your style only shapes the AI Help drafts you ask for. Other staff members' drafts and the answers Atlas posts in tickets are not affected.

Last updated on

On this page