Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/astrxnomo/discord-ticket-bot-py/llms.txt

Use this file to discover all available pages before exploring further.

Discord Ticket Bot is an open-source, self-hosted Python bot that brings a full ticket management system to your Discord server. Powered by discord.py and the Discord Components Library, it uses interactive buttons and select menus so members can create private support channels without any slash-command friction.

Introduction

Learn what Discord Ticket Bot is and how it works under the hood.

Quickstart

Clone the repo, install dependencies, and have the bot running in minutes.

Configuration

Set your category, logs channel, staff role, and embed color.

Bot Commands

Full reference for every command and interaction the bot handles.

How It Works

1

Clone & Install

Clone the repository and install dependencies with pip install -r req.txt.
2

Register Your Bot

Create a Discord application, add a bot account, and invite it to your server with the required permissions.
3

Configure the Bot

Open main/main.py and fill in your category ID, logs channel ID, staff role ID, and bot token.
4

Run and Deploy

Start the bot with python main/main.py. Type tb!ticket in any channel to post the ticket panel.

Key Features

Interactive Ticket Creation

Members click a single button to open a ticket — no commands to remember.

Ticket Categories

Select menus let users choose Question, Help, or Report before a channel is created.

Scoped Channel Permissions

Each ticket channel is visible only to the ticket creator and your staff role.

Staff Notifications

A built-in Call Staff button pings your staff role directly inside the ticket channel.

Confirmed Close Flow

Closing a ticket requires confirmation, preventing accidental deletions.

Ticket Logs

Every closed ticket is automatically logged in a dedicated channel with closer details.

Build docs developers (and LLMs) love