Server & Channels

Connect your Discord server to Oplix to start collecting and managing bug reports from your community.

Requirements

Before setting up Discord integration, make sure you have:

Discord Server Admin Access - You must have administrator permissions on the Discord server you want to connect
Active Oplix Subscription - Navigate to Team Billing to subscribe if you haven’t already
Oplix Discord Bot - The bot must be invited to your server (instructions below)

Invite the Oplix Bot to Your Discord Server

Head over to the Discord section under Configuration in your Oplix dashboard. On the General tab, you’ll see a section called “How To Setup Servers” - expand it and click the Invite Oplix Discord Bot button.

This will take you to Discord’s authorization page where you can select which server to add the bot to. Choose your server from the dropdown and grant the requested permissions. The bot needs these to create private threads for bug reports, read and send messages, and manage your channels.

💡 Why these permissions?

The bot uses threads to keep bug reports organized, reads messages in designated channels for analysis, and sends interactive buttons and embeds to guide users through the reporting process.

Generate Your API Key

Your API key is what links your Discord server to your Oplix team account. Think of it as a secure password that proves your Discord bot is authorized to send data to your Oplix dashboard.

On the same General tab, you’ll find a card labeled “Your Discord API Key”. Click Generate API Key and confirm (if you’ve generated one before, this will invalidate the old one). Once generated, click the key field to copy it - you’ll need this in the next step. There’s an eye icon if you want to reveal or hide the full key.

⚠️ Keep Your API Key Secure

Treat this like a password - never share it publicly. If it’s compromised, generate a new one immediately and re-run the setup command in Discord.

Connect Your Discord Server

Now for the fun part - linking everything together! Open your Discord server and in any channel, type /config setup_server. The bot will prompt you for your API key. Paste in the key you just copied from Step 2 and hit enter.

The bot will verify your API key, register your server with Oplix, and confirm the connection was successful. Within a few seconds, you should see your server appear in the “Server Status” table back in your Oplix dashboard with a “Completed” status.

✨ Not seeing your server?

Give it a few seconds to sync, then refresh the page. If it’s still not showing, double-check you copied the complete API key without any extra spaces.

Configure Bug Report Channels

Time to decide which channels will collect bug reports. Back in Discord, type /config_manage_channels and the bot will show you a menu with all your server’s channels.

For each channel you want to set up, select it from the dropdown and choose its purpose:

Bug Report channels become special - they’ll be locked down with a single “Report a Bug” button. When someone clicks it, the bot creates a private thread just for them and walks them through your custom questions. This keeps your bug reports organized and your channel clean.

Community Analysis channels work differently - they stay completely normal. Your members chat as usual, but the bot quietly listens and analyzes messages for sentiment and common issues. Users won’t even know it’s there.

✨ Recommended Setup

Most teams create a dedicated #bug-reports channel for the Bug Report purpose, and optionally enable Community Analysis on general discussion channels like #general or #gameplay-chat to catch organic feedback.

Once configured, your channels will appear in the Channels tab in your Oplix dashboard.

Set Up Bug Report Questions

Now for the important part - deciding what information you want to collect from bug reports.

How the system works: When a player clicks the “Report a Bug” button in your Discord server, the bot opens a private thread and first asks them to select a Category - like “Network & Connectivity”, “Save & Load Issues”, “Combat Bugs”, etc. Based on their selection, the bot then asks the specific questions you’ve configured for that category.

This conversational, category-based approach is crucial because different issues require different information. Network problems need different details than UI bugs or performance issues. By creating category-specific question templates, you get more enhanced, reproducible reports that give your team exactly what they need to investigate and fix issues.

You have two ways to set up these templates:

Option 1: Start with Pre-Made Templates

Quick start option - head to the Templates tab in Discord Configuration and browse our pre-built templates. We’ve created ready-to-use category templates with curated questions for common bug types.

Simply select a template, preview the questions and category it includes, choose which channel to apply it to, and click Add to Channel. You can use these as-is or edit them later to match your specific needs.

Option 2: Build Custom Templates from Scratch

For complete control, go to the Questions tab and click Add Question to build your own category-based templates from the ground up.

When creating your questions:

Question Text is what users see in the Discord thread. Keep it conversational and clear - “What were you doing when the bug happened?” works better than “Describe reproduction steps”.
Helper Hint appears below your question to guide users. Something like “Include your operating system and game version” helps people provide better information.
Category Types are your issue groupings - create categories like “Network & Connectivity”, “Graphics & Performance”, “Save & Load”, etc. Each category gets its own tailored set of questions.
Exclude from AI checkbox is useful for sensitive questions. If you ask for email addresses or personal info, check this so it’s not included in AI analysis.

This approach gives you maximum flexibility to create the exact question flow your team needs for each type of bug.

✨ Keep it simple

5-7 well-crafted questions typically work best. Ask for the essentials: what happened, what they expected, what platform they’re on, and if they can reproduce it. You can always refine questions later based on the feedback you’re getting.

You can reorder questions anytime by dragging and dropping them in the Questions tab. Whatever’s at the top gets asked first.

Test Your Setup

Time to make sure everything’s working! Go to your Bug Report channel in Discord and click the “Report a Bug” button. The bot should create a private thread and start asking your configured questions. Go ahead and submit a test report - pretend you found a bug.

Now hop back to your Oplix dashboard and check the Bug Reports section. Within a few seconds, your test report should appear with all the answers you provided. If you see it there, congratulations - you’re all set up!

Managing Your Discord Integration

View Connected Channels

The Channels tab shows all your configured channels at a glance - their IDs, names, types, and purposes. If you need to remove the Oplix integration from a channel (don’t worry, this won’t delete your actual Discord channel), just click the three-dot menu (⋮) and select Delete.

Editing Questions

Questions aren’t set in stone. Head to the Questions tab, select your channel, and click on any category to expand it. From there you can edit questions, add new ones, or remove ones that aren’t working. Changes apply immediately to any new bug reports that come in.

Removing a Channel Integration

Changed your mind about a channel? Go to the Channels tab, find the channel in the table, click the three-dot menu, and select Delete. This just removes the Oplix integration - your Discord channel stays exactly as it was.

Common Issues

⚠️ Bot not responding to commands

Verify the bot has proper permissions in your Discord server
Check your Oplix subscription is active
Ensure the API key was entered correctly

💡 Server not showing in dashboard

Wait a few seconds for real-time sync
Refresh the page
Try running /config setup_server again

💡 Questions not appearing for users

Make sure you’ve added questions to the specific channel
Verify the channel type is set to “Bug Report”
Check that questions are enabled (not excluded)

⚠️ Need to regenerate API key

Generate a new key in the Oplix dashboard
Run /config setup_server again in Discord with the new key
All existing channels remain connected automatically

What’s Next?

Now that your Discord integration is humming along, here are some things you might want to explore:

Connect your project management tools - Head to the Integrations tab to link Jira or Trello. Bug reports can automatically create tickets in your workflow, saving you tons of manual work.

Fine-tune your questions - As reports come in, you’ll see what information you’re getting and what’s missing. Don’t be afraid to adjust your questions based on real feedback.

Monitor your dashboard - Make it a habit to check the Bug Reports section regularly. You’ll start to see patterns in what users are reporting, which can help you prioritize fixes.

Explore AI analysis - The AI can analyze responses to spot trends and sentiment. Configure which questions should be included in analysis to get the most useful insights.

✨ Need Help?

Stuck on something? Contact Oplix support through the Help menu in your dashboard. We’re here to help!