HomeDocumentationRecipesChangelog
HomeRequest DemoContact
Documentation
HomeRequest DemoContact
Start typing to search…

Microsoft Teams

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 and configure a app in Microsoft Teams with the permissions to communicate with your Validio installation. Complete the following sections before you add a Validio notification channel for MS Teams.

Create a Microsoft Teams App for Validio

Create a new Microsoft Teams app in your Microsoft Developer Portal. Make sure to give the new app a relevant name, such as Validio, to indicate that it will be used to send notifications from Validio.

Fill in the following (Basic Information) fields and save the app:

FieldValue
Short DescriptionValidio notifications
Long DescriptionUsed for sending notifications from Validio to Microsoft Teams
Developer or Company NameValidio
Websitehttps://validio.io/
Privacy Policyhttps://validio.io/privacy-policy
Terms of Usehttps://validio.io/terms-of-use

Create a New Bot for your App

After creating the Microsoft Teams app for Validio, you need to add a notification bot to the app.

  1. In the app you just created, navigate to App features > Bot > Create a new bot > New bot.
  2. Edit the following information to configure the bot:

Field

Description

Name

Give the bot a relevant name.

Endpoint address

Enter the bot endpoint address, for example: http://my-company.validio.io/ms-teams-webhook

Client secrets

Navigate to "Client secrets" and create a secret. Copy and store the secret value. (You will use it to configure the notification channel in Validio.)

Bot ID

Navigate back to the overview for the new bot to find the Bot ID. You can find this value in the URL for your Microsoft portal, for example: https://dev.teams.microsoft.com/bots/{BOT-ID}/configure
Copy and store the value. (You will use it to configure the notification channel in Validio.)

Scopes

Navigate back to the overview for the new bot and, under "Select the scopes where people can use your bot", check Team.

  1. Save your settings for the new bot.
  2. Add the new bot to your Microsoft Teams app for Validio.

Add the Bot to a Microsoft Teams Channel

Now you need to add the bot to the channels in Microsoft Teams where you will send Validio notifications and messages.

To add the bot you created to a Microsoft Teams Channel,

  1. Navigate to the overview for the new bot and click "Preview in Teams".
  2. In the Microsoft Teams App dialog, click "Add to a team".
  3. Select the channel to add the bot.
  4. Click "Set up a bot".

Now you have completed setting up Microsoft Teams to receive notifications from Validio.

Add a Notification Channel for Microsoft

To add a new notification channel for Microsoft Teams,

  1. In Validio, navigate to Notifications > Channels and click + New Channel.
  2. From the Channel type list, select Microsoft Teams.
  3. Select the Namespace where the channel will be created.
  4. 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.
  5. (Optional) Check Interactive Message to manage or triage the incident from the notification message.
  6. (Optional) Test the channel.
  7. Click Create.

Microsoft Teams Configuration Parameters

Field

Description

Channel Type

Select Microsoft Teams as the Channel type to send notifications to.

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. This ID can be retrieved by going to the channel and clicking the option to "get link to channel". The relevant part of the link will be between channel/ and the next /, for example: ...channel/CHANNEL-ID/

Client ID

This is the Bot ID for the bot you created in your Microsoft Teams app for Validio.

Client Secret

This is the Client Secret you created for the bot in your Microsoft Teams app for Validio.

Application Link URL

URL to the Validio application instance, used to send notifications.

  • *Note:** This application link URL is predefined based on the web browser URL to your Validio instance.

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.

📘

Note

Validio does not send notifications for backfilled incidents.

Updated 8 days ago