Dashboard Guide

The Ticketo web dashboard provides a graphical interface for managing your server's ticket system. This page covers every section of the dashboard.

---

Accessing the Dashboard

1. Run /dashboard in Discord to get the link

2. Sign in with your Discord account (OAuth2)

3. Select a server you have Manage Server permission in

The dashboard URL is determined by the HTTP_EXTERNAL environment variable set during deployment.

---

Dashboard Home

Route: /dashboard

After signing in, you see a list of Discord servers where:

• You have admin/management permissions

• The bot is also present

Click a server to open its management panel.

[Screenshot placeholder: Guild selection list]

---

Server Overview

Route: /dashboard/:guild

The overview page shows:

• Ticket Statistics — Total tickets, open tickets, closure rates

• Average Response Times — How quickly staff respond

• Average Ratings — User feedback scores

• Member Count — Current server member count

• Premium Status — Whether premium is active

• Configuration Warnings — Issues like missing bot permissions in log channels

[Screenshot placeholder: Server overview dashboard]

---

Settings

Route: /dashboard/:guild/settings

The settings page lets you configure all server-wide ticket options. Settings are loaded from the API and saved via PATCH requests.

General Settings

Setting	Description	Default
Language/Locale	Bot response language	Server's Discord locale or en-GB
Command Prefix	Prefix for text commands (premium feature)	?
Primary Colour	Embed color for all ticket messages	#252B4C
Footer Text	Text shown in embed footers	Ticketo | ticketo.xyz

Ticket Behavior

Setting	Description	Default
Archive Tickets	Save messages when tickets close	true
Confirm Close Prompt	Show confirmation before closing	true
Close Requires Reason	Require a reason when closing	false
Close Requires Support Role	Only support roles can close tickets	false
DM User on Close	Send a DM to the ticket creator when closed	true
Hide Closing User	Don't show who closed the ticket	false
Default Close Reason	Auto-filled reason when closing	None
Manual Ticket Style	Create manual tickets as channel or thread	channel
Archive Thread Tickets	What to do with closed thread tickets: archive or delete	delete
Continuous Numbering	Use continuous ticket numbers across all categories	true

Limits

Setting	Description	Default
Max Active Tickets	Maximum total open tickets per server	None (unlimited)
Max Active Tickets Per User	Maximum open tickets per user	None (unlimited)

Claiming

Setting	Description	Default
Claim Button	Show a Claim button on ticket opening messages	false
Claiming Mode	How claiming works: disabled, no-changes, readonly, private	disabled
Ping Author on Claim	Notify ticket creator when staff claims their ticket	false

Feedback

Setting	Description	Default
Enable Feedback	Show a satisfaction survey after ticket closes	false

Staff

Setting	Description	Default
Support Roles	Role IDs that can manage tickets	[] (empty)
Ping Support Roles	Ping support roles when a new ticket opens	true
Create Staff Thread	Auto-create a private staff thread for each ticket	false
Log Staff Message Counts	Track staff message counts in tickets	true

Logging

Setting	Description	Default
Log Channel	Channel for all ticket events	None
Opened Log Channel	Channel for ticket-opened events only	None
Closed Log Channel	Channel for ticket-closed events only	None

Auto-Close

Setting	Description	Default
Auto Close	Auto-close inactive tickets after this duration (ms)	None (disabled)
Stale After	Mark tickets as stale after this duration (ms)	None (disabled)
Auto-Close on Leave	Close tickets if the creator leaves the server	false

Access Control

Setting	Description	Default
Blocklist	Roles/users blocked from creating tickets	[]
Role-Specific Transcript Viewing	Restrict transcript access by role	false

[Screenshot placeholder: Settings page sections]

---

Ticket Panels

Route: /dashboard/:guild/panels

Panels are the interactive messages users click to create tickets.

Panel List

View all existing panels with their channel, message ID, and status.

Create Panel

Route: /dashboard/:guild/panels/new

Build a new panel with:

• Embed content — Title, description, color, images, footer

• Message content — Plain text above the embed

• Buttons/Select menus — Each button/option creates a specific ticket type

• Per-button settings — Category, custom questions, opening messages, required roles, thread options

Edit Panel

Route: /dashboard/:guild/panels/:panel

Modify an existing panel's embeds, components, and settings. Click Send to (re-)publish the panel to a Discord channel.

Free tier limit: 3 panels. Premium unlocks unlimited.

[Screenshot placeholder: Panel editor with embed preview]

---

FAQ Panels

Route: /dashboard/:guild/faqs

FAQ panels are searchable embed messages with question-and-answer pairs.

Create FAQ

Route: /dashboard/:guild/faqs/new

Configure:

• Embed appearance — Title, description, color, author, images, footer

• Questions — Each FAQ item with question text, answer, emoji, and optional link buttons

• Search placeholder — Custom text for the search dropdown

Edit FAQ

Route: /dashboard/:guild/faqs/:faq

Modify questions and embed settings. Click Publish to send/update the FAQ embed in a Discord channel.

Free tier limit: 3 FAQ panels. Premium allows up to 10.

---

Custom Commands

Route: /dashboard/:guild/commands

Create custom text commands that respond with preset messages. This is a premium feature.

Each command has:

• Trigger — The text that invokes the command (after the prefix)

• Name — Display name

• Content — The response message

• Reply to Message — Whether to reply inline

• Delete Command — Whether to delete the invoking message

• Allowed Roles — Which roles can use the command

• Allow All Staff — Whether all support roles can use it

• Enabled — Toggle on/off

Limit: Up to 15 custom commands per server.

---

Templates

Route: /dashboard/:guild/templates

Save panel configurations as reusable templates. This is a premium feature.

• Save — Save any panel as a template

• Import — Import a template from another server using its export key

• Apply — Use a template to create a new panel

---

Ticket History

Route: /dashboard/:guild/tickets

Browse all tickets in your server with:

• Search and filtering

• Ticket status (open/closed)

• Creator, creation date, close date

• Priority level

Ticket Detail

Route: /dashboard/:guild/tickets/:ticket

View full details for a specific ticket including topic, messages, status, and metadata.

---

Feedback

Route: /dashboard/:guild/feedback

View collected user satisfaction feedback from closed tickets:

• Star ratings (1-5)

• Written comments (decrypted for display)

• Associated ticket information

Feedback collection must be enabled in Settings → Enable Feedback.

---

Premium

Route: /dashboard/:guild/premium

View and manage your premium subscription:

• Current plan and status

• Feature comparison (free vs. premium)

• Upgrade/manage subscription button

• Billing period information

---

Data Management

Export

Download all your server's ticket data and configuration as a ZIP archive. Available via the admin API.

Import

Restore ticket data and settings from a previously exported ZIP file.

Reset Counters

Reset the ticket numbering counter back to zero.

Reset Settings

Delete all server configuration and restore defaults.

Warning: Reset operations are destructive and cannot be undone.

---

Configuration Warnings

The dashboard automatically detects common misconfigurations:

• Missing log channel permissions — Bot lacks Send Messages or Embed Links in log channels

• Bot public mismatch — Bot is publicly invitable but PUBLIC_BOT is not set

• Additional platform-specific warnings

These appear as alerts on the server overview page.