Knowledge Base
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Orbit API

Discord integration

Available on Starter, Growth, Premium & Enterprise plans
Available on Growth, Premium & Enterprise plans
Available on Premium & Enterprise plans
Available on the Enterprise plan

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 Reports
Discord active members by grouped channel and activity type under Reports
Discord activities timeline on member profile
Discord activities timeline on member profile

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.

  1. Attach the Discord server to your Orbit workspace
  2. Configure the Orbit integration for your Discord server

Connect a Discord server to your Orbit workspace

First, navigate to the Integrations section of your workspace settings. To get started, click on the Discord icon in the Plug & Play Integrations section.

The Plug & Play Integrations section of the Integrations page
The Plug & Play Integrations section of the Integrations page

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.

Time to connect Discord.
Time to connect Discord.

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 Authorization
Discord Authorization

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

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 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 warning
Invalid channel warning

To fix the issue and begin importing private messages, you can 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 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.

Why do I see a difference between my member count in Discord and my Discord member count on Orbit?

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.

Related articles

Still stuck?
or