# Microsoft Teams

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

![Cypress Tests Results in Microsoft Teams](/files/P3b7nm4ccey6syKbj5dN)

### How to enable Microsoft Teams integration?

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

* Navigate to "Manage Project" section for the selected project
* Click "Add Integration", and select "Microsoft Teams"
* Enter the details of your Microsoft Teams Integration and click "Save"
* 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="/files/ZnEIA6cuTXocXnGwb5yl" media="(prefers-color-scheme: dark)"><img src="/files/vsmLHM8Oi93c0aSSYmJj" 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](/files/hx4nRt71C8cobWIlCS5L)

#### **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](/files/7zifRlatkAdJJOcWMd4f)

![Example of MS Teams notification for Cypress Run Finished with Timeout event](/files/2JPnnJpaPaANquSHbirw)

#### 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](/files/03keLVWe4xVc5Re6g8o8)

### 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.


---

# 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.currents.dev/resources/integrations/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.