Discord Bot

BetaHub’s Discord bot transforms your community server into a powerful bug reporting and engagement platform.

Overview

BetaHub assigns a dedicated Discord bot for each project that can:

Collect bug reports using the /report command
Automatically capture bug reports from conversations
Broadcast new release announcements
Facilitate community interactions about bug reports
Request additional information from users

The bot proactively engages users through direct messages and threads, seeking further details about bugs and requesting screenshots, videos, or log files.

Quick Setup

Go to BetaHub
Choose your project
Select ‘Settings / Discord Bot’ from the left menu
Follow the three-step configuration process
Use /info to verify setup and /help for command list

Required Permissions

Basic Requirements (Always Needed)

View Channels - Browse channels and identify bug report channel
Send Messages - Post bug reports and messages
Embed Links - Provide visual information to reporters

Optional Features

Send Messages in Threads - Create and manage discussion threads
Create Public/Private Threads - Organize bug report discussions
Attach Files - Include screenshots in release announcements
Mention Everyone - Notify about new releases

Use /info to verify all required permissions. The bot will indicate missing permissions for enabled features.

Bug Reporting Methods

1. `/report` Command

The primary method for intentional bug reporting:

Opens dialog for detailed bug information
Posts formatted report in designated channel
Provides link back to BetaHub for editing
Supports custom field validation

2. Listen Mode (AI-Powered)

Automatically detects bug reports in conversations:

Configuration:

/set listen_mode bugs_only

/set bugs_channel #your-channel

Options:

all - Detect bugs and support requests
bugs_only - Only identify bug reports
support_only - Only support requests
off - Disable automatic detection

3. Mention-Based Reporting

Users can mention the bot with bug details in the same message for quick reporting.

4. Report Button

Pin a “Report a Bug” button to channels for easy access.

Suggestion Submission Methods

BetaHub’s Discord bot also enables community members to submit feature suggestions and improvement ideas directly through Discord.

1. `/suggest` Command

The primary method for submitting feature suggestions:

/suggest

Opens modal dialog for detailed suggestion input
Validates minimum description length requirements
Posts suggestion directly to your BetaHub project
Provides confirmation with BetaHub link for tracking

2. Suggestion Buttons

Administrators can deploy interactive “Suggest a Feature” buttons for easy community access:

/post_suggestion_button

Setup Requirements:

Manage Channels permission required
Creates persistent button for user interactions
Customizable button text and accompanying message

Alternative Setup: Use the /info command and click “Post ‘Suggest a Feature’ Message here” button for quick deployment.

3. Message Customization

Customize the suggestion experience with three key templates:

Suggestion Button Message:

Customize the text displayed with suggestion buttons
Default: “📝 Have ideas for improving our game? Click the button below to suggest a new feature or improvement!”

Dialog Title:

Personalize the suggestion submission modal title
Default: “Feature Suggestion”

Submission Confirmation:

Modify the success message after suggestion submission
Includes suggestion details and BetaHub tracking URL

Access customization through /info → “Customize Messages”.

Advanced Configuration

Device Information Field

Control device info collection in bug reports:

/set custom_field device_info:optional

Options:

optional - Shows field, users can leave empty
loose - Required field, no format validation
strict - Required field with validation
off - Hide device info field

Minimum Description Length

Set quality standards for bug descriptions:

/set min_description_length 70

Suggestion Length Requirements

Control the quality of feature suggestions by setting minimum length requirements:

/set min_suggestion_length 70

Benefits:

Ensures detailed, meaningful suggestions
Reduces low-quality submissions
Improves developer understanding of requested features
Default setting: 70 characters minimum

User Experience:

Users receive immediate feedback if description is too short
Clear guidance on minimum requirements
Validation occurs before BetaHub submission

Thread Mode

Create organized discussions for each bug report:

/set thread_mode true

Benefits:

Dedicated space for each bug discussion
File uploads and additional information
Reduced channel clutter
Private or public thread options

Thread Participants

Auto-add team members to bug report threads:

/set thread_participants +@developer1 @developer2

Management:

Add users: +@user1 @user2
Remove users: -@user1
List participants: list
Clear all: clear

