Level up Your Orbit Workspace With These Community Integrations

Developer Relations
May 6, 2021
Ben Greenberg
Developer Advocate
Level up Your Orbit Workspace With These Community Integrations
Welcome to The Observatory, the community newsletter from Orbit.

I'm Rosie, and I'll be your guide for this mission. Each week I'll go down rabbit holes so you don't have to. I'm here to share tactics, trends and valuable resources I've observed in the world of community building.

💫  Subscribe to The Observatory

The data from your community powers your Orbit experience. New messages in Slack, questions in Discourse, conversations on Discord, issues raised on GitHub, there are so many places where your community lives. Orbit offers many Built-in Integrations that can be set up directly from within the Orbit app. Each integration offers more context and the potential for more comprehensive reporting and analysis.

What about the places your community operates on that are not yet incorporated as built-in integrations or have Zapier integrations? Community integrations can bridge that divide for you in your Orbit workspace.

Community integrations are utilities to connect third-party services to Orbit leveraging the Orbit API. They are written by members of the community, and the Developer Relations team at Orbit. Each community integration has three paths to use it depending on your needs:

ways to use community integrations

Current Integration Options

What third-party services can you add to your Orbit workspace currently using community-built integrations?

There are a lot more community integrations in the works. If you have an idea for the integration of a third-party service suggest it in the Orbit Ideas Board!

Setting Up An Automated Integration

Let's take a look at how to automate an integration using GitHub Actions. The process takes only a few minutes and involves several steps that can be accomplished from within your web browser.

steps to automate with GitHub Actions

The first two things you need to do are create a GitHub Account and create a new GitHub repository. To sign up for GitHub navigate to the signup page and fill in your details.

Then, once you have an account and a repository, click on the "Actions" tab in the top navigation bar inside your repository.

actions tab on github

Once you have clicked on the "Actions" tab, it's time to create the new Actions workflow. You can do so by clicking on the link entitled "Skip this and set up a workflow yourself".

set up a workflow link

You can name your workflow anything you would like. We recommend naming it after the integration. For example, if you are creating a YouTube integration, you would call it youtube.yml.

You're now ready to add your integration!

Delete all the file contents that GitHub adds into your new workflow initially. Then, copy and paste the file contents from the specific workflow file you want from within the Orbit GitHub Actions templates list. Make sure to follow the instructions in the Orbit Actions template README on adding your required credentials to GitHub.

You do not need to do anything else to initiate it.

Each integration is scheduled to run once a day automatically. You will soon start to see the third-party service populating your Orbit workspace with its relevant information on your community!

Explore Further

As mentioned above, you can also use each community integration in your own code or in your terminal.

The respective repository for each integration contains everything you need to know to get up and running with using it as a package in your code or directly from your command line.

Pick the integration or integrations you are interested in and begin exploring them today:

Related Articles