# Microsoft Teams

Stay up-to-date with service alerts by integrating IsDown with Microsoft Teams. Follow this quick guide to configure notifications directly into your preferred Teams channels, ensuring your team stays informed and ready to act promptly during outages.

{% hint style="danger" %}
**Microsoft Teams are deprecating Office 365 Connectors**, and you'll need to change to Workflows by October 1st, 2024. You can read more [here](https://devblogs.microsoft.com/microsoft365dev/retirement-of-office-365-connectors-within-microsoft-teams/).\
\
If you previously used an Office 365 Connector and alerts have stopped, see this [article](https://help.isdown.app/notifications/microsoft-teams/transitioning-from-office-365-connectors)
{% endhint %}

### Before you start

**Requirements:**

* Microsoft Teams account with permission to create or manage workflows in the target team and channel.

### Create the webhook in Teams

Create the webhook URL in Teams that IsDown will use to send alerts.

1. **Open Workflows in Teams**
   * Go to **Apps** on the left sidebar, search for **Workflows**, and open the app.
   * If Workflows is unavailable, ask your IT admin to enable it for your tenant.
2. **Create a new webhook workflow**
   * Browse templates and select **“Post to a channel when a webhook request is received”**.

<figure><img src="https://3217946727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwE1RBRUaBkIz2ukzWl7o%2Fuploads%2FP1u3E0uZD4VOiAPaElXn%2FSEARCH%20POST%20TO%20CHANNEL%20WORKFLOW.avif?alt=media&#x26;token=b54483f9-cf77-4663-9815-de500a1217be" alt=""><figcaption></figcaption></figure>

* Set:

  * **Name**: e.g., `IsDown Alerts`

  <figure><img src="https://3217946727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwE1RBRUaBkIz2ukzWl7o%2Fuploads%2FqxWHYNy2zMtzKQgVxeab%2FCHOOSE%20FLOW%20NAME.avif?alt=media&#x26;token=8f68964d-a10a-49a7-94cf-54fd10fc8474" alt=""><figcaption></figcaption></figure>

  * **Team** and **Channel**: where alerts should appear

  <figure><img src="https://3217946727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwE1RBRUaBkIz2ukzWl7o%2Fuploads%2FmFT0TEaTdZHYDZBkjfuX%2FCHOOSE%20TEAM%20AND%20CHANNEL.avif?alt=media&#x26;token=0e4c48a6-2994-44b5-97a9-4e235df5b255" alt=""><figcaption></figcaption></figure>

3. **Generate and copy the webhook URL**

* Click **Add workflow** (or **Create flow**, depending on UI).
* Teams displays a **Webhook URL** – copy it and treat it like a secret.

<figure><img src="https://3217946727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwE1RBRUaBkIz2ukzWl7o%2Fuploads%2FBs1pjT6blhZ6vY11lGJv%2FGRAB%20URL.avif?alt=media&#x26;token=44c38b70-59f1-4caf-8569-e0de24838c8e" alt=""><figcaption></figcaption></figure>

* To retrieve it later: open the workflow, click **Edit**, and expand **When a Teams webhook request is received**.

<figure><img src="https://3217946727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwE1RBRUaBkIz2ukzWl7o%2Fuploads%2Fg1JT7wXAYhN9lFccJEuw%2FGRAB%20URL%20FORM%20WORKFLOW%20HOME%20SCREEN.png?alt=media&#x26;token=4c53cedc-ec35-49ef-a5d6-90a518c9d3a8" alt=""><figcaption></figcaption></figure>

***

### Connect IsDown to Teams

1. Open **IsDown Dashboard → Alerts & Integrations**.
2. Find **Microsoft Teams** and toggle it **On**.<br>

   <div data-full-width="false"><figure><img src="https://3217946727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwE1RBRUaBkIz2ukzWl7o%2Fuploads%2FGSOSKQY55Jk4hmDX8Sbw%2FChoose%20microsoft%20teams%20-%20notifications%20teams.png?alt=media&#x26;token=4b6a3fca-a422-473d-8137-86469b0661b2" alt=""><figcaption></figcaption></figure></div>
3. Set **Integration method** to **Workflows**.

<figure><img src="https://3217946727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwE1RBRUaBkIz2ukzWl7o%2Fuploads%2FfxgnzFQwuCaneZn9eqLz%2FENABLE%20WORKFLOWS%20ON%20ISDOWN.png?alt=media&#x26;token=2cd3a3fb-c942-4f87-aa45-fa2e30181157" alt=""><figcaption></figcaption></figure>

4. Paste the Webhook URL from Teams into the **Webhook URL** field.
5. Click **Save**.

***

### Optional: Remove the “template” branding footer

Workflows created from templates may include a branding footer in each message, e.g., “\<User> used a Workflow template to send this card.”

<figure><img src="https://3217946727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwE1RBRUaBkIz2ukzWl7o%2Fuploads%2Fh83tnuoPytyGYvDI7YjA%2FMESSAGE%20%22X%20USED%20A%20WORKFLOW%20TEMPLATE%22.png?alt=media&#x26;token=242bc2e1-4c0e-4865-82f3-ceb05fb18e5d" alt="" width="563"><figcaption></figcaption></figure>

To remove it, **duplicate the existing workflow** and update the webhook URL in IsDown. The original workflow cannot have the footer removed.

1. Open **Workflows** in Microsoft Teams.
2. Locate your existing IsDown workflow.
3. Click **…** (More options) and select **Save as**.
4. Give the new workflow a clear name, for example `IsDown Alerts – Custom`.
5. Open the newly created workflow:
   * Click **Edit**.
   * Expand **When a Teams webhook request is received**.
   * Copy the **new webhook URL**.
6. Go to **IsDown Dashboard → Alerts & Integrations → Microsoft Teams**.
7. Replace the existing webhook URL with the **new one**.
8. Click **Save**.

{% hint style="info" %}
The new workflow has a new URL. The original workflow and URL will no longer be used.
{% endhint %}

***

#### Troubleshooting

<table><thead><tr><th width="237.03125">Issue</th><th>Possible cause &#x26; fix</th></tr></thead><tbody><tr><td>Workflows app not found</td><td>Workflows may be disabled or uninstalled. Ask your IT admin to enable it.</td></tr><tr><td>Test URL fails in IsDown</td><td>Ensure Integration method is set to Workflows, not Connector.</td></tr><tr><td>No alerts arrive in Teams</td><td>Open the workflow in Teams, confirm it is Turned on and the channel is correct.</td></tr><tr><td>Alerts stopped after a while</td><td>Check if the workflow owner’s account was disabled or removed. Recreate the workflow under a service account or add co-owners.</td></tr></tbody></table>

If you need assistance, please reach out via chat or email us at [**support@isdown.app**](mailto:support@isdown.app)

***

**Related Articles**

* [**How to Set Up Email Notifications**](https://help.isdown.app/notifications/email)
* [**How to Set Up Slack Notifications**](https://help.isdown.app/notifications/slack)
* [**How to Set Up Google Chat Notifications**](https://help.isdown.app/notifications/google-chat)