Discord Bot Integration

BetaHub enhances project management by assigning a dedicated Discord bot for each project. This bot is capable of:

  • Collecting bug reports from users by using the /report command.
  • Automatically capturing bug reports, including screenshots, video clips, and log files based on the conversation.
  • Broadcasting announcements of new releases.
  • Facilitating interactions with your community regarding their previously reported bugs.
  • Asking the user for additional information about a bug report (by using Ask For… buttons on the bug report page).

Our bots can proactively engage with users through direct messages, threads, seeking further details about a bug, requesting screenshots, videos, or log files. This process can be manually triggered by the developer or automated through our AI.

Bug reports from users can either be intentional, via a command, or automatic, identified by our AI through conversation analysis.

Automatic Bug Report

Step-by-Step Setup Guide

To deploy a Discord bot for your project, execute the following:

  1. Go to BetaHub.
  2. Choose your project.
  3. Select ‘Settings / Discord Bot’ from the left-hand menu.
  4. Verify your setup using /info command. Check the help using /help command.

You will be guided through a three-step process to configure your bot for the selected project. Complete these steps to get your bot operational swiftly.

Required Permissions

The bot requires the following permissions to function correctly:

  • View Channels - To browse your channels list to identify the bug report channel.
  • Send Messages - To post bug reports and other messages.
  • Send Messages in Threads - To create threads for bug reports.
  • Create Public Threads - To create public threads for bug reports.
  • Create Private Threads - To create private threads for bug reports.
  • Embed Links - To embed links in messages to provide visual information to the bug reporters.
  • Attach Files - To attach screenshots to new releases announcements.
  • Mention Everyone - To notify everyone about new releases.

If you’re just inviting the bot, the invite link provided in the bot setup will automatically grant the bot the necessary permissions. If you’re setting up the bot manually, or if you have it already on your server for quite a while, make sure to grant the bot the required permissions.


By default, the bot will react to /report command from any channel. This will trigger the bot to pop up a dialog box for the user to fill in the bug report details. The bot will then post the bug report in the designated bug report channel.

Bug report dialog

Make sure that your discord users have the permissions to execute slash commands. You can test it by typing / in the chat and see if the bot responds with a list of commands.

Listen Mode

  • Default: Disabled
  • Command: /set listen_mode true|false

When enabled, the bot will listen for bug reports in selected channels. The bot will still respond to the /report command, but it will also listen for messages using Claude’s AI to identify bug reports.

To select the list of channels, please execute /set bugs_channel true in the desired channels.

It’s highly recommended to enable the Slow Mode on channels with bugs. This will encourage the users to provide a more detailed bug report, and attach any necessary files into a single message, which will render the bug report more readable for the bot itself.

Thread Mode

  • Default: Disabled
  • Command: /set thread_mode true|false|public|private

When enabled, the bot will create a new thread for each bug report. This will allow users to upload additional files and communicate with the bot without cluttering the main channel. Any notifications or messages from the bot will be sent directly to the user’s thread, if these are related to a specific bug report.

By default, the thread mode will be creating private threads and attach them to the first channel identified as a bug reported channel or set up using /set bugs_channel true. To change threads from private to public, use /set thread_mode public. Check /info to verify the current thread mode settings.

The Releases Channel

  • Default: Disabled
  • Command: /set releases_channel true

When enabled, the bot will post new releases announcements in the selected channel. The bot will notify everyone about the new release and attach the release notes to the message. You can create a new release from your BetaHub project’s page. Editing any release will automatically update the message in the Discord channel as well.

The Welcome Channel

  • Default: Disabled
  • Command: /set welcome_channel true

When enabled, the bot will send a welcome message to the selected channel. The message will contain a link to the project’s page on BetaHub.

AI-Driven Bug Submissions

How the AI Operates

Upon submission, the AI scrutinizes the bug report, assigning it a relevant subject and priority. It tags the report appropriately and searches for similar existing reports within the project. If a match is found, the new report is marked as a duplicate, raising the original report’s Heat value. This mechanism ensures testers don’t feel disheartened by repetitive reports, while developers gain a clearer picture of the bug’s prevalence.

Customizing AI Settings

Tailor your project’s bug submission verification in the ‘Settings / General’ section. Choose the Bug Description Validation Level:

  • AI Check - The AI evaluates the report and alerts the user if the description is invalid or incomplete.
  • Minimum Character Limit - Ensures the description is at least 50 characters long.
  • No Check - Omits the validation process.

Multimedia Submission and Annotation

Users can attach and mark up multimedia files within their bug reports, providing developers with a clear depiction of the issues. This interactive feature allows users to convey bugs more precisely.

Supported Formats

  • Screenshots - PNG, JPG, JPEG
  • Videos - MP4, MOV, WEBM, AVI, FLV, WMV, MKV, MPG, MPEG, M4V, 3GP, 3G2
  • Log files - TXT, LOG