Skip to main content

Discord Integration

Self Hosted
Not available in WorkAdventure Self Hosted
 Free
Available in WorkAdventure SaaS Free Plan
 Premium
Available in WorkAdventure SaaS Premium Plan

Discover the Discord integration for WorkAdventure, allowing you to authorize people from your server to join your virtual office and allowing them to synchronize their message between Discord and WorkAdventure.

Key Features​

  • Message synchronization: Synchronize your Discord messages with WorkAdventure.
  • White-listing Discord members: Authorize members from your Discord server to join your virtual office.
  • Login with Discord: Allow your users to log in with their Discord account.

Prerequisites​

  • A WorkAdventure World.
  • A Discord account.

Message synchronization​

By synchronizing your Discord messages with WorkAdventure, you will be able to see and send messages from WorkAdventure to a Discord channel.

Enable the Discord messages bridging​

Go to WorkAdventure: Enter in your map.​

  • In the menu find the Plugins & tools section
  • Next click on Discover Discord Integration it should open the configuration popup.
    info

    If you don't see the Discover Discord Integration button, you may need to enable the Discord integration in the WorkAdventure back-office. Or ask your administrator to do it.

  • Now follow the instructions to configure the Discord integration.
    • You can log in by scanning the QR Code with your Discord app.
      info

      Qr code are time-limited so you may need to regenerate it if it's expired.

info

Sometimes your account is protected by captcha. In this case, you will need to log in with your Discord token. How to get my discord token

How to Get your Discord API token​

  • Go to your web browser and open your Discord account.
  • Open the browser's developer tools.
  • Go to the network tab.
  • In the filter, type api.
  • Refresh the page.
  • Search for a request like @me
    • Copy the authorization header value (this is your Discord token).

Syncronize your Discord messages​

After being connected, a panel with all your Discord servers will appear. You can now select the server you want to synchronize with WorkAdventure. When you synchronize a server, each server's channel will become a room in the WorkAdventure chat.

info

When you synchronize a server, your last direct messages will also be synchronized.

🥳 Now you can send messages from WorkAdventure to Discord and vice versa 🥳.

Technical details

Note: Technically, the message synchronization is done by the Mautrix Discord Bridge The bridge creates a bot user in the Synapse server. This bot accepts messages from you to configure the bridge. So under the hood we send message to the bot for you. You can quit the bot room after the configuration is done.

Disable the possibility to synchronize messages​

As an administrator, you can disable the possibility to synchronize messages between Discord and WorkAdventure.

Details

This will just disable the graphic interface between the created bot and the user. Users will still be able to send message to the bot to configure the bridge.

  1. Open the WorkAdventure dashboard authentication page
  2. Update World Settings:
    • In the world click on edit button.
    • In Chat & User List you will find a switch Enable Discord bridge. Switch it off.

Discord Mandatory login​

The mandatory login with Discord allows you to force your users to log in with their Discord account. You can also specify a Discord server id that people must be part of to access the world. How to get your Discord server id

  1. Open the WorkAdventure dashboard authentication page
  2. Go to authentication section:
    • Activate the Mandatory authentication switch.
    • Disable all Social login except Discord.
    • Finally activate the Allow Discord login switch and fill the Discord server id field.

With these settings only people from the specified server will be able to access the world 😎.

Demo​

Find your Discord server id​

To find your Discord server id, you need to enable the developer mode in Discord.

  1. Open Discord.
  2. Go to User settings > Advanced > Developer mode.
  3. Right-click on your server icon and click on Copy ID.