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

# Microsoft Teams

> Receive QA.tech notifications in Microsoft Teams channels

The Microsoft Teams integration sends automated test run notifications directly to your Teams channels using incoming webhooks. This is a notification-only integration - you'll receive alerts when test runs complete. This integration does not support interactive features or API overrides.

## Setup

<Steps>
  <Step title="Create a Workflow in Microsoft Teams">
    In Microsoft Teams, open the option menu on the channel where you want to receive notifications, then select **Workflows** from the menu.

    <Frame>
      <img src="https://mintcdn.com/qatech/R5FU27qK0zAopS8t/images/workflow-teams-example.png?fit=max&auto=format&n=R5FU27qK0zAopS8t&q=85&s=9c3414292706d6eed87a53fa3ecefaf4" alt="Microsoft Teams channel menu showing the Workflows option" width="998" height="746" data-path="images/workflow-teams-example.png" />
    </Frame>

    Select the **"Send webhook alerts to a channel"** template. This creates a workflow that posts messages to your channel when it receives a webhook request.

    Once the workflow is created, you'll see a dialog with a webhook URL. Copy this URL - you'll need it for the next step.

    <Tip>
      For detailed instructions on creating incoming webhooks in Microsoft Teams, see [Microsoft's official documentation](https://support.microsoft.com/en-us/office/create-incoming-webhooks-with-workflows-for-microsoft-teams-8ae491c7-0394-4861-ba59-055e33f75498).
    </Tip>

    <Note>
      If the **Workflows** option is not available in your channel menu, you can also create the webhook workflow from the [Workflows app in Microsoft Teams](https://support.microsoft.com/en-us/office/browse-and-add-workflows-in-microsoft-teams-4998095c-8b72-4b0e-984c-f2ad39e6ba9a). Search for the **"Send webhook alerts to a channel"** template and follow the setup steps.
    </Note>
  </Step>

  <Step title="Configure in QA.tech">
    Go to [**Settings → Integrations**](https://app.qa.tech/current-project/settings/integrations) in your QA.tech project. Find the **Microsoft Teams** section and paste the webhook URL you copied from Teams.

    Click **Save** to enable the integration.

    After saving, you can use the **Send Test Notification** button to verify your webhook is working correctly.
  </Step>
</Steps>

## What You Get

Each notification includes:

* **Run status** - Pass or fail indication
* **Test plan name** - If the run was part of a test plan
* **Timing** - When the run started and total duration
* **Error tests** - Breakdown of any tests that encountered errors
* **Failed tests** - Breakdown of any tests that failed
* **Skipped tests** - Breakdown of any tests that were skipped
* **Results link** - Direct link to the full test report in QA.tech

You'll receive a notification for every completed run, whether triggered manually, through CI/CD, or via schedule.

## Troubleshooting

### Notifications not appearing

* Verify the webhook URL is correct and hasn't expired
* Check that the workflow in Microsoft Teams is still active
* Ensure the channel still exists and the workflow has permission to post

### Need to update the webhook URL

If you need to regenerate or change your webhook URL:

1. Open the Workflows app in Microsoft Teams
2. Find your webhook workflow and select **Edit**
3. Expand the trigger **"When a Teams webhook request is received"** to copy the URL
4. Update the URL in QA.tech under **Settings → Integrations**