# Install and set up Microsoft Teams

Copy as Markdown[Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fcoralogix.com%2Fdocs%2Fuser-guides%2Fnotification-center%2Fdestination-types%2Fmsteams%2Finstall.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fcoralogix.com%2Fdocs%2Fuser-guides%2Fnotification-center%2Fdestination-types%2Fmsteams%2Finstall.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)

Set up Microsoft Teams for Coralogix in three stages: a Teams administrator installs the Coralogix app in your tenant, you set up the integration in Coralogix, then you create a connector for a channel.

Note

The Microsoft Teams connector is in private beta. To request access and the app package, contact your Coralogix account team (TAM) or Support.

## Why set up Microsoft Teams[​](#why-set-up-microsoft-teams "Direct link to Why set up Microsoft Teams")

Connecting Microsoft Teams routes Coralogix alert and Case notifications into the channels your team already works in, so incidents surface where people are instead of in a separate tool. The native app also replaces the retired Office 365 incoming webhooks that older Teams notifications relied on, and it reflects the full Case lifecycle (assign, acknowledge, resolve, and close) in the channel in near real time. Set it up once (install, integrate, connect), and every router can send to Teams like any other destination.

## Install the app in Teams[​](#install-the-app-in-teams "Direct link to Install the app in Teams")

Only a Microsoft Teams administrator can install the app in the tenant.

1. Ask your Coralogix TAM for the app ZIP file.

2. In Microsoft Teams, go to **Apps**, then **Manage your apps**, then **Upload an app**.

3. Select **Upload an app to your org's app catalog**. If you are not an admin, you can submit it for an admin to approve.

4. Add the app to each Team where you want to use it:

   <!-- -->

   1. Select the three-dots menu next to the team name, then **Manage team**.
   2. Select **Apps**, then **Get more apps**.
   3. Select **Coralogix** from the **Built for your org** section.
   4. Select the **General** channel of the target team. This installs the app for all public channels in that team.
   5. Repeat for every team you want the app to work in.

[![Uploading the Coralogix app to your organization\&#39;s app catalog in Microsoft Teams](/docs/assets/images/msteams-upload-to-org-catalog-4dba0f78f2c81e9c50141fad5424a325.png)](https://coralogix.com/docs/docs/assets/images/msteams-upload-to-org-catalog-4dba0f78f2c81e9c50141fad5424a325.png)

[![Adding Coralogix to a team from the Built for your org section in Microsoft Teams](/docs/assets/images/msteams-select-coralogix-built-for-org-71315d42ad299ba928cf5b92fc31db3d.png)](https://coralogix.com/docs/docs/assets/images/msteams-select-coralogix-built-for-org-71315d42ad299ba928cf5b92fc31db3d.png)

## Set up the integration in Coralogix[​](#set-up-the-integration-in-coralogix "Direct link to Set up the integration in Coralogix")

1. Go to the **Integrations** page.

2. Select **Microsoft Teams** (not Olly).

3. Select **Add New**.

4. Enter a name. If you want two-way sync, select it (it activates for this integration once that feature ships), and consent to US data transfer.

5. Authorize the integration. This step requires a Microsoft Teams administrator:

   <!-- -->

   * **If you are a Teams admin:** select **Authorize** and consent to the requested permissions.
   * **If you are not:** send the authorization link to your Teams admin to approve (the same admin who approves the uploaded app package).

6. Create connectors here or from Notification Center.

[![Selecting Microsoft Teams, not Olly, on the Coralogix Integrations page](/docs/assets/images/msteams-select-microsoft-teams-4e23c11aaa34f7ff1e54a485b396ab93.png)](https://coralogix.com/docs/docs/assets/images/msteams-select-microsoft-teams-4e23c11aaa34f7ff1e54a485b396ab93.png)

[![The Microsoft Teams integration setup with the name, two-way sync option, and US data transfer consent](/docs/assets/images/msteams-integration-setup-a9559449c26387915836b21223b5299b.png)](https://coralogix.com/docs/docs/assets/images/msteams-integration-setup-a9559449c26387915836b21223b5299b.png)

## Create a connector[​](#create-a-connector "Direct link to Create a connector")

A connector links to a single Microsoft Teams channel. The app must already be added to the team, and for a private channel you must add the app to that channel.

1. Go to **Notification Center**, then **Connectors**, and select **+ Microsoft Teams**.

2. Select the integration. It is pre-filled if you have only one.

3. Set the channel by pasting a channel link, or by entering the Team ID and Channel ID directly:

   <!-- -->

   * To get the link, select the three-dots menu next to the channel name, then **Copy link**, and paste it into the field.
   * To enter IDs manually, the Team ID is the `groupId` query parameter in the link, and the Channel ID is the segment between `channel` and the channel name.

4. Select whether updates reply in the thread.

[![The Microsoft Teams connector configuration in Coralogix, showing the integration, channel-selection modes, channel link field, and the Reply in thread toggle](/docs/assets/images/msteams-create-connector-37decb8c33339f67de857da893ad9c6a.png)](https://coralogix.com/docs/docs/assets/images/msteams-create-connector-37decb8c33339f67de857da893ad9c6a.png)

## FAQ[​](#faq "Direct link to FAQ")

How do I use a connector with a private channel?

The app can only post to a private channel it belongs to. Add it from the channel: open **Manage channel**, select **Coralogix**, then select **Add**. You can then use that channel's ID in a connector.

What should I do when the app is available in the Marketplace?

Once the app is published to the Microsoft Teams Marketplace, move your installation to the Marketplace version so you receive future updates. A Teams administrator uninstalls the manually uploaded app, then installs the Marketplace one:

1. Remove the current app: search for **Coralogix**, select it, then select **Actions**, then **Delete**.
2. Install the Marketplace app: search for **Coralogix**, then install it.
3. Re-add the app to the required teams and channels.

You do not need to re-create the integration in Coralogix.

## Related resources[​](#related-resources "Direct link to Related resources")

[Microsoft Teams destination](https://coralogix.com/docs/docs/user-guides/notification-center/destination-types/msteams/.md)[Routing rules](https://coralogix.com/docs/docs/user-guides/notification-center/routing/define-routing-rule/.md)
