Microsoft Teams

This guide shows how to connect IsDown to Microsoft Teams using the Workflows app so that alerts appear in the channel you choose.

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.

Microsoft Teams are deprecating Office 365 Connectors, and you'll need to change to Workflows by October 1st, 2024. You can read more here. If you previously used an Office 365 Connector and alerts have stopped, see this article

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”.

• Set:

  • Name: e.g., IsDown Alerts

  

  • Team and Channel: where alerts should appear

  

1. 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.

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

---

Connect IsDown to Teams

1. Open IsDown Dashboard → Alerts & Integrations.

2. Find Microsoft Teams and toggle it On.

3. Set Integration method to Workflows.

1. Paste the webhook URL from Teams into the Webhook URL field.

2. 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.”

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.

The new workflow has a new URL. The original workflow and URL will no longer be used.

---

Troubleshooting

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

If you need assistance, please reach out via chat or email us at [email protected]

---

Related Articles

• How to Set Up Email Notifications

• How to Set Up Slack Notifications

• How to Set Up Google Chat Notifications