> ## Documentation Index
> Fetch the complete documentation index at: https://docs.synq.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Teams

Current capabilities:

* Integrate with the Coalesce Quality app on Microsoft Teams.
* Set up the MS Teams integration.
* Add MS Teams channels and mentions in owners.
* Receive alerts for new issues.

# Setup

* Ask your Teams admin to install the app available [here](https://github.com/getsynq/releases/raw/main/msteams/coalesceQuality-v1.2.0.zip). There are various options for app installation. The easiest would be to directly install it on the team you wish to integrate with for alerts.
  <img src="https://mintcdn.com/synq-15/W5wQ1KC16xJvhnfC/images/slack/msteams/manage-team.png?fit=max&auto=format&n=W5wQ1KC16xJvhnfC&q=85&s=4d0f5e7dc4af1456ac5df234a36ff1e4" alt="manage-team" width="432" height="605" data-path="images/slack/msteams/manage-team.png" />
  <img src="https://mintcdn.com/synq-15/W5wQ1KC16xJvhnfC/images/slack/msteams/upload-app.png?fit=max&auto=format&n=W5wQ1KC16xJvhnfC&q=85&s=db917b7e7ab2a2b3252ca4828dfaf028" alt="upload-app" width="558" height="213" data-path="images/slack/msteams/upload-app.png" />
  <img src="https://mintcdn.com/synq-15/W5wQ1KC16xJvhnfC/images/slack/msteams/add-synq.png?fit=max&auto=format&n=W5wQ1KC16xJvhnfC&q=85&s=d9bca31a55290312263cb70b7c257d08" alt="add-synq" width="404" height="204" data-path="images/slack/msteams/add-synq.png" />

* Add an integration on the [settings page](https://app.synq.io/settings/integrations). Select `MS Teams` from the list of platforms. You will need to enter the team URL to create the integration. Once you enter the correct URL, hit `Create` to finalize the creation.
  <img src="https://mintcdn.com/synq-15/W5wQ1KC16xJvhnfC/images/slack/msteams/add-integration.png?fit=max&auto=format&n=W5wQ1KC16xJvhnfC&q=85&s=1ea170e8942e00d2fe1620ab35ad3ddc" alt="add-integration" width="277" height="50" data-path="images/slack/msteams/add-integration.png" />
  <img src="https://mintcdn.com/synq-15/W5wQ1KC16xJvhnfC/images/slack/msteams/choose-ms-teams.png?fit=max&auto=format&n=W5wQ1KC16xJvhnfC&q=85&s=71ab3770be822f5eb2896fa2c4362deb" alt="choose-ms-teams" width="608" height="567" data-path="images/slack/msteams/choose-ms-teams.png" />
  <img src="https://mintcdn.com/synq-15/W5wQ1KC16xJvhnfC/images/slack/msteams/get-link.png?fit=max&auto=format&n=W5wQ1KC16xJvhnfC&q=85&s=a98891e9f5f766f497c2346c1beb6b5e" alt="get-link" width="370" height="551" data-path="images/slack/msteams/get-link.png" />
  <img src="https://mintcdn.com/synq-15/W5wQ1KC16xJvhnfC/images/slack/msteams/create-integration.png?fit=max&auto=format&n=W5wQ1KC16xJvhnfC&q=85&s=1453de02e7e497bfe3782f5b2e900384" alt="create-integration" width="775" height="258" data-path="images/slack/msteams/create-integration.png" />

# Creating or Editing Owners

To receive notifications on a Teams channel, you will need to create an owner with the channel configured or update an existing owner with the Teams channel. The following steps apply to either scenario.

* Choose `Add Owner` or `Edit` from the owner's menu.
  <img src="https://mintcdn.com/synq-15/W5wQ1KC16xJvhnfC/images/slack/msteams/add-owner.png?fit=max&auto=format&n=W5wQ1KC16xJvhnfC&q=85&s=eada58cd8e0332d691a85601846b7ac2" alt="add-owner" width="193" height="61" data-path="images/slack/msteams/add-owner.png" />
  <img src="https://mintcdn.com/synq-15/W5wQ1KC16xJvhnfC/images/slack/msteams/edit-owner.png?fit=max&auto=format&n=W5wQ1KC16xJvhnfC&q=85&s=7e4526299d0929f7bb668a467e92b38e" alt="edit-owner" width="1241" height="141" data-path="images/slack/msteams/edit-owner.png" />

* Under the section `MS Teams` click `@ Add teams` to enable Teams for the owner. You can then select a channel from the configured Team and optionally add mentions for channel members.
  <img src="https://mintcdn.com/synq-15/W5wQ1KC16xJvhnfC/images/slack/msteams/add-teams.png?fit=max&auto=format&n=W5wQ1KC16xJvhnfC&q=85&s=97b635d1a13843050d57e237e34faba6" alt="add-teams" width="1053" height="92" data-path="images/slack/msteams/add-teams.png" />
  <img src="https://mintcdn.com/synq-15/W5wQ1KC16xJvhnfC/images/slack/msteams/add-channel.png?fit=max&auto=format&n=W5wQ1KC16xJvhnfC&q=85&s=dacbb7c812677f6d54ee54bee37a7040" alt="add-channel" width="1059" height="166" data-path="images/slack/msteams/add-channel.png" />

* Once you confirm the create or edit, all alerts configured for the owner will land on the selected Teams channel! 🎉

# Troubleshooting

* If you do not see the option for `MS Teams` while creating or editing an owner, you might not have added the integration. Please setup the bot and integration before trying to edit / create owners.
* If the MS Teams option is disabled, the bot might not be correctly installed on your Team. Contact your Teams admin to set up the bot as per the guide above.