Set up the Orbit Discord integration

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.

Discord active members by grouped channel and activity type under ReportsDiscord active members by grouped channel and activity type under Reports

Discord active members by grouped channel and activity type under Reports

Discord activities timeline on member profileDiscord activities timeline on member profile

Discord activities timeline on member profile

By default, Orbit will import the past 12 months of messages. If you need older historical imports, please reach out.

Integrating Discord with Orbit is a three-step process.

  1. Connect a Discord server to your Orbit user
  2. Attach the Discord server to your Orbit workspace
  3. Configure the Orbit integration for your Discord server

Connect a Discord server to your Orbit user

First, navigate to the Linked Accounts section of your Account Settings page. To get started, click “Connect Discord Integration”.

Linked accounts under Account SettingsLinked accounts under Account Settings

Linked accounts under Account Settings

“Connect Discord” will take you to Discord’s authorization screen. 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".

Discord AuthorizationDiscord Authorization

Discord Authorization

If successful, Discord will redirect you back to Orbit and you’ll see your linked Discord account.

Attach a Discord server to a Workspace

Now, navigate to the workspace where you’d like to add the integration. Click "Settings" in the side navigation, then click "Integrations" panel.

Integrations panel under Workspace SettingsIntegrations panel under Workspace Settings

Integrations panel under Workspace Settings

Click "Add integration". You’ll then see a list of available integrations to add to this workspace.

Add Discord integration to workspaceAdd Discord integration to workspace

Add Discord integration to workspace

Configure the Orbit integration for your Discord server

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.

Public channels

By default, Orbit will automatically import messages for any selected public channels.

Private 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.

Add Orbit role to any private channelsAdd Orbit role to any private channels

Add Orbit role to any private channels

Finally, now you can navigate back to Orbit and select any private channels to begin importing private messages.

Frequently Asked Questions

Why aren't my private messages showing up?

If you selected a private channel before granting the Orbit role permissions, then you will encounter the following warning icon:

Invalid channel warningInvalid channel warning

Invalid channel warning

To fix the issue and begin importing private messages, you can simply follow the instructions above, then re-select any private channels to try again.

Why aren't my server joined activities showing up?

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.

Why is the Orbit bot offline?

After installing the Orbit bot on your Discord server, you may have noticed the bot appears offline:

Orbit bot memberOrbit bot member

Orbit bot member

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.