Trello

Connect your Trello boards to Oplix to automatically create cards from bug reports collected through Discord or your game engine. This integration is perfect for teams that prefer Trello’s visual, board-based workflow for managing bugs and feedback.

Prerequisites

Before setting up Trello integration, make sure you have:

• Active Oplix Subscription - Navigate to Team Settings > Billing to subscribe
• Trello Account - You need access to a Trello workspace
• Trello Board Access - You should have permission to create cards on the board you want to use
• Team Admin Access - You need admin permissions in your Oplix team

How Trello Integration Works

Once connected, Oplix can automatically push bug reports from Discord or your game directly into a Trello board as cards. You choose which board and label to use, and Oplix handles the rest. Bug reports become Trello cards with all the details your team needs to investigate and fix issues!

Setting Up Trello Integration

Head to your Team Settings by clicking your profile picture in the top right, then selecting Team Settings. From there, click on the Integrations tab.

Step 1: Enable Trello Integration

Find the Trello Integration card in your integrations list. Click the toggle switch to enable it. The card will expand to show the setup form.

Step 2: Name Your Integration

You’ll see a form asking for an Integration Name. Give it a descriptive name like “Bug Board” or “Community Feedback” - something that makes it clear what this integration is for, especially if you plan to use multiple Trello boards.

Type in your chosen name and click Authenticate with Trello. You can always change this name later if you need to!

Step 3: Authenticate with Trello

Clicking the authenticate button will redirect you to Trello’s authorization page. If you’re not already logged into Trello, you’ll need to log in first.

Trello will show you a permission request screen asking if Oplix can access your Trello account. You’ll see that Oplix needs permission to read your boards and create cards. These permissions are essential for Oplix to push bug reports into your boards.

Click Allow to grant these permissions. Trello will then redirect you back to Oplix with the connection established.

Step 4: Confirm Connection

After redirecting back to Oplix, you should see your Trello integration listed as active. The card will display your integration name and the last sync time. You’re all set! Now it’s time to configure which Trello board receives your bug reports.

Configuring Bug Report Mapping

Now that Trello is connected, you need to tell Oplix which board and label to use when creating cards. This configuration happens in two places depending on where your bug reports come from:

Managing Your Trello Integration

Editing Integration Settings

Need to rename your integration or adjust settings? Click the Settings icon (gear) on your Trello integration card in Team Integrations.

You’ll see your current integration details. Click the Edit button next to the integration name to change it. Update the name and hit the checkmark to save.

Board and Label Management

The magic happens in the mapping configuration (in Discord or Game Engine settings), not in the main integration card. If you need to switch to a different board or change which label gets applied, head back to those configuration screens.

You can also create new labels on the fly during configuration. If you don’t see the label you want in the dropdown, look for a “Create New Label” option to add one directly from Oplix.

Viewing Sync Activity

The integration card shows the Last Synced timestamp, which updates whenever Oplix communicates with Trello. This includes creating new cards or checking for board updates. If bug reports are becoming Trello cards, everything is working as expected!

Removing the Integration

To disconnect Trello, click the Settings icon on the integration card and then click Delete. You’ll see a confirmation dialog warning you this action can’t be undone.

Deleting the Trello integration will:

• Stop new bug reports from creating Trello cards
• Remove the mapping configurations in Discord and Game Engine
• Keep any Trello cards that were already created (Oplix doesn’t delete your existing cards)

You can always reconnect later if needed, but you’ll have to reconfigure the board mappings again.

What Happens After Setup

Once Trello integration is configured and mapped to your bug sources:

Automatic Card Creation - Every qualifying bug report from Discord or your game instantly becomes a Trello card on the board you specified. No manual entry required!

Detailed Card Information - Each Trello card includes the full bug report: description, steps to reproduce, device information, screenshots, and more. Everything is neatly organized in the card description and attachments.

Custom Labels - Cards are automatically tagged with the label you chose during configuration, making it easy to filter and organize bugs visually on your board.

Flexible Workflows - Move cards between lists as you work through bugs. Use Trello’s drag-and-drop interface to prioritize, assign, and track progress just like you always do.

Common Issues

⚠️ Authentication Failed

If authentication with Trello fails:

• Check if pop-ups are blocked in your browser (the OAuth flow needs them)
• Make sure you’re logging in with the correct Trello account
• Try using an incognito/private browsing window to rule out cookie issues
• Verify your Trello account is active and not suspended

💡 Cards Not Being Created

If bug reports aren’t turning into Trello cards:

• Confirm you’ve completed the mapping configuration in Discord or Game Engine settings
• Check that the Trello board you selected still exists and you have access to it
• Verify the label you chose is still available on that board
• Make sure your Oplix subscription is active
• Look for error messages in the Oplix UI when bug reports are submitted

💡 Can't See My Trello Boards

If the board dropdown is empty when configuring mappings:

• Refresh the page and try again
• Verify you granted all requested permissions during OAuth
• Check that you have at least one board in your Trello workspace
• Make sure the boards aren’t archived or deleted in Trello
• Try disconnecting and reconnecting the integration
• Contact support if the problem persists

⚠️ Permission Errors

If you see permission-related errors when creating cards:

• Verify you have permission to add cards to the selected board in Trello
• Check if the board requires special permissions or is restricted
• Make sure you haven’t revoked Oplix’s access in your Trello account settings
• Try re-authenticating by deleting and re-adding the integration

💡 Labels Not Showing Up

If labels aren’t being applied to cards:

• Verify the label still exists on the selected board
• Check if you have permission to apply labels in Trello
• Try selecting a different label or creating a new one
• Re-save your mapping configuration

What’s Next?

Now that your Trello integration is set up and mapped, here are some things to explore:

Configure Discord Channels - If you haven’t already, head to Configuration > Discord to set up which Discord channels send bugs to Trello. You can create dedicated bug report channels with custom forms that capture exactly the info you need.

Link Your Game Engine - Connect your game to Oplix so players can report bugs directly from within your game. Navigate to Configuration > Game Engine to add the Oplix plugin, then map those reports to your Trello board.

Organize with Lists - In Trello, create lists like “New Bugs”, “In Progress”, “Awaiting Fix”, and “Resolved” to track the lifecycle of each bug. Cards created by Oplix will land in the default list, then you can move them as work progresses.

Set Up Jira Too - Want to use both Trello and Jira for different purposes? You can set up multiple project management integrations and route bugs to different tools based on the source or type of report.

Use Trello Automations - Combine Oplix’s automatic card creation with Trello’s Butler automation rules. You could auto-assign cards to team members, set due dates based on labels, or trigger notifications when cards move between lists.

Monitor Your Workflow - Check the Dashboard in Oplix to see analytics on how many bugs are being created and their resolution patterns. Understanding your bug flow helps optimize your development process!

The real power of Trello integration shines when you combine it with Discord and Game Engine bug reporting. Players report issues in plain language, and your team gets perfectly formatted Trello cards with all the details. It’s visual project management that actually saves time!