Notification Methods

Control how users are notified about their bug reports:

/set listen_mode_notification_method dm_with_fallback

Options:

public - Reply in the channel
dm - Send direct message
dm_with_fallback - DM first, fallback to channel
channel - Use dedicated notifications channel

Channel Configuration

Bug Reports Channel

Designate where bug reports are posted:

/set bugs_channel #bugs

Support Channels

Add additional support-only channels:

/set support_channels +#support -#general

Notifications Channel

Separate channel for bug notifications:

/set bugs_notifications_channel #bug-alerts

Releases Channel

Announce new releases automatically:

/set releases_channel true

Features:

Automatic release announcements
@everyone notifications
Attached release images
Auto-updates when releases are edited

Welcome Channel

Send welcome messages to new members:

/set welcome_channel true

User Management

Ignored Users

Exclude specific users from automatic detection:

/set ignored_users +@bot1 @spammer

Useful for:

Excluding other bots
Filtering out problematic users
Preventing false positives

Permissions

Only users with Manage Channels permission or server owners can:

Execute /set and /info commands
Modify bot configuration
Access sensitive settings

Message Customization

Available Variables

Customize bot messages using template variables:

User Variables:

`` - @username mention
`` - Discord username

Bug Report Variables:

`` - Bug report title
`` - Full description
`` - Priority level
`` - Link to BetaHub report

Other Variables:

`` - Thread mode status
`` - Duplicate bug link

Customization Process

Use /info command
Click Customize Messages
Select message type
Edit template with available variables

Integrations

Blox.link Integration

Automatically capture Roblox usernames for bug reports:

Setup:

Create server key at Blox.link Developer Dashboard
Configure in Discord:
/set bloxlink_key YOUR_SERVER_KEY

Requirements:

Blox.link account
BetaHub Discord Bot installed
Valid server key

Best Practices

Channel Management

Enable Slow Mode on bug channels to encourage detailed reports
Use clear channel descriptions explaining reporting procedures
Pin instructions for using the bot effectively

Community Guidelines

Set clear expectations for bug report quality
Provide examples of good bug reports
Moderate discussions to stay constructive

Performance Optimization

Configure ignored users to reduce noise
Use thread mode to organize discussions
Set appropriate minimum description lengths

Troubleshooting

Common Issues

Bot Not Responding:

Check basic permissions (Send Messages, View Channels)
Verify bot is online and properly invited
Ensure Discord slash commands are enabled

Can’t Create Threads:

Verify thread-related permissions
Check channel-specific permissions
Confirm bot role hierarchy

Missing Permissions:

Run /info to check current permissions
Review role assignments in server settings
Contact server admin for permission updates

Suggestion Issues:

Project Token Errors:

“Project not found” - Verify project token is correct using /set project <token>
“Project not set” - Configure project token before using suggestion features

Suggestion Button Problems:

Button not responding - Check bot permissions in the channel
Cannot post button - Ensure Manage Channels permission for admin commands

Validation Failures:

“Description too short” - Check min_suggestion_length setting (default: 70 characters)
User guidance unclear - Review minimum length requirements in project settings

Submission Failures:

BetaHub API errors - Verify project exists and token is valid
“Processing failed” - Check network connectivity and BetaHub service status

Getting Help

If you encounter issues:

Use /info to diagnose permission problems
Check the FAQ for common solutions
Join our Discord server for support

Next Steps

Advanced Features - Explore AI-powered capabilities
Integrations - Connect with external tools
Core Features - Learn about the platform foundation

Discord Bot

BetaHub’s Discord bot transforms your community server into a powerful bug reporting and engagement platform.

Overview

BetaHub assigns a dedicated Discord bot for each project that can:

Collect bug reports using the /report command
Automatically capture bug reports from conversations
Broadcast new release announcements
Facilitate community interactions about bug reports
Request additional information from users

The bot proactively engages users through direct messages and threads, seeking further details about bugs and requesting screenshots, videos, or log files.

Quick Setup

Go to BetaHub
Choose your project
Select ‘Settings / Discord Bot’ from the left menu
Follow the three-step configuration process
Use /info to verify setup and /help for command list