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:
Options:
all
- Detect bugs and support requestsbugs_only
- Only identify bug reportssupport_only
- Only support requestsoff
- 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:
Options:
optional
- Shows field, users can leave emptyloose
- Required field, no format validationstrict
- Required field with validationoff
- Hide device info field
Minimum Description Length
Set quality standards for bug descriptions:
Thread Mode
Create organized discussions for each bug report:
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:
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:
Options:
public
- Reply in the channeldm
- Send direct messagedm_with_fallback
- DM first, fallback to channelchannel
- Use dedicated notifications channel
Channel Configuration
Bug Reports Channel
Designate where bug reports are posted:
Support Channels
Add additional support-only channels:
Notifications Channel
Separate channel for bug notifications:
Releases Channel
Announce new releases automatically:
Features:
- Automatic release announcements
- @everyone notifications
- Attached release images
- Auto-updates when releases are edited
Welcome Channel
Send welcome messages to new members:
User Management
Ignored Users
Exclude specific users from automatic detection:
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
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