Introduction Documentation Commands Status Terms Open Dashboard
Documentation

Everything you need to know

Complete guide to setting up and managing Ticketo in your Discord server.

Getting Started

Ticketo is a Discord ticket management bot that handles support requests through interactive panels. Users click a button to open a ticket, and staff manage it through Discord commands.

Before creating panels, make sure you complete Configuration first — setting a staff role and transcript channel is required.

Quick Setup (4 Steps)

1
Log in to the Dashboard

Run /token in your Discord server as an admin. The bot will DM you a token. Paste it at the dashboard login page.

2
Set Global Configuration

Go to Configuration in the dashboard. Select your Staff Role and Transcript Channel, then save.

3
Create a Ticket Panel

Go to Ticket Panels, fill in the panel name, emoji, category, and channel, then click Create Panel.

4
Send the Panel to Discord

Click Send on your panel card. The bot will post it to your selected Discord channel instantly.

Web Dashboard

The dashboard is a web interface for managing your ticket system. It is accessible at the server URL and requires a management token to log in.

Dashboard Sections

  • Ticket Panels — Create, edit, send, and delete your panels
  • Configuration — Staff role, transcript channel, max tickets, ticket mode
  • Blacklist — Block users or roles from opening tickets
  • Analytics — View charts, stats, peak days, and recent tickets
  • Premium — Manage custom branding (if premium is active)

Getting Your Token

Run /token in any channel in your Discord server. The bot will send you a private DM with your management token. This token expires after 24 hours for security.

Never share your management token with others. It gives full access to your bot's configuration. If compromised, run /token again to generate a new one.

Creating Panels

Panels are Discord messages with buttons (or a select menu) that users click to open a ticket. Each panel can have its own name, emoji, category, and staff roles.

Panel Fields

  • Panel Name — Displayed on the button and in ticket channels
  • Panel Emoji — The emoji shown on the button (e.g. 🎫, 🔧)
  • Target Category — The Discord category where ticket channels will be created
  • Send Channel — The channel where the panel embed will be posted
  • Custom ID — A unique internal identifier (no spaces, e.g. support-panel)
  • Panel Roles — Up to 3 Discord roles that will have access to tickets from this panel
  • Welcome Message — The first message posted when a ticket is opened

You can send the same panel to multiple channels by editing it and clicking Send each time. Each send posts a new embed.

Configuration

The global configuration applies to all panels in your server. You must set at least a staff role and transcript channel before creating any panels.

Settings Overview

  • Staff Role — Members with this role can claim and manage tickets
  • Mention Staff on Open — Role to ping when a new ticket is created
  • Transcript Channel — Channel where HTML transcripts are posted on close
  • Max Open Tickets Per User — Limit how many tickets one user can have open
  • Ticket Mode — Switch between button-style and select-menu-style panels
  • Global Welcome Message — Default message for all tickets (overridden by panel-level message)
  • User Transcript DM — Send ticket owner a transcript copy via DM on close

Ticket Workflow

Understanding how a ticket moves through its lifecycle helps you configure Ticketo effectively.

Lifecycle

  • 1. User opens ticket — Clicks a button on a panel embed
  • 2. Channel created — A private channel is created in the target category
  • 3. Welcome message — Bot posts the welcome message and action buttons
  • 4. Staff claim — Staff member uses /claim to take ownership
  • 5. Resolution — Issue is resolved through conversation
  • 6. Close — Staff uses /close or clicks the close button
  • 7. Transcript — HTML transcript is generated and posted to the transcript channel
  • 8. Delete — Channel is deleted after confirmation

Closed tickets can be reopened with /open. The channel remains readable by staff even after closing.

Staff Management

Staff members manage tickets through Discord slash commands. They need the configured staff role or administrator permission.

Claiming Tickets

When a staff member runs /claim inside a ticket, they become the assigned agent. An unclaim button appears, and only they can transfer the ticket.

Transferring Tickets

Run /transfer @StaffMember to pass the ticket to another qualified staff member. Channel permissions are automatically updated.

Adding / Removing Users

Use /add @User and /remove @User to control who has access to a specific ticket channel.

Transcripts

When a ticket is closed, Ticketo automatically generates a full HTML transcript of the conversation.

  • The transcript is sent to your configured Transcript Channel
  • If User Transcript DM is enabled, the ticket owner also receives a copy via DM
  • Transcripts include all messages, embeds, timestamps, and usernames
  • They are standalone HTML files that can be opened in any browser

Make sure the bot has permission to send files in your transcript channel, or transcripts will fail to deliver.

Blacklist

The blacklist prevents specific users or roles from opening any tickets. You can manage it from the dashboard or Discord commands.

Blacklisting Users

Use the Blacklist section in the dashboard, or run /blacklist @User reason in Discord. Blacklisted users will see an error when they try to open a ticket.

Blacklisting Roles

Select a role from the Blacklist section in the dashboard. Any member with that role will be blocked from creating tickets.

Removing from Blacklist

Use the Remove button in the dashboard, or run /unblacklist @User in Discord.

Premium

Premium unlocks additional customization options for your ticket system.

  • Custom Panel Text — Add a custom footer or watermark to your panels
  • Custom Panel Banner — Add a banner image to your panel embeds

To activate premium on your server, contact the bot owner or use the /premiumgive command (owner only). Once active, the Premium section in the dashboard will unlock.

Frequently Asked Questions

The bot doesn't respond to commands

Make sure the bot has the correct permissions in your server: Manage Channels, Send Messages, Manage Roles, Read Message History, and Attach Files.

Panel buttons aren't working

Ensure the bot is online and that the panel's target category exists. The bot must have permission to create channels in that category.

Transcripts aren't being sent

Check that the transcript channel is set in Configuration, and that the bot has Send Messages and Attach Files permissions in that channel.

I lost my management token

Run /token again in Discord. The bot will DM you a fresh token. The previous token will be invalidated.

Can multiple admins use the dashboard?

The token is per-server and only accessible to server administrators. Share the token with trusted admins who need dashboard access.