# Setting up MS Teams as an Alert Platform

This document explains the process of using MS Teams as an alert platform in the Nightfall application. 

{% hint style="info" %}
Currently, you can use Microsoft Teams as an alert platform only on the Microsoft products - Exchange, OneDrive, Sharepoint, and Teams.
{% endhint %}

## Prerequisites

* Contact your Nightfall CSM to obtain the package file required during the setup.
* You must have credentials to an MS Teams admin account.

## Installation

1. Open the MS Teams app.
2. Click the **Apps** menu from the left sidebar

<figure><img src="https://2214688951-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mg3wgFIu8T7XAT1u-f_%2Fuploads%2Fu2PXHiH8jdCxVOFFg4IK%2Fimage.png?alt=media&#x26;token=40df2f92-ce94-4401-9cea-d92ee3348f3f" alt=""><figcaption></figcaption></figure>

3. Click **Manage your apps**.

<figure><img src="https://2214688951-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mg3wgFIu8T7XAT1u-f_%2Fuploads%2Fu7Qh6Gki7BPXxjLaCYvd%2Fimage.png?alt=media&#x26;token=3a5ede08-a645-4712-9e39-d4d79b54100f" alt=""><figcaption></figcaption></figure>

4. Click the **Upload an app** option.&#x20;

<figure><img src="https://2214688951-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mg3wgFIu8T7XAT1u-f_%2Fuploads%2FqVetGFXrSL8ycU1kvuFf%2F1234.png?alt=media&#x26;token=3283650e-b0fd-4bf4-a541-c6fc7e5e5e14" alt=""><figcaption></figcaption></figure>

5. Select the **Upload an app to your organisation’s app catalogue** option.

<figure><img src="https://2214688951-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mg3wgFIu8T7XAT1u-f_%2Fuploads%2F3kWiNmTNB5UTZpqIRuMv%2Fimage.png?alt=media&#x26;token=84c58ae4-feca-419b-a190-6e40b2c58bf8" alt=""><figcaption></figcaption></figure>

6. Upload the Nightfall package obtained from your Nightfall CSM. The Nightfall Alerts app is available in your organisation’s Teams app catalogue once you upload the package.
7. Search the term *Nightfall* in the Teams search bar. You must now be able to see the **Nightfall Alerts** app.&#x20;

<figure><img src="https://2214688951-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mg3wgFIu8T7XAT1u-f_%2Fuploads%2FbYwOva2BovaSdg1WRd21%2Fimage.png?alt=media&#x26;token=c7118fc0-a393-40e2-a576-76442acf44ce" alt=""><figcaption></figcaption></figure>

8. Click **Add** for the **Nightfall Alerts** ap&#x70;**.**

<figure><img src="https://2214688951-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mg3wgFIu8T7XAT1u-f_%2Fuploads%2Fm9V8njt6bnxpNG4KEqE1%2Fimage.png?alt=media&#x26;token=d2cff906-e9ef-4380-bea5-fa9c5ecfc14a" alt=""><figcaption></figcaption></figure>

9. Click the **Add** drop-down menu and select **Add to a team**. You can select multiple Teams.

<figure><img src="https://2214688951-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mg3wgFIu8T7XAT1u-f_%2Fuploads%2Fz2Op8p5h1wNryLNz4YPR%2Fimage.png?alt=media&#x26;token=00091390-d275-43c3-883c-3a15d03556e1" alt=""><figcaption></figcaption></figure>

10. Select a Team from the drop-down menu.&#x20;

{% hint style="info" %}

{% endhint %}

<figure><img src="https://2214688951-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mg3wgFIu8T7XAT1u-f_%2Fuploads%2FT9al1CrZuoii3Y4veP4b%2Fimage.png?alt=media&#x26;token=22881a93-672b-4283-884c-5e21538654b9" alt=""><figcaption></figcaption></figure>

11. Once you select a Team, Nightfall Alerts will be available for all the public channels in the selected team.&#x20;

<figure><img src="https://2214688951-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mg3wgFIu8T7XAT1u-f_%2Fuploads%2FIoNhg4Yu5Jo62GVLLzl8%2Fimage.png?alt=media&#x26;token=4503655c-5169-48c9-b865-a9014f1a529a" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
&#x20;Once you select the target Team(s) where you may wish to receive the Nightfall alerts, Nightfall allows you to select one of the Team and a public channel within this team in the alert setup pages of [MS Teams](https://help.nightfall.ai/nightfall-ai/nightfall-for-microsoft-365/nightfall-for-microsoft-teams/configuring-integration-alerts#configuring-ms-teams-as-an-alert-channel) and [OneDrive](https://help.nightfall.ai/nightfall-ai/nightfall-for-microsoft-365/nightfall-for-onedrive/configuring-integration-alerts#configuring-ms-teams-as-an-alert-channel) integrations. You can select a public channel over there and the alerts are sent to the selected channel. The app would post alert messages to the selected channel and you can also @mention Nightfall Alerts to chat with it.
{% endhint %}