The Orbit Slack App allows you to add and search members, add notes and tags, and get notifications right from within your team’s Slack.
Slack App vs. Slack Integration
The Slack App is installed on your company Slack to receive Slack Notifications and get the nifty
/orbitSlack command. The Slack integration is a different, unrelated feature that can be installed on your community Slack, and will create members profiles and activities in Orbit. To learn more about the Orbit Slack Integration, head to this page.
Head to your Account Settings page. If you've already connected the Orbit GitHub or Twitter integrations, you'll see them there.
Note that the Account Settings page is distinct from your Workspace Settings page.
On Account Settings, scroll to Linked Accounts and click "Connect Slack."
Much like the GitHub integration, the Slack App connects at the user level and is then added to relevant workspaces.
“Connect Slack" will take you to Slack’s authorization screen. The app asks for specific permissions that will allow it to accept and respond to slash commands. Click Authorize App.
You can change the Slack workspace the App will be installed on by using the select dropdown in the top-right corner ☝️
After clicking Allow, you should see "Slack" under Linked Accounts on your Account Settings page:
Now, navigate to the workspace where you'd like to add the integration.
Click Settings in the navigation, then navigate to Integrations area.
You'll then be able to attach the Slack account you just linked to your workspace.
You’re all set!
You and your teammates can now invoke the
/orbit “slash command” into your Slack. The
/orbit command lets you quickly add and search through your community members, add a new note to them, and edit their tags, right from within Slack.
You can use the
/orbit slash command in public and private channels and in Direct Messages.
You can try to bring it up with
/orbit help, which displays the list of available commands:
After adding or searching for a community member, you’ll have the opportunity to go to their Orbit profile, add a note, or update their tags:
The Orbit Slack App allows you to receive Slack notifications for the Orbit activities that you don’t want to miss, providing insights about the community members and quick actions (add a note, edit tags…).
To enable and configure the Slack notifications, head to your workspace settings and click Manage under the Orbit Slack App section.
On that page, you can choose to enable the Slack notifications. Doing so, you will be asked to choose a Slack channel, as well as the activities you want to get notifications for.
Notifications can only be received on a public Slack channel. You can refresh the list of available channels by refreshing the page.
If you see the errors /orbit failed with the error “dispatch_failed” or This app responded with Status Code 500, check in your workspace settings that the Slack integration is listed under Integrations. If not, you can try to reinstall it. If it is, the error might be on our end—feel free to drop us a line to help us investigate!
Updated 4 months ago