This guide will walk you through setting up the Reddit integration.
The Reddit integration for Orbit will automatically ingest comments on specific Subreddits. We will create a new member profile for every commenter along with their comment activity if they don't already exist, or we'll add a new comment activities to any existing members.
After creating your Orbit workspace, you can add the Reddit integration from the Integrations page in your workspace's Settings.
Click on Reddit and you'll see a pop up like the one below. You should check that you are either completely logged out of Reddit or already logged into the account that you want to connect to Orbit.
You can use your own Reddit account unless you and your team have a shared Reddit account, in which case, use that. If you don't want to use your account, consider creating a shared account instead. Orbit does not have any permissions to act as you, or post on your behalf, all we do is gather the comments on the subreddit(s) that you select. If at some stage you need to change the account you have connected to Orbit, remove the Reddit integration and add it back using a different account. No past data will be lost if you do this.
Once you are happy to proceed, click on Allow. If you are not logged into Reddit you will be redirected to their site and asked to log in as the account you want to connect to Orbit.
If you are already logged in, you will be asked to grant Orbit the correct permissions to access the data we need to sync the comments associated with whichever subreddit you choose to your workspace.
At this time the Reddit integration will only capture comments on specified subreddits. We do not import upvotes or downvotes. The Orbit application does not have write access to your personal Reddit account and can only read comment data from subreddits you specify in the settings.
Once you grant Orbit permission to access Reddit you will be redirected back to the settings page in the Orbit application.
To complete the setup, you must now select the subreddit(s) that you want to sync with Orbit. You can do this by checking the box next to each one, and clicking Save.
The setup is complete and at this point and a historical import of previous comment data from your chosen subreddit(s) will begin.
By default the Reddit integration will import the past 1000 activities on your chosen subreddit.
The Reddit integration will create a new activity type on your workspace called Commented on a post.
If you want to edit any of weights associated with this Activity Type you can find them in your workspace's Settings under Activity Types.
By default the weight is 1.0, but you should consider how important these activities are for you and your community and adjust them if necessary.
Please note that if you change the weight of an activity type, only activities created after that point will be given the new weight. If you want to apply a new weight to historical activities as well, please contact email@example.com and let us know which activity type(s) you would like to have reweighed.
If you would like to revoke the access you initially granted to your account, you can do so by visiting the Reddit Authorized Applications page. Find the Orbit application in the list and click on Revoke Access.
If you want to remove the Reddit integration you can do so from the integration settings page.