> For the complete documentation index, see [llms.txt](https://help.nightfall.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.nightfall.ai/nightfall_alert_platform/alerting_to_ms_teams.md).

# Setting up MS Teams as an Alert Platform

Learn how to use MS Teams as an alert platform in Nightall.

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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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 %}