Instructions for configuring and using ALTO app

Contents

How to start working with ALTO app after installation

Once you have successfully installed the ALTO app to your organization's workspace and connected it to your GitLab/GitHub account, workers can use the ALTO app on their own by typing the text commands listed here: list of all ALTO commands, or simply by using the /alto help command.

If a user is not registered in your ALTO organization, the bot will send a corresponding error message and automatically register the user in the organization.

What kind of channels ALTO uses and how users receive messages from ALTO

Informational messages and responses to text commands will be sent via direct message with the ALTO bot.

Notification messages will be sent to the channels that the user sets during the creation of new reminders.

IMPORTANT! It is necessary to invite the ALTO app to the channel in which it should send notifications.

How to setup and manage reminders/repositories

  • First, the user has to add repositories in which they’re going to use ALTO reminders.
  • Run /alto open web or /alto help and click “Open Web App”.

If you have no repositories connected you’ll see this:

09.png

To add a new repository, click "Connect GitLab" or "Connect GitHub".

If you haven't connected your GitLab or GitHub account to ALTO yet, you can do so here and choose the connection type. For now, you can choose "Automatic" and let ALTO handle everything for you.

connect_code_hosting.png

Next, connect a repository. Enter the first three letters of the repository name and select the one you need.

10.png

Finally, create a reminder. You need to fill out the following form:

  • Reminder name - enter the name of your reminder
  • Conversation for event notification - select the channel in which notifications will be sent (optional if “Send notify to author of merge request” toggle is on”)
  • Review notify timeout - determine the maximum planned timeout for the first review of the MR and select the time ranging from 1 hour to 96 hours
  • Merge notify timeout - determine the maximum planned timeout for the MR approval after reviews and select the time ranging from 1 hour to 96 hours
  • Send notify to author of merge request - send notifications to the author of MR as well

Create_mr_reminder.png

After you’ve created a reminder you’ll be redirected to the dashboard and you’ll see the list of connected repositories. To add another repository click on the plus button and repeat the process.

11.png

Best practices with setup reminder or usage of ALTO

If you want the ALTO app to send notifications about merge requests to several people via direct messages, then you should create a new reminder for each recipient. In this case, it is better to set the name of the reminder to include the repository name and the name of the recipient.

Available commands in ALTO

  • /alto open web - Open ALTO web application
  • /alto connect gitlab - Connect GitLab account for ALTO. Give us the ability to recognize events related to your GitLab account
  • /alto connect github - Connect GitHub account for ALTO. Give us the ability to recognize events related to your GitHub account
  • /alto invite @username - Invite a user to the ALTO

Add ALTO to Slack now !

See ALTO in action

💡 Have feedback or questions? Contact us