📙

Discourse integration

Documentation

‣
Getting Started
📙
What is Orbit?
📙
Understanding the Orbit Model
📙
Orbit Glossary
‣
Workspaces
📙
Create an Orbit workspace
📙
Invite a teammate
📙
Enable SSO (Single Sign-On)
📙
Demo mode
‣
Programs
📙
Intro to Programs
📙
Create a Program
📙
Import a CSV of Applications
📙
Collect applications via a Web Form
📙
Connect third-party forms to receive new submissions to Program
📙
Review and Manage Applications
📙
Onboard Program Members
📙
Collect Contributions from your Members
📙
Manage Program Settings
‣
Members
📙
Intro to members
📙
View an individual member
📙
Preview a member
📙
Explore members via the members tab
📙
Add a member
📙
Edit a member
📙
Merge duplicate members
📙
Delete a member
📙
Add a tag to a member
📙
Add, edit, and delete notes on a member
📙
Add an activity to a member
📙
Mark profile as a teammate
📙
Send member to a webhook
‣
Activities
📙
Create an activity type
📙
Intro to activities
‣
Organizations
📙
Intro to organizations
📙
View an individual organization
📙
Identify an organization as a customer
‣
Reports
📙
Create a custom dashboard
📙
Drill down into reports
📙
Quickly build an activities chart
📙
Understanding sentiment analysis
‣
Automations
📙
Automations [deprecated]
📙
Webhooks
📙
Set up a manual webhook
📙
Workflows
📙
Slack notifications
📙
Set up an automated webhook
‣
Productivity
📙
Member lists
📙
Tags
📙
Manage tags
📙
Create a saved view
📙
Share a saved view
📙
CSV import for members and activities
📙
Using filters on the members tab
📙
Using filters on the activities and reports tabs
📙
Keyboard shortcuts
📙
Search
‣
Integrations
📙
All possible data integrations with Orbit
📙
DEV integration
📙
Discord integration
📙
Discourse integration
📙
GitHub integration
📙
HubSpot integration
📙
inSided integration
📙
LinkedIn integration
📙
Reddit integration
📙
Salesforce integration
📙
Slack integration
📙
Stack Overflow integration
📙
Twitter integration
📙
Twitter keywords integration
📙
YouTube integration
📙
Zapier integration
📙
Twitter DMs integration
‣
Tools
📙
Orbit API
📙
Export workspace data
📙
Delete workspace data
📙
API tokens
📙
Community Search
📙
Orbit Browser Extension
📙
Embeds
📙
Slack App
📙
Stripe Dashboard application
‣
FAQ
📙
How are historic Discord imports handled after initial set up?
📙
How can I filter members to only see those with notes added?
📙
How does member enrichment work?
📙
Is test data available to try in Orbit?
📙
What activities are tracked by each integration?
📙
What can I do if I imported a CSV with incorrect column headers?
📙
What's the difference between Activities and Tags?
📙
Why am I no longer designated as a teammate?
📙
Why are there differences between member counts on Orbit and Discord?
📙
Why can't I see the Plug & Play integrations?
📙
Why is my CSV file not importing?
📙
Will uninstalling an integration remove activities from Orbit?
📙
How is the new members table different from the old members table?

Discourse integration

The Orbit Discourse integration allows you to connect your Discourse instance to Orbit. The integration will automatically create an Activity for any new topic, new reply, or user account creation, and it will save that Activity to an existing member's profile. If the post is from a person not already associated with your workspace, Orbit will create a new member.

The table below summarizes what is included in this integration:

Activities
- New topic created - New post created - New member account created
Historical Import
- Up to 100,000 posts or 365 days of posts retrospectively from the date of connecting the integration to Orbit
Does not track or import
- Post likes - Badge grants

Initially, Orbit will import the last 12 months of activity with a limit of up to 100,000. If you'd like more history, just let us know.

Connect your Discourse account

If you're setting up a new workspace, you'll see the Connect Discourse button during setup.

If you're adding Discourse to an existing workspace, navigate to your workspace settings page, then to the Integrations tab and click the Discourse logo in the Plug & Play Integrations section.

image

Create an API key on Discourse

You need to be a Discourse Admin to setup a new Discourse integration

  1. In the Discourse Admin interface, go to the API tab and create a new API Key
image
  1. Fill out the API Key form as follows
  2. User Level: Single User;
  3. User: your username. If you use any other username, make sure it’s an admin or a moderator. Otherwise we won’t be able to retrieve your members’ emails;
  4. Select "Read-only" Scope
image

  1. Save the form and copy the API key
image

If you have a Discourse group for your teammates, the integration can automatically mark its members as teammates. You can get its ID by visiting the group page and appending .json to the URL.

Configure the new Discourse integration in Orbit

After setting up your API key on Discourse, complete the Orbit form presented during the setup flow.

ℹ️
By default Orbit does not import Discourse topics and posts with categories, marked as private, if you want to import those as well - check Allow private categories box.
image

Connect Webhooks

  1. In the Discourse Admin interface, go to the API tab and create a new Webhook
image
  1. Fill out the Webhook form as follows
  • Payload URL and Secret Key - Orbit will provide this during the setup process
image
  • Content Type: Application/json;
  • Individual events: Topic Event, Post Event and User Event;
  • Triggered Categories and Triggered Groups: leave empty;
  • Check TLS certificate of payload URL: Checked
  • Active: Checked
image

Finally, save the form.

Due to Discourse rate limits, the import will take from several minutes to several hours.

Reporting

Discourse activity will now appear alongside other integrations in your reports.

image

DiscordXGitHubLinkedIn