Discord Integration

Connect Oplix with your Discord server to automatically collect feedback from your community and streamline your feedback management workflow.

Features

  • Automatic Feedback Collection: Convert Discord messages into structured feedback
  • AI-Powered Categorization: Automatically categorize feedback by type and severity
  • Real-time Notifications: Get notified when important feedback is submitted
  • Community Engagement: Respond to feedback directly in Discord

Prerequisites

  • Discord server with admin permissions
  • Oplix account with an active project
  • Discord bot permissions (if using custom bot)

Setup Guide

Step 1: Enable Discord Integration

  1. Go to your Oplix dashboard
  2. Navigate to Integrations → Discord
  3. Click “Connect Discord Server”
  4. Authorize Oplix to access your Discord server

Step 2: Configure Feedback Channels

Select which Discord channels should be monitored for feedback:

# Example configuration
feedback_channels:
  - "#feedback"
  - "#bug-reports"
  - "#suggestions"
  - "#general" # Optional: monitor general chat

Step 3: Set Up Feedback Commands

Configure Discord slash commands for structured feedback submission:

/feedback bug "Game crashes when opening inventory"
/feedback suggestion "Add dark mode to settings"
/feedback praise "Love the new character animations!"

Step 4: Configure AI Processing

Enable AI-powered feedback analysis:

  1. Auto-categorization: Automatically sort feedback by type
  2. Sentiment analysis: Detect positive/negative feedback
  3. Priority scoring: Identify critical issues
  4. Duplicate detection: Merge similar feedback

Discord Bot Commands

For Players

/feedback <type> <message>
/bug <description>
/suggestion <idea>
/praise <compliment>

For Moderators

/feedback-stats
/feedback-export
/feedback-moderate <id> <action>

For Admins

/oplix-config
/oplix-sync
/oplix-webhook <url>

Webhook Configuration

Set up webhooks to receive real-time notifications:

// Example webhook payload
{
  "event": "feedback_submitted",
  "data": {
    "id": "fb_123456",
    "type": "bug",
    "message": "Game crashes when opening inventory",
    "author": {
      "discord_id": "123456789",
      "username": "PlayerName#1234"
    },
    "channel": "#bug-reports",
    "timestamp": "2025-01-15T10:30:00Z"
  }
}

Advanced Features

Custom Bot Integration

For advanced users, integrate with your existing Discord bot:

const { Client, GatewayIntentBits } = require('discord.js');
const { Oplix } = require('@oplix/js-sdk');

const client = new Client({
  intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages]
});

const oplix = new Oplix({
  apiKey: process.env.OPLIX_API_KEY,
  projectId: process.env.OPLIX_PROJECT_ID
});

client.on('messageCreate', async (message) => {
  if (message.channel.name === 'feedback') {
    await oplix.submitFeedback({
      type: 'general',
      message: message.content,
      source: 'discord',
      metadata: {
        author: message.author.username,
        channel: message.channel.name,
        guild: message.guild.name
      }
    });
  }
});

Role-Based Permissions

Configure different permissions for different Discord roles:

permissions:
  admin:
    - view_all_feedback
    - moderate_feedback
    - export_data
  moderator:
    - view_feedback
    - moderate_feedback
  member:
    - submit_feedback
    - view_own_feedback

Analytics Integration

Track Discord engagement metrics:

  • Feedback volume by channel and time
  • User engagement and participation rates
  • Response times to community feedback
  • Sentiment trends over time

Troubleshooting

Bot Not Responding

  1. Check bot permissions in Discord
  2. Verify bot is online and connected
  3. Ensure Oplix integration is enabled
  4. Check API key configuration

Feedback Not Appearing

  1. Verify channel configuration
  2. Check webhook endpoints
  3. Review API rate limits
  4. Confirm message format

Permission Issues

  1. Ensure bot has required permissions
  2. Check role hierarchy
  3. Verify channel permissions
  4. Review server settings

Best Practices

  • Clear Guidelines: Provide feedback guidelines in your Discord
  • Moderation: Set up proper moderation for feedback channels
  • Response Protocol: Establish how you’ll respond to feedback
  • Regular Reviews: Periodically review and update integration settings

Support

Need help with Discord integration?