> For the complete documentation index, see [llms.txt](https://docs.perfectscale.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perfectscale.io/customize-workflow/communication-and-messaging/ms-teams-integration.md).

# MS Teams Integration

By integrating Teams, the process of managing Alerts in clusters becomes more efficient. This feature enables users to promptly receive notifications on the designated Teams channel whenever alerts are produced.

<figure><img src="/files/hsVfLRgawwErgn6qRvH6" alt=""><figcaption><p>MS Teams profile</p></figcaption></figure>

## Configuring Teams integration with the profile

### :tools: **How to create Teams Profile**

There are two options for creating a Profile: [from the Settings tab](#from-the-settings-tab) or directly from the Overview.

#### From the **Settings** tab

Go to the **`Settings`** tab on the left panel -> select **`Integrations`** -> click the **`+Add Integration`** button and select **`Teams`** from the drop-down -> insert [teams\_webhook](/customize-workflow/communication-and-messaging/ms-teams-integration/how-to-configure-teams_webhook.md) -> click **`Save`** button.

<figure><img src="/files/YMBWKE4A3eCpDCNyQkgP" alt=""><figcaption><p>MS Teams profile from settings</p></figcaption></figure>

#### From the **Overview** tab

Go to the **`Overview`** tab on the left panel -> find the cluster to which you want to apply the **`Profile`** and click **`gear`** button -> go to **`Customizations`** -> find **`Integrations`** and click the **`Communication & Messaging`** drop-down list -> click the **`Add New Profile`** button and select **`Teams`** -> insert [teams\_webhook](/customize-workflow/communication-and-messaging/ms-teams-integration/how-to-configure-teams_webhook.md) -> click **`Save And Apply`** button.

<figure><img src="/files/tvNRFX9KqAE0iAF6ABoi" alt=""><figcaption><p>MS Teams profile from overview</p></figcaption></figure>

### :tools: **How to apply** Teams **Profile**

#### Apply to a single cluster

To apply **`Teams Profile`** to the cluster, go to the **`Overview`** tab on the left panel -> find the cluster to which you want to apply the **`Teams Profile`** and click **`gear`** button -> go to **`Customizations`** -> select the needed profile in the **`Communication & Messaging`** drop-down list.&#x20;

<figure><img src="/files/86udORyobjbRl85QLtnj" alt=""><figcaption><p>Applying MS Teams profile to a single cluster</p></figcaption></figure>

#### Apply to multiple clusters

To apply the profile to **multiple clusters** from a single view, use the **`Manage Assignments`** feature.&#x20;

Go to the **`Settings`** tab on the left panel -> select the **`Integrations`** -> click the **`Manage Assignments`** button -> go to **`Communication & Messaging`** section and apply the profiles for the needed clusters -> click the **`Save Changes`** button.

<figure><img src="/files/VcJdOTtdyfX98ojrYgK3" alt=""><figcaption><p>Applying MS Teams profile to multiple clusters</p></figcaption></figure>

## Configuring Teams integration with CR

To enable Teams alerts, you need to define and apply a Custom Resource (CR) with the required parameters. This approach allows you to manage Teams alerting directly through Kubernetes manifests.&#x20;

{% hint style="warning" %}
The Custom Resource (CR) must be created in the `perfectscale` namespace.
{% endhint %}

### Setup instructions

{% stepper %}
{% step %}
**Configure teams\_webhook**

If you haven't completed this configuration before, follow the detailed instructions [here](/customize-workflow/communication-and-messaging/ms-teams-integration/how-to-configure-teams_webhook.md).
{% endstep %}

{% step %}
**Apply teams\_webhook**

```yaml
apiVersion: v1
kind: Secret
metadata:
  name: teams-credentials
  namespace: perfectscale
type: Opaque
stringData:
  webhook-url: "https://defaultabc.ab.environment.api.powerplatform.com/abc"
```

{% hint style="info" %}
Ensure that the secret is created in the same namespace as the exporter -  `perfectscale`.
{% endhint %}
{% endstep %}

{% step %}
**Configure the CR**

```yaml
apiVersion: perfectscale.io/v1
kind: ClusterSettings
metadata:
  name: cluster-settings-main
  namespace: perfectscale
spec:
  profiles:
    integrations:
      - type: teams
        name: ops-team-notifications
        assigned: true
        value:
          teams_webhook_from:
            secretKeyRef:
              name: teams-credentials
              key: webhook-url
```

⚙️ **CR parameters:**

<table><thead><tr><th width="251.94921875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong><code>teams_webhook_from</code></strong></td><td>A secret that permits PerfectScale to interact with your Teams. Learn how to configure <a href="/pages/z5LV91GcTyChAuI5nT22">teams_webhook here</a>.</td></tr></tbody></table>
{% endstep %}
{% endstepper %}

&#x20;

## Teams Integration Verification

To verify the accuracy of your MS Teams configuration, simply click on the **`Test Integration`** button. When the configuration is correct, you will see the message **`Teams Configured Correctly`**. In case of **`Teams Configured Wrongly`** response, check and ensure that the  [`teams_webhook`](/customize-workflow/communication-and-messaging/ms-teams-integration/how-to-configure-teams_webhook.md) URL is correct.

<figure><img src="/files/yOLlM8hxX5869CDwYlDj" alt=""><figcaption><p>MS Teams integrations verification</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.perfectscale.io/customize-workflow/communication-and-messaging/ms-teams-integration.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.