To start using ALTO, complete several steps described below.
The overall installation process comes down to:
- Add ALTO to your Slack workspace
- Connect ALTO with GitLab/GitHub
Contents
- 1. Add ALTO to your Slack workspace
- 2. Connect ALTO to GitLab, GitHub
- Automatic connection
- Manual connection
- Get a demo
1. Add ALTO to your Slack workspace
Visit https://youralto.com and click the top right corner button "Add to Slack" to run the installation process.
You will be asked to provide access to ALTO, this time to your Slack workspace.
ALTO will need a number of scopes to operate. Check the table below for details:
channels:read | view basic information about public channels in a workspace |
---|---|
chat:write | post messages in channels and conversations |
chat:write.public | send messages to channels Alto isn’t a member of |
commands | allows usage of /alto command |
groups:read | view basic info about private channels ALTO has been added to |
im:history | view messages in direct messages that ALTO has been added to |
im:read | view basic info about direct messages that ALTO has been added to |
mpim:read | view basic info about group direct messages that ALTO has been added to |
users.profile:read | view profile details about people in a workspace |
users:read | view people in a workspace |
Once you give your approval, ALTO will be installed in your workspace and you will receive a welcome message.
2. Connect ALTO to GitLab, GitHub
The welcome message that ALTO sends you will have two buttons that allow you to link ALTO with GitLab and GitHub so that you can use its features, such as repository monitoring and reminders, later on.
Click Connect GitLab
or Connect GitHub
to link it with ALTO. After connecting your code hosting service: you’ll receive a success message in Slack. After that, you can add a GitLab/GitHub repository (the link will redirect you to the website).
Note: The connection link may eventually expire. If you need to run the connection process later, you can use the command /alto connect gitlab
to receive a new link or connect to your code hosting service through the web application.
There's also an option to connect your code hosting through our web application. In order to do that, run /alto help
and the list of commands will be sent to you.
Click “Open Web App” or just run /alto open web
In the web app, you can connect your GitLab or GitHub account to ALTO.
Automatic connection
Secure. Easy. Fast(er).
Once you've authorised ALTO, you will receive a confirmation message in Slack. The Installation is complete 🎉
Manual connection
Secure. Easy. Fast. Personalised
Based on your code hosting platform, the steps may vary a bit. To set the manual connection based on your preferences, please follow the steps below:
GitLab
-
Open Repository >> Click
Settings
and selectWebhooks
-
Click
Add New Webhook
-
Into the
URL
field paste ourWebhook link
-
Check events you want ALTO to access:
-
Push events
-
Comments
-
Merge request events
-
Pipeline events
-
-
Enable SSL verification
-
Click
Save changes
GitHub
-
Open Repository >> Click
Settings
and selectWebhooks
-
Click
Add webhook
-
Into the
Payload URL
field paste ourWebhook link
-
Define
Content type
asapplication/json
-
Leave the
secret
field blank -
Enable SSL verification
-
Pick
Let me select individual events
and check:-
Check suites
-
Pull request comments
-
Pull request review threads
-
Pull request reviews
-
Pull Request
-
Pushes
-
-
Mark
Active checkbox
as checked -
Click
Add Webhook
button
Once you've authorised ALTO, you will receive a confirmation message in Slack. The Installation is complete 🎉
Get a demo
Since you are here…
💡 Have feedback or questions? Contact us