# Microsoft Teams

Currents integration with Microsoft Team allows posting test results of your Cypress tests directly into MS Teams channels.

![Cypress Tests Results in Microsoft Teams](https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2F0dqTxjz8ebM9bkDBq30p%2Fcypress-msteams-example.png?alt=media\&token=150d573f-1179-4128-9d08-dfe618e2de49)

### How to enable Microsoft Teams integration for Cypress tests?

In order to enable MS Teams integration and share cypress test results to Teams channels, follow the steps:

* Navigate to **Manage Project > Integrations**
* Add Microsoft Teams integration and provide the details:
  * **Microsoft** **Teams Webhook URL -** Incoming Webhook URL, e.g. `https://currents463.webhook.office.com/XXX/YYY/ZZZ`. [Read the guide](https://support.microsoft.com/en-us/office/create-incoming-webhooks-with-workflows-for-microsoft-teams-8ae491c7-0394-4861-ba59-055e33f75498) to generate the URL.
  * **Failed Runs Only** - enabling the toggle would only send results for failed runs.
  * **Events (Optional)** - specify events that will trigger the integration and send the results. Leaving this field blank activates all the events.
* Click **Save** to preserve the changes

<div data-with-frame="true"><picture><source srcset="https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2FJnYizb9Y5DHNv5dlTBRH%2FScreenshot%202026-03-05%20at%203.09.45%E2%80%AFPM.png?alt=media&#x26;token=d09fc793-de70-411a-ad60-129f98f9383b" media="(prefers-color-scheme: dark)"><img src="https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2FW6yMwwSruTIpL2uXeNfN%2FScreenshot%202026-03-05%20at%203.08.19%E2%80%AFPM.png?alt=media&#x26;token=355f5b2e-a76e-4382-8973-513f370de3ab" alt="Enabling Microsoft Teams Slack integration"></picture></div>

### Filtering MS Teams notifications based on Tags

{% hint style="info" %}
**Please note:** We use [glob patterns](https://www.npmjs.com/package/micromatch) to evaluate the filters. Test your filtering rules using the [playground](https://currents-branch-filter.stackblitz.io/). See examples for some popular filter patterns:

* Include only **`tagA`** or **`tagB`**: `(tagA|tagB)`
* Exclude **`tagA`** an&#x64;**`tagB`**`: !(tagA|tagB)`
* Include only tags starting with **`production`**: `production*`
* Include only tags starting with **`smoke-`** or **`prod-`**`: (smoke-*|prod-*)`
  {% endhint %}

### What events trigger notifications for MSTeams // Currents integration?

The following events trigger notifications for Microsoft Teams integration.

#### **Run Start**

It is triggered when a new run starts. If a run contains multiple groups, the notification will be triggered for each group.

![Example of MS Teams notification for Cypress Run Start event](https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2FwPJFV4TqDaPeeXDAzULZ%2Fcypress-msteams-run-start.png?alt=media\&token=917c92da-78c2-4a88-8c69-c37558645208)

#### **Run Finish**

It is triggered when a run finishes its execution or when a run times out. If a run contains multiple groups, the notification will be triggered for each group. For timed out runs, the message will contain the last know results for the run or run group.

![Example of MS Teams notification for Cypress Run Finished](https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2Fcwf1SVvWX42L0JgWSKro%2Fcypress-run-canceled-slack.png?alt=media\&token=b0063ebd-6b3e-4910-83f3-5776dcfcfc54)

![Example of MS Teams notification for Cypress Run Finished with Timeout event ](https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2FJwsYtDthsq0RHfhv7bO5%2Fcypress-msteams-run-timedout.png?alt=media\&token=b43a36b3-99de-4c0a-aa2e-4871e3de53f4)

#### Run Canceled

Triggered when a run gets cancelled. If a run contains multiple groups, the notification will be triggered for each group. The message will contain the last know results for the run or run group.

![Example of MS Teams notification for Cypress Run Canceled event ](https://3745692499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqmFDEiUa9mr11LUlxDnt%2Fuploads%2Fgyqaeszt04at8lbSIrVN%2Fcypress-teams-run-canceled.png?alt=media\&token=9ba33bce-ae08-446d-a292-5680e3328561)

### How to disable MS Teams integration?

To disable Microsoft Teams integration, simply delete the integration from the list of integrations.

### FAQ

#### Can I have multiple MS Teams integration for the same project?

Yes, you can have multiple Microsoft Teams integrations for the same project.