Discord Ticket Management Bot

A Discord bot for creating and managing project update tickets with integration to devanturas.net projects.

Features

• ✅ Create tickets with slash commands
• 📋 Track project updates from devanturas.net
• 🔄 Update ticket status (Pending, In Progress, Completed, Cancelled)
• 📦 Automatic archiving of completed tickets
• 🎫 List and view all active tickets
• 📊 Beautiful embed messages with ticket information

Setup Instructions

1. Create a Discord Bot

1. Go to Discord Developer Portal
2. Click "New Application" and give it a name
3. Go to the "Bot" section
4. Click "Add Bot"
5. Under "Privileged Gateway Intents", enable:
   • MESSAGE CONTENT INTENT
   • SERVER MEMBERS INTENT
6. Click "Reset Token" and copy your bot token

2. Install Dependencies

pip install -r requirements.txt

3. Configure the Bot

1. Copy .env.example to .env:

   copy .env.example .env
   

2. Edit .env and add your bot token:

   DISCORD_TOKEN=your_bot_token_here
   

4. Invite the Bot to Your Server

1. In the Discord Developer Portal, go to "OAuth2" > "URL Generator"
2. Select scopes:
   • bot
   • applications.commands
3. Select bot permissions:
   • Send Messages
   • Embed Links
   • Read Message History
   • Manage Messages
4. Copy the generated URL and open it in your browser
5. Select your server and authorize

5. Run the Bot

python bot.py

6. Configure Channels

In Discord, use the /setup command to configure the channels:

/setup active_channel:#active-tickets archive_channel:#archived-tickets

Commands

/ticket - Create a New Ticket

Create a new project update ticket.

Parameters:

• message_id: Discord message ID to reference
• project_name: Project name from devanturas.net/versions
• title: Brief description of the update

Example:

/ticket message_id:123456789 project_name:MyProject title:Version 2.0 Update

/status - Update Ticket Status

Update the status of an existing ticket.

Parameters:

• ticket_id: The ticket ID (e.g., TICKET-0001)
• new_status: Choose from:
  • ⏳ Pending
  • 🔄 In Progress
  • ✅ Completed
  • ❌ Cancelled

Example:

/status ticket_id:TICKET-0001 new_status:In Progress

Note: When a ticket is marked as "Completed", it will automatically be moved to the archive channel.

/list - View Active Tickets

Lists all currently active (non-archived) tickets.

Example:

/list

/info - Get Ticket Details

Get detailed information about a specific ticket.

Parameters:

• ticket_id: The ticket ID to view

Example:

/info ticket_id:TICKET-0001

/setup - Configure Bot Channels

Configure the active and archive channels for tickets (Admin only).

Parameters:

• active_channel: Channel for active tickets
• archive_channel: Channel for completed tickets

Example:

/setup active_channel:#active-tickets archive_channel:#archived-tickets

Ticket Workflow

1. Create: Use /ticket to create a new ticket in the active channel
2. Update: Use /status to update the ticket status as you work
3. Complete: Mark ticket as "Completed" to automatically archive it
4. Archive: Completed tickets are moved to the archive channel

Project Integration

The bot integrates with devanturas.net:

• All projects: https://devanturas.net/versions
• Specific project: https://devanturas.net/projects/{project_name}

Each ticket embed includes direct links to the project pages.

Data Storage

Currently, tickets are stored in memory. For production use, consider implementing:

• Database storage (SQLite, PostgreSQL, etc.)
• Persistent ticket data between restarts
• Backup and recovery mechanisms

Docker Support

Build and run with Docker:

# Build the image
docker build -t discord-ticket-bot .

# Run the container
docker run -d --name ticket-bot --env-file .env discord-ticket-bot

Troubleshooting

Bot doesn't respond to commands

• Make sure the bot is online
• Check that you've enabled the correct intents in the Developer Portal
• Verify the bot has permissions in your server

Commands don't appear

• Wait a few minutes for commands to sync
• Try kicking and re-inviting the bot
• Check the bot logs for sync errors

Tickets aren't archiving

• Verify you've run /setup to configure channels
• Check that the bot has permissions in both channels

License

MIT License - feel free to modify and use for your projects!

Author

Created for SimolZimol