# Microsoft Teams

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

<figure><img src="/files/oMLZqUKZcsnSx0QGcxPU" 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="/files/0838xuaB3y6QzvXCMeMd" 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="/files/6xTw27vfQGYrzmntYYhD" 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="/files/1TGl55pxlxlipKBrbxNn" alt=""><figcaption></figcaption></figure>

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

   <figure><img src="/files/fzHcQFjANY6BB99bFm31" alt=""><figcaption></figcaption></figure>

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

   <figure><img src="/files/qO2D5BvSKJIghaljoZnN" alt=""><figcaption></figcaption></figure>

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

   <figure><img src="/files/UJ8dVKzd8r1BNLbzqjWs" 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 %}


---

# 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.brainboard.co/automation/supported-plugins/notifications/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.