# 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="/files/Skun6cOCrsHpsWad6BYt" alt=""><figcaption></figcaption></figure>

3. Click **Manage your apps**.

<figure><img src="/files/k52xQ0MUHMadJE2YWZFO" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/ojwZwbOcCX8wc8Is0TTh" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/iZaXFy1RhC3bp5Kgg3il" 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="/files/7ZlgraecT5yL647puTqa" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/TEp3bnldhhabG0YTWQn9" 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="/files/cWJJGyNr4LbxqgoDLIU6" alt=""><figcaption></figcaption></figure>

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

{% hint style="info" %}

{% endhint %}

<figure><img src="/files/5GUkgi19R2e5INNEgVpz" 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="/files/VUrj0LmDeMPN8sspiVrw" 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.nightfall.ai/nightfall_alert_platform/alerting_to_ms_teams.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.