Getting Started

This guide walks you through setting up Ticketo in your Discord server for the first time.

---

Step 1: Invite the Bot

Use the invite link provided by your Ticketo instance administrator, or visit the bot's website and click the Add to Discord button.

When inviting, the bot requires these Discord permissions:

• Manage Channels — To create and delete ticket channels

• Manage Roles — To set ticket channel permissions

• Send Messages — To post in ticket channels and log channels

• Embed Links — To send rich embeds

• Attach Files — To send transcript files

• Read Message History — To archive ticket messages

• Use External Emojis — For emoji in panels and responses

• Add Reactions — For interactive elements

• Manage Messages — To pin messages in tickets

• Manage Threads — To create and manage ticket threads

• Create Public Threads / Create Private Threads — For thread-based tickets

Tip: Grant the bot the Administrator permission for a hassle-free setup. You can tighten permissions later once everything is working.

---

Step 2: Initial Server Setup

When Ticketo joins your server, it automatically:

1. Creates a configuration record with default settings

2. Sets the server language based on your Discord server's preferred locale

3. Sends a welcome DM to the person who invited the bot with setup instructions and quick links

No additional setup commands are required to start — the bot is ready to go once it joins.

---

Step 3: Access the Dashboard

The web dashboard is where most configuration happens.

1. Use the /dashboard slash command to get a link to the dashboard

2. Click the link to open the dashboard in your browser

3. Sign in with your Discord account

4. Select your server from the list

You must have the Manage Server permission in Discord to access the dashboard for a guild.

[Screenshot placeholder: Dashboard guild selection page]

---

Step 4: Configure Support Roles

Before your staff can manage tickets, you need to assign support roles.

1. Go to Dashboard → Settings

2. Find the Support Roles section

3. Add the Discord role(s) that your support staff have

4. Save changes

Members with these roles will be able to:

• View all tickets

• Claim and close tickets

• Use staff-only commands like /priority and /thread

---

Step 5: Create Your First Ticket Panel

A ticket panel is the message users click to create a ticket.

Using the Dashboard (Recommended)

1. Go to Dashboard → Panels

2. Click Create New Panel

3. Configure the panel:

   • Title — The embed title (e.g., "Need Help?")

   • Description — Instructions for users

   • Channel — Where to post the panel

   • Buttons/Options — Add ticket categories users can choose from

4. Click Send to publish the panel in your Discord channel

Using the Slash Command

Run /panel in any channel. This creates a basic panel with default settings.

Free tier: You can create up to 3 panels. Premium unlocks unlimited panels.

[Screenshot placeholder: Panel creation in dashboard]

---

Step 6: Set Up a Log Channel (Optional)

Ticketo can log ticket events to a designated channel.

1. Go to Dashboard → Settings

2. Set one or more of:

   • Log Channel — All ticket events

   • Opened Log Channel — Only ticket opens

   • Closed Log Channel — Only ticket closes

3. Save changes

Make sure the bot has Send Messages and Embed Links permissions in the log channel.

---

First-Time Setup Checklist

• Invite the bot with the required permissions

• Access the dashboard via /dashboard

• Configure support roles in Settings

• Create at least one ticket panel in Panels

• (Optional) Set up a log channel

• (Optional) Configure custom questions for ticket categories

• (Optional) Enable the feedback system

• (Optional) Customize embed colors and footer text

• Test the setup by creating a ticket yourself

---

What's Next?

• Dashboard Guide — Explore all dashboard settings

• Ticket System — Learn how tickets work in detail

• Commands Reference — See all available commands

• Permissions Guide — Understand the permission model