# Microsoft Teams

This plugin allows you to send a notification to your MS Teams channel.

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2F9yGOoJErak3jhrUZEzPJ%2FCleanShot%202025-02-13%20at%2014.07.43%402x.png?alt=media&#x26;token=9c420390-1010-4e2e-ade7-fcf6bb1e1165" alt=""><figcaption></figcaption></figure>

**Configuration options**

1. Task name: This name will be visible in the pipeline later when it is executed.
2. Title: title of the message that will be posted to the Teams channel.
3. Message: text to be sent.
4. Webhook URL of your MS Teams channel.
5. Hide pipeline URL: Do not add the button with link to the pipeline in the adaptive card of the message displayed in the Teams channel.
6. Ignore failure: if enabled, the execution of the following stage will be triggered even if the task fails.
7. Require approval: means that this task will not be executed until approved by people added in the approvers' list.
   * The task remains blocked until all approvers added in the list approve it.
   * When enabled, it allows you to add approvers to the list<br>

     <figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FZKgvnPvOoj5vM7zhSMGV%2FCleanShot%202025-07-10%20at%2013.25.53%402x.png?alt=media&#x26;token=c0edd24a-3b3c-4062-b4fa-45852a04615c" alt=""><figcaption></figcaption></figure>
   * The approver has to be Brainboard user

#### Setup instructions

If you want to configure Microsoft Teams to receive notifications from Brainboard pipelines, an *incoming hook* needs to be set up in the channel of your choice. To do so, follow the steps:

1. Go to your Teams channel where you want the notification to be posted and open its configuration menu in the top-right corner and click on "Workflows":<br>

   <figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2F6ofVgV2NGTYzT23KZC5u%2FCleanShot%202025-02-13%20at%2014.56.13%402x.png?alt=media&#x26;token=b8737316-4214-4e07-88bb-8a6d596d5d75" alt=""><figcaption></figcaption></figure>

2. This will open the workflows configuration wizard. Search and select the line "Post to a channel when a webhook request is received":

   <figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FUg8nfHwEAehZma9UO5qD%2FCleanShot%202025-02-13%20at%2014.56.30%402x.png?alt=media&#x26;token=a8e69f04-cf66-4e91-a448-66d634d4b7e1" alt=""><figcaption></figcaption></figure>

3. Give it a name and click Next:<br>

   <figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FFeut7bUB7Vtf6AyvJGbO%2FCleanShot%202025-02-13%20at%2014.56.50%402x.png?alt=media&#x26;token=c4017d09-9460-484e-a466-d7f9abb07d72" alt=""><figcaption></figcaption></figure>

4. Select the channel where you want the notification to be posted:<br>

   <figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FeBBe6OWLHgx7C2HdXND8%2FCleanShot%202025-02-13%20at%2014.57.07%402x.png?alt=media&#x26;token=72fd154b-09f5-423a-8759-64ded8aeeb2b" alt=""><figcaption></figcaption></figure>

5. Copy the generated webhook URL to use in Brainboard:<br>

   <figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FGW6VjnM1NViaSOURmXxE%2FCleanShot%202025-02-13%20at%2014.57.18%402x.png?alt=media&#x26;token=c2fd13f9-ea4c-4d84-9de7-120d1d0d3ab3" alt=""><figcaption></figcaption></figure>

If you have an old configuration, follow the steps of this video:

{% embed url="<https://www.youtube.com/watch?v=LOvWCNyXxLE>" %}

{% hint style="warning" %}
&#x20;That configuration is deprecated by Azure and will be removed by the end of 2025.
{% endhint %}