Overview

The Notifications Center of the new notifications feature allows administrators to easily configure how users of the workspace are able to be notified about updates on the workspace.

Key Features

The new Notifications Center allows administrators to configure how the users of a workspace will receive notifications:

• It allows to completely disable all notifications or certain channels
• It allows to mute notifications triggered due to changes by technical users
• It allows configuring, which topics users of the workspace may receive
  • By completely disabling certain topics
  • By enforcing certain topics to be received by all users
  • By limiting certain topics to only have some of the available options (never, instantly, daily, weekly)
• It allows to setup & test of custom configuration for the E-Mail channel
  • Workspace branding to be used for the default header & footer
  • Custom header & footer (HTML)
  • Custom SMTP server
• It allows to setup & test of custom configuration for the Microsoft Teams channel
  • Setup Bot & Microsoft Teams tenant ID
• It offers an Audit Log that allows seeing which notifications have been sent recently

Start Page

The start page of the Notification Center can be opened via the “Administration” menu as a dedicated section below “Advanced Settings”.

The start page allows to easily enable/disable complete channels (e.g. E-Mail) and to mute any notification that was triggered by a change of a technical user (e.g. an integration).

From the start page, you can also switch to configuring one of the channels by clicking it or locking into the Audit Log or Account Level Settings.

Configuring the E-Mail Channel

If you choose to configure the E-Mail Channel, you will see three new tabs: Workspace Notifications, Account Email Template, and Account SMTP Configuration.

Workspace Notifications

The Workspace Notifications tab allows you to see different domains & topics that you can subscribe to on a certain workspace. Any change done on this screen will only affect the workspace you are currently in.

The administrator can configure for each topic, which options the users of the workspace can choose from for the Frequency of the notification (Never, Instant, Daily, Weekly) and which of these options should be the Default for new users that did not choose one explicitly.

By disabling all options but Never, the administrator can completely disable a topic. Similarly, they can enforce notifications for specific topics by only choosing the option Instant.

Fact Sheet Update Details

Under the Fact Sheets topic, you will be able to opt-in for showing details in Fact Sheet update notifications. Once this is enabled, the users of your workspace that have subscribed to Fact Sheet updated notifications on Email will see which field has changed on the Fact Sheet and the content of what has changed.

Account Email Template

The Account Email Template tab allows configuring the look of the E-Mails sent out by the system. Any change on this page will affect all workspaces of the account the user is currently logged into.

First of all, the administrator can define, which workspace is used to load the design for notifications that are not bound to a specific workspace (e.g. password reset notifications) and how images are to be displayed. Be aware that changes to the actual workspace design may take up to 24 hours to be reflected in the notifications.

The administrator can also choose to use a completely custom HTML header & footer.

The following placeholders can be used inside of these templates:

• {{recipient}} The display name of the recipient (e.g. first name and last name)
• {{email}} The email address of the recipient

Account SMTP Configuration

The Account SMTP configuration tab allows configuring a custom SMTP server. Again, any change on this tab will affect all workspaces of the account the user is currently logged into.

The administrator can configure and test a custom SMTP server with the following values:

📘

Authentication Information

Currently, the SMTP feature only supports Basic Authentication.

🚧

Note for users of an Office 365 mail server.

Ensure that you have activated authenticated client SMTP submission in your Microsoft 365 admin center. For more information, please refer to Enable or disable SMTP AUTH in Exchange Online.

Blocked Email Addresses

📘

Information

This section does not apply if you have an active Account SMTP Configuration

The Blocked Users tab allows you to identify which email addresses are currently on the blocked list. This list is maintained to protect our email sender's reputation. If an email delivery failed with a permanent error (e.g. a mistyped / non-existent email, a non-existent destination server), the email address will be blocked. Trying to send emails to addresses that are known to result in an error, hurts our mail reputation, which can lead to Emails being classified as spam by the mail server.

If you find an email address on the block list, which you know to be working and want to remove it from the list, please contact our support.

Configuring the Microsoft Teams Channel

If you choose to configure the Microsoft Teams channel, you will see three new tabs: Workspace Notifications and Account Microsoft Teams Configuration and Teams Users.

Workspace Notifications

The Workspace Notifications tab allows you to see different domains & topics that you can subscribe to on a certain workspace. Any change done on this screen will only affect the workspace you are currently in.

