This guide discusses the steps to create a Microsoft Teams app and configure it to communicate with your Validio installation. These steps are a prerequisite for setting up a Validio notification channel for Microsoft Teams. For more information, see the Microsoft Teams integration.

You will need to complete the following steps before you can create a notification channel to send messages and alerts from Validio to Microsoft Teams.

1. Create a Microsoft Teams app for Validio.
2. Create and configure a bot for the app.
3. Publish the app to Microsoft Teams.

Create a Microsoft Teams App for Validio

You need to create a Microsoft Teams app in your Microsoft Developer Portal for Validio. 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.

1. Navigate to your Microsoft Teams App Developer Portal.

2. Click + New app.

3. In the Create a new app dialog, enter a name for the app and click Save.

   After saving you're redirected to the Basic Information page for the new app.

4. Fill in the required fields. See the example values in the table.

5. Click Save.

Create and Configure a Bot for the App

Create a notification bot and configure it with the necessary permission scopes to communicate with your Validio installation.

1. Navigate back to Developer Portal > Apps and select the Validio app you created.
2. Go to Configure > App Features > Bot.
3. Under Identify your bot, click Create a new bot.
4. In the Bot management page,
   1. Click + New bot.
   2. Enter a name for the bot.
   3. Click Save.
      After saving, you're redirected to the Configuration page for your bot.

5. In Configure, update the Bot endpoint address and click Save.
6. The bot endpoint address should should be formatted as follows: https://my-company.validio.io/ms-teams-webhook
7. In Client Secrets,
   1. Click + Add a client secret for your bot to generate a new client secret.
   2. Copy and store this secret. You will use to configure the notification channel in Validio.

To connect the bot to the app you created for your Validio notifications,

1. Navigate back to Developer Portal > Apps and select the Validio app you created.
2. Go to Configure > App Features > Bot.

3. Under Identify your bot > Select an existing bot, choose the bot that you created.
4. The bot name includes the bot ID in parentheses and also in the field for "Enter a bot ID". Copy and store the bot ID. You will use this bot ID to configure the notification channel in Validio.
5. Under Select the scopes where people can use your bot, check Team.
6. Click Save.

Publish the App to Microsoft Teams

Publish the app to the relevant channels where you want to route incident notifications from Validio. You have two options for publishing the app for your organization to use in Microsoft Teams. Select the one that works for you.

• Publish--If you choose this option and Publish to your org, you may require approval from your IT admins before the app is added to your Microsoft Teams channel.
• Preview in Teams--Redirects you to Microsoft Teams and provides a dialog where you can select the Team and channel to add the bot. Not all users will see this option.

Configure a Validio Notification Channel for Microsoft Teams

After you set up your Microsoft Teams app for Validio, you can create a Validio notification channel to communicate with the Microsoft Teams app and send messages and alerts to your workspaces and channels in Microsoft Teams. For more information, see steps for configuring a Validio Notification Channel for Microsoft Teams.