# Integration for Microsoft Teams

You can integrate IncidentHub with Microsoft Teams to receive notifications in your chosen channel. IncidentHub sends these notifications using AdaptiveCards.

IncidentHub will send messages to your Teams channels when any of the following happens:

1. An incident or maintenance is triggered, updated, or resolved in any of your monitored services.
2. An upcoming maintenance reminder is triggered based on your chosen time interval.

## In Your Microsoft Teams Account

1. Login to your Microsoft account and click on "Teams and channels" on the left sidebar.

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

2. Click on the 3 dots (...) next to the channel you wish to receive notifications in.
3. Click on "Workflows" in the menu.
4. In the popup window, search for "webhook" and choose the template "Send webhook alerts to a channel".

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

5. Put a descriptive name for the workflow.

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

6. Confirm the Team and the Channel name.

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

7. Click on Add workflow.
8. Copy the HTTPS URL on the next screen. You will use it in the next steps.

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

## In Your IncidentHub Account

1. Login to your IncidentHub account and click on Channels -> Add -> Microsoft Teams.
2. Add a Name and and a Description.
3. Under "Microsoft Teams Workflow URL", paste the URL that you had copied earlier.

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

4. To ensure the URL is valid and IncidentHub is able to connect to it, you can click on "Send a test message". This will send a test notification to your Microsoft Teams channel.
5. Click Save.

## Understanding Notifications

A Microsoft Teams notification sent by IncidentHub looks like this:

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

The colored bar on the left indicates the type of the notification.&#x20;

The different color codes are:

<div align="center" data-full-width="false"><figure><img src="/files/Xr1sNVwthBPHTFxcjQjN" alt=""><figcaption><p>Incident triggered or updated</p></figcaption></figure></div>

<div align="center"><figure><img src="/files/vqNvCYqbn1Taw8oK1447" alt=""><figcaption><p>Incident resolved or maintenance completed</p></figcaption></figure></div>

<div align="center"><figure><img src="/files/HgoatcvBo0lCVcYoNkJ0" alt=""><figcaption><p>Maintenance ongoing</p></figcaption></figure></div>

<div align="center"><figure><img src="/files/vd5Tu2izHSJV7mAZoohp" alt=""><figcaption><p>Upcoming maintenance reminder</p></figcaption></figure></div>

The notification title also has the type of the notification, but the color gives you an easier way of quickly identifying it.


---

# 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.incidenthub.cloud/incidenthub-documentation/channels/integration-for-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.