The administrator can configure for each topic which options the users of the workspace can choose from for the Frequency of the notification (Never, Instant) and which of these options should be the Default for new users that did not choose one explicitly.

By disabling all options but Never, the administrator can completely disable a topic. Similarly, the administrator can enforce notifications for certain topics by only choosing the option Instant.

Fact Sheet Update Details

Equivalent to the Email channel you will be able to opt-in for showing details in Fact Sheet update notifications on Microsoft Teams. Once this is enabled, the users of your workspace that have subscribed to Fact Sheet updated notifications on Microsoft Teams will see which field has changed on the Fact Sheet, as well as the content of what has changed.

Account Microsoft Teams Configuration

This tab can be used to set up the Microsoft Teams Notifications with your account.

🚧

Beware that any change on this tab will affect all the workspaces of your account, not only the one you are logged in to.

Open Microsoft Teams and search for LeanIX Notifications in their App Store, and install the application.

After that, you only need to save the ID of your Microsoft Teams tenant into the text field to bind your account to this Microsoft Teams instance.

Migration from bot package installation to AppSource installation

If you already have the application installed via the download of the bot package and want to switch to the AppSource installation, you need to reinstall the app. So first, uninstall the existing LeanIX Notifications application at admin.teams.microsoft.com, then install the LeanIX Notifications app as described in the earlier section. But keep in mind that the application will be removed for all users in your Teams.

After the installation process is complete, each Microsoft Teams user who wants to get notifications via Microsoft Teams needs to add the Bot to their Applications.

As a Microsoft Teams Admin, you can also create an App setup policy in Microsoft Teams to automatically install the App for users. For more information on that, read Manage app setup policies in Microsoft Teams - Microsoft Teams

Mapped Microsoft Teams Users

The Users tab allows you to see the status of the user mapping between Microsoft Teams and LeanIX. Administrators can find this tab under Notification Center → Microsoft Teams → Users.

The Remap button allows you to restart the mapping process for a particular user. Please note that, for a successful mapping, the email address of the user must be the same in Microsoft Teams and LeanIX.

Configuring the Slack Channel

To start configuring Slack settings and configurations, click the Slack link on the notifications center start page.

If you choose to configure the Slack Channel, you will see three new tabs: Workspace Notifications, Configuration and Users.

Workspace Notifications

The Workspace Notifications tab allows you to see different domains & topics that you can subscribe to on a certain workspace. Any change done on this screen will only affect the workspace you are currently in.

The administrator can configure, for each topic, which options the users of the workspace can choose from for the Frequency of the notification (Never, Instant) and which of these options should be the Default for new users that did not choose one explicitly.

By disabling all options but Never, the administrator can completely disable a topic. Similarly, he can enforce notifications for certain topics by only choosing the option Instant.

Fact Sheet update details

Equivalent to the Email channel, you will be able to opt-in for showing details in Fact Sheet update notifications on Slack. Once this is enabled, the users of your workspace that have subscribed to Fact Sheet updated notifications on Slack will see which field has changed on the Fact Sheet, as well as the content of what has changed.

Slack Configuration

This tab can be used to set up Slack Notifications for your workspace.

To configure your workspace for Slack, click on the ‘Add to Slack’ button. Allow the connection between the Slack App and the Slack Workspace.

After clicking Add to Slack, you will be redirected to the Slack connection page, which will allow you to choose the correct Slack workspace to connect your LeanIX workspace to, show you what the LeanIX Notifications bot be able to view, and what it will be able to do in your Slack workspace. After allowing the LeanIX Notifications bot to connect to your Slack Workspace, you will be redirected to the following Success page.

Once you have successfully connected your LeanIX workspace to your Slack workspace, you can see a red Disconnect from Slack button on the configuration page which will allow you to disconnect your LeanIX workspace from your Slack workspace again.

Mapped Slack Users

The Users tab allows you to see the status of the user mapping between Slack and LeanIX. Administrators can find this tab under Notification Center → Slack → Users.

The Remap button allows you to restart the mapping process for a particular user. Please note that, for a successful mapping, the email address of the user must be the same in Slack and LeanIX.

Audit Log

When opening the Audit Log from the start page, the administrator can look into recently send notifications.

Account Level Settings

The administrator may also configure the notifications on an account level, e.g., by disabling them completely.