# Create a channel for an existing alert in Microsoft Teams

{% hint style="info" %}
**Connect your Microsoft Teams workspace with ilert first**

Before you proceed, please make sure that a global admin has connected your Microsoft Teams workspace with your ilert account (as described in our [integration for Microsoft Teams guide](https://docs.ilert.com/chatops/chat#install-the-ilert-bot-application))
{% endhint %}

Our Microsoft Teams connector allows you to create a channel to an existing alert in Microsoft Teams, making it even easier for your team to discuss incidents in a more isolated environment.

## Creating a Microsoft Teams channel

1. On the alert list, navigate to the desired alert for which you want to create a channel.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F3GsWIfC8JRtMmdCov3z0%2FScreenshot%202023-08-09%20at%2013.59.06.png?alt=media&#x26;token=46607ade-645a-4878-879b-2fb7ee0aab9d" alt=""><figcaption></figcaption></figure>

2. Now select a desired **Channel group** (Team) and enter a channel name.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FDP5gUoVbNjzq6E5SVoWx%2FScreenshot%202023-08-09%20at%2014.06.55.png?alt=media&#x26;token=e0a488b8-e0df-4ee4-9bf5-5a426130f9d8" alt="" width="367"><figcaption></figcaption></figure>

{% hint style="info" %}
Channel names are generated in advance and consist of the name of the alert source and the alert ID. If you want to choose another name, please make sure that you use a channel name that does not exist.
{% endhint %}

3. Click on **Create MS-Teams** channel to execute the channel creation and alert posting.
4. You can now view the created channel by clicking on **View MS-Teams channel**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FGf5oSB06O81MLcQnNexe%2FScreenshot%202023-08-09%20at%2014.15.45.png?alt=media&#x26;token=418ac821-5cef-432e-9e4a-e5c9eb3e4275" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FpfQuFArtNz0fe7BjCP0c%2FScreenshot%202023-08-09%20at%2014.21.03.png?alt=media&#x26;token=295394d7-477a-4f97-a9e8-6fbc3ba545ac" alt=""><figcaption></figcaption></figure>

{% embed url="<https://www.youtube.com/watch?v=xwY6jz8sV4M>" %}
Check out our step-by-step tutorial on Youtube
{% endembed %}

## Detaching a Microsoft Teams channel from an alert

1. On the alert list, navigate to the desired alert for which you want to detach a channel.
2. Hover over the **View MS-Teams channel** area and click on the small "x"

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F6YmKnSVh9kePKbHZzBPc%2FScreenshot%202023-08-09%20at%2014.16.07.png?alt=media&#x26;token=14c2f92d-603f-4239-801a-239a5c295477" alt=""><figcaption></figcaption></figure>

3. After detaching an alert from a channel, a message will be sent to the detached channel.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FLQKp09TLLgJS5dp1rbq0%2FScreenshot%202023-08-09%20at%2014.21.22.png?alt=media&#x26;token=6988fc3b-deaa-4fb2-b2a6-89ab5056c4d4" alt=""><figcaption></figcaption></figure>

## FAQ

### **Are the alerts in the created channel updated in real time?**

Yes, as long as the channel is not detached the alert will receives real time updates in threads.

### **The ilert bot has no permission to create a channel.**

If your ilert bot for Microsoft Teams bot has no permission. Please reauthorize your bot.


---

# 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.ilert.com/chatops/microsoft-teams/create-a-channel-for-an-existing-alert-in-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.
