Notifications (Mail Server Settings)

Important Note: This article is for the 'Org Administrator' in particular. The actions discussed in the article will not be available to the General Users.

Overview

You can use the mail server settings in this article to manually set up your email to send and receive an email with an iCloud email account. AutoRABIT requires mail server settings to send the AutoRABIT notification emails for events like build failures, build success, deployment failure, merge reports, etc.

Begin the process by hovering your mouse over the Admin module and selecting the option: Notifications.

You’ll then be presented with a screen divided into Mail Settings, Send a Test Mail, and Teams/Slack Settings sections.

Mail Settings

To set up a mail client it’s necessary to configure the server that will take care of the delivery of your emails. And here’s the standard procedure of mail configuration and adding the right parameters in the Mail Settings section:

Fill in the required details as listed below (mandatory fields are marked with an asterisk (*) mark.

1. Host Name: Your incoming mail server name. Ex- smtp.office365.com

2. Port: The port number your incoming mail server uses. Ex- Port 25

3. User Name: The email address you want to set up. Ex- [e-mail]

4. Password: The password associated with your email account.

5. Protocol: The protocol to manage the transmission and outgoing mail over the internet. And, is your email encrypted using SSL? If YES, then select the SSL/TLS if available checkbox.

6. Email From: Enter the email addresses from which you want to receive email notifications while configuring the mail server.

7. Select the Email Notifications checkbox to receive notification alerts.

8. Custom Email Template: AutoRABIT comes with its default email template styles but you can also create your own. Simply enable the Custom Email Template field and add your logo at the top or bottom of the page. You can add footer text too. Once you're happy with your template, save it.

9. To clear all the data in the Mail Settings section and fill in the fields once again, you can use the Reset button.

   

How to reset your Mail preferences?You won't be able to switch back to the default AutoRABIT mail preferences once you have configured your own email template. To switch back to the default email style, you can email us at [e-mail] and we can get it done for you.

Send a Test Mail

Before using your customized email style, be sure to preview it once to be sure everything is displaying correctly. Simply enter your email address in the Recipient field and click on the Test button to receive a test mail notification. Sample email notification attached.

Teams/Slack Settings

When an event is triggered in ARM, email notifications are sent to the selected individuals. If you want to send notifications for particular events to an entire group within your organization through Teams or Slack, then integrate your Teams or Slack application with ARM using the respective Webhook Integration URL. For more information on configuring a webhook on Teams, click HERE. For Slack, click HERE.

1. Select either Teams or Slack as per your organization's requirements.

2. Enter a Channel Name and the Webhook Integration URL.

3. Click on Test Connection. A Test connection Successful notification will be displayed.

If the test connection fails, an error message will be displayed. Check and re-enter the correct webhook URL.

1. After a successful test connection, click Save.

Important Note: The first channel that you add is automatically configured to all the events by default. To remove the channel from any notification type, click on the icon. Channels added after that will have to be configured to events manually.

1. To add another channel, click on the (+) icon. You can add up to 10 channels.

   
2. To delete a channel, click on the (x) icon and then click YES on the confirmation message.

Notification Configuration

This section is a guide to configuring the channels to the notification types. You can select which group(s) on Teams or Slack should get a notification when a particular event is triggered.

1. Select the checkbox for the Notification Type that you want to configure.

2. Click in the Selected channels field to display a list of configured channels.

   
3. Click the channel that you want to send the notification to when this event is triggered. You can select up to five channels for each notification type, which means that you can select as many channels as you have configured.

4. You can select multiple checkboxes for numerous notification types and select the channels to which you want to send notifications for each event.

5. Click Save. All the selected Notification types will be saved simultaneously.

6. When an event is triggered in ARM, the configured channels will receive a notification. The image below is an example of what these notifications look like on Teams.