Docs
Docs

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

  1. Go to BetaHub
  2. Choose your project
  3. Select ‘Settings / Discord Bot’ from the left menu
  4. Follow the three-step configuration process
  5. 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:

Bug report dialog
  • 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:

Automatic Bug Report

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.

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

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

  1. Use /info command
  2. Click Customize Messages
  3. Select message type
  4. Edit template with available variables

Integrations

Automatically capture Roblox usernames for bug reports:

Setup:

  1. Create server key at Blox.link Developer Dashboard
  2. 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

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

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

  1. Go to BetaHub
  2. Choose your project
  3. Select ‘Settings / Discord Bot’ from the left menu
  4. Follow the three-step configuration process
  5. 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:

Bug report dialog
  • 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:

Automatic Bug Report

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.

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

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

  1. Use /info command
  2. Click Customize Messages
  3. Select message type
  4. Edit template with available variables

Integrations

Automatically capture Roblox usernames for bug reports:

Setup:

  1. Create server key at Blox.link Developer Dashboard
  2. 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

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