Documentation
HomeRequest DemoContact

Microsoft Teams

Suggest Edits

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:
FieldDescription
NameGive the bot a relevant name.
Endpoint addressEnter the bot endpoint address, for example: http://my-company.validio.io/ms-teams-webhook
Client secretsNavigate 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 IDNavigate 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.)
ScopesNavigate 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 Microsoft Teams Channel

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

FieldDescription
Channel TypeSelect Microsoft Teams as the Channel type to send notifications to.
NamespaceSelect the namespace where the channel will be created. Only users who are assigned to the same namespace will have access to this channel.
NameIdentifier for the Validio channel, you will reference this name when you create notification rules.
Microsoft Teams Channel IDThe 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 IDThis is the Bot ID for the bot you created in your Microsoft Teams app for Validio.
Client SecretThis is the Client Secret you created for the bot in your Microsoft Teams app for Validio.
Application Link URLURL 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.

📘

Note

Validio does not send notifications for backfilled incidents.

For more information, see Adding Notification Rules.

Updated 15 days ago