Discord Bot

The BGplus Discord Bot allows you to synchronize your Discord server roles with your website project, automate member management, and receive real-time logs directly in your server.

Official Bot

The official BGplus bot is used to bridge your Discord server with our hosting platform.

Invite Bot

Role Protection

Secure your transcripts by requiring specific Discord roles for viewing.

Setup Guide

1

Invite the Bot

Click the invite link above to add the BGplus bot to your server. It requires permissions to read/send messages and manage roles for full functionality.

2

Connect Your Server

Navigate to your project dashboard, go to the 'Guilds Sync' tab, and connect your server by selecting it from the list or entering its ID manually.

3

Map Your Roles

Define which Discord roles correspond to 'Admin' or 'Collaborator' roles on the BGplus website. This allows you to manage project access easily through Discord roles.

4

Configure Logging

Optionally select channels where the bot should post transcript creation logs and audit logs to keep you informed.

Key Features

Role Synchronization

With Auto-Sync enabled, BGplus automatically monitors your Discord server. When a member is assigned a mapped role in Discord, they are automatically added to your project with the corresponding permissions. If they lose the role, their access is automatically revoked.

Auto-sync runs approximately every hour. If that's not fast enough, you can always trigger a manual sync from the Guilds Sync settings.

Automated Logging

Keep your community or staff informed by piping events directly into Discord channels:

  • Transcript Logs

    Embeds containing a link and summary are posted whenever a new transcript is created.

  • Audit Logs

    A detailed stream of project actions (edits, deletions, member changes) is sent to your staff channel.

Transcript Role Protection

You can restrict access to specific transcripts so only users with certain Discord roles can view them. When a user visits a protected transcript, BGplus will:

  1. Ask the user to authorize their Discord account (if not already done).
  2. Verify if the user is a member of your server.
  3. Check if the user has at least one of the required roles.

This is ideal for staff-only transcripts or premium content for specific role holders.

FAQ

Why does the bot appear offline on Discord?

The BGplus bot is built using Discord Interactions. This means it doesn't need to maintain a constant "online" connection (WebSocket) to respond to actions or send logs. It will function perfectly even when its status appears as offline.

How do I update the bot's permissions?

If you've already invited the bot but it's missing permissions (like managing roles), you can either re-invite it using the link at the top of this page or manually grant the required permissions in your Server Settings > Roles.

Why are my roles not syncing automatically?

This is likely due to Discord's role hierarchy. For the bot to manage roles or sync members correctly, the bot's BGplus role must be above all mapped roles. You can check and update this in your Server Settings > Roles.