# Microsoft Teams

{% hint style="info" %}
In order to set up the Microsoft Teams integration with Swarmia you must have Microsoft Entra SSO selected as your authentication provider. For more information please read [Microsoft Entra ID Single Sign-On](/settings/integrations/authentication/microsoft-entra-id-single-sign-on.md).
{% endhint %}

{% hint style="info" %}
In order to set up the Microsoft Teams integration with Swarmia you must have the Teams Administrator role or have permission to add apps to your Microsoft organization. For more information please visit [Microsoft Learn](https://learn.microsoft.com/en-us/microsoftteams/apps-in-teams).
{% endhint %}

## **Connecting Microsoft Teams to Swarmia**

1️⃣ Sign in to the [Swarmia app](https://app.swarmia.com/) and go to [Microsoft Teams settings](https://app.swarmia.com/settings/microsoft-teams).

2️⃣ Find the Microsoft Teams tab under Integrations on the setting page, and download the Microsoft Teams application zip by clicking **Download app zip.**

3️⃣ Go to the [Microsoft Teams Admin center](https://admin.teams.microsoft.com/policies/manage-apps) and upload the zip file you just downloaded by clicking **Actions → Upload new app** in the top right corner.

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

4️⃣ Next, open [Microsoft Teams](https://teams.microsoft.com/) and add **Swarmia** by selecting **Apps → Built for your organization** in the left sidebar.

5️⃣ For alternative ways of installing Swarmia in Microsoft Teams such as preinstalling it for users using policies, please visit [Microsoft Learn](https://learn.microsoft.com/en-us/microsoftteams/manage-apps).

{% hint style="info" %}
Once the Microsoft Teams integration is complete, you'll want to add [Swarmia to channels](/settings/integrations/messaging-apps/microsoft-teams/adding-swarmia-to-a-microsoft-teams-channel.md) and configure your [Team Notifications](/settings/team/team-notifications.md).
{% 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.swarmia.com/settings/integrations/messaging-apps/microsoft-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.