Send notifications to a designated Microsoft Teams channel.

Prerequisites for Adding a Microsoft Teams Notification Channel

To send Validio notifications to designated channels in Microsoft Teams, you will first need to:

Create an app in Microsoft Teams for Validio.
Configure a bot in your Microsoft Teams app with the necessary permission scopes to communicate with your Validio installation.
Publish the app to the relevant channels where you want to route incident notifications from Validio.

You can find step-by-step instructions for creating and configuring the Microsoft Teams app in the following guide, Setting up a Microsoft Teams App for Validio.

Create a Notification Channel for Microsoft Teams

To add a new notification channel for Microsoft Teams,

In Validio, navigate to Notifications > Channels and click + New Channel.
From the Channel type list, select Microsoft Teams.
Select the Namespace where the channel will be created.
Enter the Name, Microsoft Teams Channel ID, Client ID, Client Secret, and Application Link URL to configure the channel. For more information, see Microsoft Teams Configuration Parameters.
(Optional) Check Interactive Message to manage or triage the incident from the notification message.
(Optional) Test the channel.
Click Create.

Microsoft Teams Configuration Parameters

Field	Description
Namespace	Select the namespace where the channel will be created. Only users who are assigned to the same namespace will have access to this channel.
Name	Identifier for the Validio channel, you will reference this name when you create notification rules.
Microsoft Teams Channel ID	The ID of the Microsoft Teams channel where messages should be posted. To find this ID, go to the channel and click "copy link". The relevant part of the link will be after `channel/` and everything before the next `/`, for example: `...channel/CHANNEL-ID/`. Make sure that you do not include the slashes before and after `CHANNEL-ID`.
Client ID	This is the Bot ID for the bot you created in your Microsoft Teams app for Validio. You can find this in your App Developer Portal > App features > Bot.
Client Secret	This is the Client Secret you created for the bot in your Microsoft Teams app for Validio.
Tenant ID	The tenant ID is only valid for single-tenant bot apps. You can find this value in the MS Teams channel where you want to send the notifications.
Application Link URL	The URL for your Validio application instance, which will be used to send notifications. For example,`https://my-company.validio.io`
Interactive Message	(Optional) Select to manage or triage the incident from the notification message sent to Slack.

Configure the Notifications Content

After adding the Microsoft Teams channel, you can set up notification rules to specify the contents of the notifications that Validio sends to Microsoft Teams. For example, the notification can include the number of incidents and the name of the affected source, the type of validator, filter, and threshold, and so on. For more information, see Adding Notification Rules.

📘
Notifications on Backfilled Validators
Validio does not send notifications for incidents when backfilling validators.

Troubleshooting

The following are troubleshooting tips for some common errors when configuring notifications to Microsoft Teams.

Error: "The bot is not part of the conversation roster."

Cause: The app has not been added to the channel in Microsoft Teams.
Solution: Add the app to the channel in Microsoft Teams before attempting to use it.

Error: "Authorization has been denied for this request."

Cause: Tenant ID configuration mismatch.
Solution:
- If you entered a tenant ID, remove it. (The bot is likely configured as a multi-tenant bot.)
- If you did not enter a tenant ID, add your tenant ID to the configuration.

Error: "The client application <client-id> is missing service principal in the tenant."

Cause: The service principal has not been created for your bot in Azure AD.
Solution: Create a service principal,
1. Navigate to the App registrations page in the Azure portal.
2. Locate your bot app.
3. Click "Create Service Principal".