Installation
Slack Installation (and scopes)
To install Axolo, you’ll need to sign up from our home page. We will require access to specific scopes in order to be able to push notifications and create channels as a Slack application.
Required Slack scopes:
Bot Scopes
The following scopes are the scopes we require for Axolo to work.
| Bot Scopes | Reason |
|---|---|
| app_mentions:read | View messages that directly mention @axolo in conversations |
| channels:manage | Manage public channels that Axolo has been added to and create new ones |
| channels:history | See which messages need to be updated in a channel (for example, a pull request doesn't have a conflict anymore we need to delete that message) |
| channels:read | View basic information about a channel |
| commands | LGTM command to allow approving a PR right from Slack |
| groups:history | View messages and other content in private channels that Axolo has been added to |
| groups:write | Manage private channels that Axolo has been added to and create new ones |
| reactions:write | Add and edit emoji reactions |
| chat:write | Post messages in approved channels & conversations |
| chat:write.public | Send messages to public channels @axolo isn't a member of |
| im:history | View messages and other content in direct messages that Axolo has been added to |
| im:read | View basic information about direct messages that Axolo has been added to |
| im:write | Start direct messages with people |
| users:read | View people in a workspace |
| reactions:read | View emoji reactions and their associated content in channels and conversations that Axolo has been added to |
| emoji:read | View custom emoji in a workspace |
User Scopes
Optional scopes are to be granted from every user onboarded on Axolo. They allow us to reduce notifications when the engineer does an action in GitHub.
| User Scope | Reason |
|---|---|
| chat:write | Post messages in approved channels & conversations |
| channels:write | Manage a user’s public channels and create new ones on a user’s behalf |
| groups:write | Manage private channels that Axolo has been added to and create new ones |
| reactions:write | Add and edit emoji reactions |
GitHub installation (and scopes)
When the Slack application is installed, you will need to install our GitHub application.
You need to choose between installing Axolo on all of your organization repositories or selecting only specific repositories. You will be able to add new repositories along the way if you choose the latter.
Axolo does not have access to your company’s code. GitHub code lies in the “Content API”. More information about GitHub scopes can be found here.
Required GitHub scopes:
| Scope | Permission | Description |
|---|---|---|
| Actions | Read | Workflows, workflow runs, and artifacts |
| Administration | Read | Repository creation, deletion, settings, teams, and collaborators |
| Deployments | Read | Deployments and deployment statuses |
| Members | Read | Organization members and teams |
| Metadata | Read | Search repositories, list collaborators, and access repository metadata |
| Repository hooks | Read | Repository created, deleted, archived, unarchived, publicized, privatized, edited, renamed, or transferred |
| Status | read | Commit status updated from the API |
| Team discussions | Read | Discussions and related comments and labels |
| Issues | Read & Write | Issues and related comments, assignees, labels, and milestones |
| Pull requests | Read & Write | Pull requests and related comments, assignees, labels, milestones, and merges |
| Workflow run | Read | Workflow run requested or completed on a repository |
Axolo onboarding
Now that Slack and GitHub applications are configured, we only need to match GitHub members to Slack users.
You can filter your team members by specific GitHub teams, or search your a GitHub login.
🎉 Congratulations! You can start using Axolo and select open pull requests in the same modal to create your first code review channels right away.