# Ticker Boy – Professional Discord Ticket Bot (v1.3.9)

<a href="https://top.gg/bot/1241112292616044695">
  <img align="right" src="https://github.com/user-attachments/assets/0d99dc9e-8d41-406c-8587-c5fa5e468ca5" width="25%" alt="Ticker Boy Avatar">
</a>

**The most advanced, user-friendly, and fully customizable ticket system for Discord.**  
**Supports Slash Commands, Buttons, Select Menus, Multi-Language (English & Persian), and a Web Dashboard.**

---

> **Invite Ticker Boy** → [Add to Server](https://discord.com/api/oauth2/authorize?scope=bot+applications.commands&client_id=1241112292616044695&permissions=395674250441)  
> **Support Server** → [Join Persian Caesar](https://discord.gg/AfkuXgCKAQ)  
> **Vote on Top.gg** → [Vote Now](https://top.gg/bot/1241112292616044695/vote)

---

## Why Choose Ticker Boy?

| Feature                       | Description                                               |
| ----------------------------- | --------------------------------------------------------- |
| **Interactive Ticket Panels** | Users create tickets via **buttons** and **select menus** |
| **Professional Dashboard**    | `/settings` command with full visual setup                |
| **Multi-Language Support**    | English (`en`) & Persian (`per`) – easy to extend         |
| **Flexible Database**         | JSON, SQLite, MySQL, MongoDB                              |
| **HTML Transcripts**          | Auto-save full chat history on close/delete               |
| **Claim & Permissions**       | Staff can claim, add/remove users, rename, reopen         |
| **Mod Logs & Webhooks**       | Full audit trail in dedicated channel                     |
| **Anti-Crash & Logging**      | Robust error handling + webhook alerts                    |

---

## Bot Commands

All commands support **slash (`/`) and message (`!`)** formats where applicable.

### Information Commands
| Command                | Usage             | Description                                                     |
| ---------------------- | ----------------- | --------------------------------------------------------------- |
| `/help` or `!help`     | `/help [command]` | Shows bot info, command list, and detailed help for any command |
| `/invite` or `!invite` | —                 | Get invite links for the bot and support server                 |
| `/ping` or `!ping`     | —                 | Check bot latency, WebSocket ping, and uptime                   |

---

### Ticket Management
| Command                              | Usage | Required Permissions | Description                              |
| ------------------------------------ | ----- | -------------------- | ---------------------------------------- |
| `/create` or `!t`                    | —     | `Send Messages`      | Opens a new ticket via panel or command  |
| `/close` or `!close`                 | —     | `Send Messages`      | Closes current ticket + sends transcript |
| `/add @user` or `!add @user`         | —     | `Manage Channels`    | Add a user to the ticket                 |
| `/remove @user` or `!remove @user`   | —     | `Manage Channels`    | Remove user from ticket                  |
| `/claim` or `!claim`                 | —     | `Manage Channels`    | Claim ticket (restricts other staff)     |
| `/rename <name>` or `!rename <name>` | —     | `Manage Channels`    | Rename ticket channel                    |
| `/open` or `!open`                   | —     | `Manage Channels`    | Reopen a closed ticket                   |
| `/delete` or `!delete`               | —     | `Manage Channels`    | Delete ticket + send transcript          |
| `/transcript` or `!transcript`       | —     | `Manage Channels`    | Generate & send HTML transcript          |

---

### Admin & Setup
| Command     | Usage                   | Required Permissions              | Description                                                         |
| ----------- | ----------------------- | --------------------------------- | ------------------------------------------------------------------- |
| `/settings` | `/settings [ephemeral]` | `Manage Guild`, `Manage Channels` | **Interactive setup dashboard** – configure everything in one place |

#### Setup Options in `/settings`:
- **Bot Language** → `English` or `Persian`
- **Ticket Panel Channel** → Where the ticket button appears
- **Admin Roles** → Who can manage tickets
- **Ticket Categories** → Open & Closed ticket parents
- **Log Channel** → Action logs (claim, close, etc.)
- **Ticket Type** → Reason, Menu, or User Tag
- **Claim System** → Enable/disable claiming
- **Custom Menu Options** → Add up to 25 reasons via modal

---

## How to Set Up Ticker Boy (Step-by-Step)

### 1. **Invite the Bot**
[Click here to invite](https://discord.com/api/oauth2/authorize?scope=bot+applications.commands&client_id=1241112292616044695&permissions=395674250441)

> **Required Permissions**:  
> `Manage Channels`, `Manage Messages`, `Send Messages`, `Embed Links`, `Attach Files`, `Read Message History`, `Add Reactions`, `Use External Emojis`

---

### 2. **Run `/settings`**
1. Type `/settings` in any channel
2. Click **"Click me to setup !!"**
3. Follow the interactive menu:
   - Set **language**
   - Choose **panel channel**
   - Select **admin roles**
   - Pick **open/closed categories**
   - Set **log channel**
   - Add **custom ticket reasons**
   - Toggle **claim system**

---

### 3. **Send the Ticket Panel**
- After setup, the bot sends a **beautiful ticket panel** with:
  - Custom embed
  - **"Open Ticket"** button
  - **Select menu** with your reasons

> Users click → choose reason → private ticket channel created instantly!

---

### 4. **Manage Tickets**
- Staff use buttons or commands:
  - **Claim** → Locks ticket to one staff
  - **Add/Remove** → Manage access
  - **Close** → Archives + DMs transcript
  - **Reopen/Delete** → Full control

---

## Features Showcase

<details>
<summary><b>Click to View Screenshots</b></summary>

### Help Menu (Clean & Interactive)
![Help Menu](https://github.com/user-attachments/assets/b4ab4e87-4b25-41db-9fbc-8e1b8b34cbd2)
![Help Command Detail](https://github.com/user-attachments/assets/17bc7335-73e3-4663-a04d-fb72f7bd9181)

### Advanced Button & Menu System
![Ticket Panel](https://github.com/user-attachments/assets/2360b080-492d-47fa-8ac9-2c2b3ecfb7dc)

### Professional Setup Dashboard
![Settings Dashboard](https://github.com/user-attachments/assets/f52340be-7358-4f90-b7dd-1b91e7820d8b)
![Setup Flow](https://github.com/user-attachments/assets/7588b4b1-6ff4-44c1-8d0a-4bba1de5a3ed)

</details>

---

## Technical Info

| Category      | Details                                |
| ------------- | -------------------------------------- |
| **Language**  | JavaScript (Node.js)                   |
| **Framework** | Discord.js v14                         |
| **Database**  | JSON (default), SQLite, MySQL, MongoDB |
| **Hosting**   | Any VPS, Replit, Railway, Heroku, etc. |
| **Uptime**    | 99.9% with proper hosting              |

---

## Support & Community

- **Support Server**: [Persian Caesar](https://discord.gg/AfkuXgCKAQ)
- **Developer**: [Sobhan-SRZA (mr.sinre)](https://github.com/Sobhan-SRZA)
- **GitHub**: [Ticker-Boy Repository](https://github.com/Persian-Caesar/Ticker-Boy)
- **Documentation**: [Full Docs](https://github.com/Persian-Caesar/Ticker-Boy/wiki)

> **Coded with love** by **Persian Caesar**  
> **Please mention us if you need help!**

---

## Vote & Support Us!

Every vote helps us grow and improve!

[Vote on Top.gg](https://top.gg/bot/1241112292616044695/vote)  
[Join Support Server](https://discord.gg/AfkuXgCKAQ)

---

**Ticker Boy – Where Professional Support Meets Simplicity.**

---

*Tags for SEO:*  
`ticket bot`, `discord ticket system`, `support bot`, `slash commands`, `persian bot`, `dashboard`, `html transcript`, `button tickets`, `multilingual`, `mysql mongodb`, `free ticket bot`, `professional support`

---

**Ready to upgrade your server’s support?**  
[Invite Ticker Boy Now](https://discord.com/api/oauth2/authorize?scope=bot+applications.commands&client_id=1241112292616044695&permissions=395674250441)

Ticker Boy

Professional Ticket System with Buttons, Dashboard & Multi-Language Support

Programming group with complete mastery of most programming languages.

为Ticker Boy投票

你想要支持我们吗？