# Microsoft Teams

SimplifyQA offers seamless integration with Microsoft Teams to deliver real-time notifications and collaboration capabilities directly within your team’s communication channels. This integration helps keep your team updated on test execution statuses, failures, approvals, and more — all within the familiar Teams environment.

### Prerequisites

* An active Microsoft Teams account with appropriate permissions to create or configure channels.
* SimplifyQA admin access to configure integrations.

### Purpose of Integration

* Enable real-time notifications for test executions, failures, and other key events within Microsoft Teams.
* Improve productivity by reducing context switching between SimplifyQA and Teams.

### Setting up the Integration in Microsoft Teams

1. Launch the Microsoft Teams desktop or web application.
2. In the lower-left corner of the Teams interface, click on **Apps.**
3. Under the section **Built for your org**, locate the app named SimplifyQA or search for the app name.

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

4. Click **Add** next to the app.
5. A pop-up will appear displaying a list of channels and chats where the app can be installed.
6. Select **one channel or chat** at a time where you want to receive notifications.

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

7. After adding the app, a welcome message will appear in the selected Teams channel or chat.
8. This message will contain the **Conversation ID** (also known as the Chat ID).
9. **Copy this Conversation ID** — it will be required to configure the integration in SimplifyQA.

### Configuring SimplifyQA for Teams Integration

1. Access SimplifyQA using your admin credentials.
2. Click on the **Marketplace** section from the main menu.
3. Search for **Teams** in the Marketplace.
4. Click on the **Configure** button under the Teams integration tile.

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

5. Click on **+ Add Teams Webhook** to start the configuration.
6. Enter the required details:
   * **Name**: Provide a recognizable name for this integration (e.g., “Project A Notifications”).
   * **Teams Conversation ID**: Paste the Conversation ID you copied from Teams.
   * **Notification Types**: Choose the types of notifications you’d like to receive in Teams, such as:
     * Test Execution Status
     * Failure Alerts

SimplifyQA offers seamless integration with Microsoft Teams to deliver real-time notifications and collaboration capabilities directly within your team’s communication channels. This integration helps keep your team updated on test execution statuses, failures, approvals, and more — all within the familiar Teams environment.

### Prerequisites

* An active Microsoft Teams account with appropriate permissions to create or configure channels.
* SimplifyQA admin access to configure integrations.

### Purpose of Integration

* Enable real-time notifications for test executions, failures, and other key events within Microsoft Teams.
* Improve productivity by reducing context switching between SimplifyQA and Teams.

### Setting up the Integration in Microsoft Teams

1. Launch the Microsoft Teams desktop or web application.
2. In the lower-left corner of the Teams interface, click on **Apps.**
3. Under the section **Built for your org**, locate the app named **QA-teams-appdev**.

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

4. Click **Add** next to the app.

<figure><img src="/files/D09V2KcoIjquRRT6Ko5P" alt="" width="563"><figcaption></figcaption></figure>

5. A pop-up will appear displaying a list of channels and chats where the app can be installed.
6. Select **one channel or chat** at a time where you want to receive notifications.

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

7. After adding the app, a welcome message will appear in the selected Teams channel or chat.
8. This message will contain the **Conversation ID** (also known as the Chat ID).
9. **Copy this Conversation ID** — it will be required to configure the integration in SimplifyQA.

### Configuring SimplifyQA for Teams Integration

1. Access SimplifyQA using your admin credentials.
2. Click on the **Marketplace** section from the main menu.
3. Search for **Teams** in the Marketplace.
4. Click on the **Configure** button under the Teams integration tile.

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

5. Click on **+ Add Teams Webhook** to start the configuration.
6. Enter the required details:
   * **Name**: Provide a recognizable name for this integration (e.g., “Project A Notifications”).
   * **Teams Conversation ID**: Paste the Conversation ID you copied from Teams.
   * **Notification Types**: Choose the types of notifications you’d like to receive in Teams, such as:
     * Test Execution Status
     * Failure Alerts

<figure><img src="/files/49qOoCwYyEPABBYvoBOo" alt="" width="541"><figcaption></figcaption></figure>

7. Click **Save** to finalize the configuration.
8. Once saved, notifications from SimplifyQA will start flowing into the selected Teams channel or chat based on your chosen settings.

{% hint style="success" %}
**Key Points to Note**

* One Channel at a Time: Each integration setup supports notifications to a single Teams channel or chat. For multiple channels, repeat the process and add additional webhooks as needed.
* Notification Types: Choose carefully to avoid spamming the channel with too many notifications.
* Access Control: Ensure only authorized users manage Teams integrations to prevent unauthorized information sharing.
  {% endhint %}

With this integration, your team can stay updated on testing activities without switching between tools. Ensure timely and relevant notifications in your preferred Teams channels, fostering collaboration and improving test management efficiency.


---

# 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://docs.simplifyqa.ai/marketplace/integrating-with-collaboration-tools/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.
