Documentation
Twitter integration
This guide will walk you through setting up the Twitter integration.
The Orbit Twitter integration allows you to connect one or more Twitter accounts to your workspaces.
The integration will automatically create an Activity for any mention of connected accounts, and it will save that Activity to an existing member's profile. If the tweet 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 @mentions
- New followers (from the point of connecting the integration) |
Historical Import | - Up to 800 of the most recent @mentions |
Does not track or import | - All your followers, due to a restriction with Twitter's API (it can't tell us when someone followed you)
- Unfollowers |
Note: This integration does not import all your Twitter followers as new members. This is because Twitter can't tell us exactly when a user followed your account in the past, so it would look like all your followers started following you on the same day.
Initially, Orbit will create members and activities for the 800 most recent mentions of your account.
Connect a Twitter account to your Workspace
Head to the Integrations section of your Workspace's Settings page. If you've already connected the Orbit GitHub integration or any other integrations, you'll see them there.
To get started, click Twitter in the list of Integrations.
A modal will pop up asking you to confirm that you are already logged into the Twitter account that you want to connect to Orbit.
🚧 By default, Twitter will install the Orbit app to whichever Twitter account you're currently logged into. So be sure to login to the appropriate account before connecting.
You will be asked to Authorise Orbit for Twitter. Orbit requires read-only permissions and does not have the ability to send any Tweets from your account.
If successful, Twitter will send you back to Orbit's Twitter Settings page where you can further customize your integration.
Once you add the relevant Twitter account, Orbit will kick off the process of importing up to 800 of the most recent mentions (which is as much as Twitter will allow us to do). This usually takes 1-2 minutes.
📘 For members created from this integration, the "joined" date will be the date they followed your account.
Orbit will attach tweets to existing member profiles, or will create new members if the person who tweeted doesn't already exist in Orbit.
On the Activity page, you can filter activities by All Twitter.
All new tweets will appear on the Activity page, as well as on the member profile of whomever sent the tweet.
Connecting multiple Twitter accounts to a workspace
You can add more than one Twitter integration to your workspace. Start by logging into the Twitter account you want to add and repeat the steps outlined above.