> For the complete documentation index, see [llms.txt](https://help.swarmia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.swarmia.com/settings/integrations/messaging-apps/microsoft-teams.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.swarmia.com/settings/integrations/messaging-apps/microsoft-teams.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.