This guide will walk you through setting up the Discord integration.
The Orbit Discord Integration will automatically ingest messages in your Discord server. We’ll create a member profile for every participant and an activity for every message, which allow you to see when a member joined your server, which categories and channels they are active in, and the specific messages sent.
By default, Orbit will import the last 12 months of messages with a limit of up to 100,000. If you need older historical imports, please reach out.
Integrating Discord with Orbit is a two-step process.
First, navigate to the Integrations section of your workspace settings. To get started, click on the Discord icon in the Plug & Play Integrations section.
A modal like the one shown below will appear, click on Connect Discord to start the process. You will be redirected to the Discord authorization page.
Make sure that the correct Discord server is selected in the drop-down, then click "Continue". The app asks for read-only permissions. Finally, click "Authorize".
If successful, Discord will redirect you back to Orbit and you’ll see your linked Discord account, ready for configuration.
Finally, you must configure the Orbit integration for your Discord server by selecting any channels you would like to import, as well as applying permissions when applicable.
By default, Orbit will automatically import messages for any selected public channels.
Orbit can also automatically import messages for any selected private channels, however you must first update the channel/category permissions in your Discord server.
To grant permission, apply the Orbit role to any private channels and/or categories.
Finally, now you can navigate back to Orbit and select any private channels to begin importing private messages.
If you selected a private channel before granting the Orbit role permissions, then you will encounter the following warning icon:
To fix the issue and begin importing private messages, you can follow the instructions above, then re-select any private channels to try again.
If you are not seeing any activities created when a member joins your server, then you must enable the "New Member Messages" option in your Discord server settings.
After installing the Orbit bot on your Discord server, you may have noticed the bot appears offline:
This does not mean the installation was unsuccessful, messages will continue to be imported. The Orbit bot permissions are read-only. As a result, the bot does not need to appear online or interact with members in your Discord server.
Orbit’s historical import will initially import active members of your Discord server, which are members who have sent a message within the past year.
During the historical Discord import, Orbit will create new members and activities for any messages sent within the past year, but it will not add a member into Orbit if the member has been inactive in the Discord server. 'Server channel join’ activities will only be imported to Orbit after the Discord integration has been connected and is listening for these activities.