Microsoft Teams Integration

Send monitor alerts to Microsoft Teams channels using Workflow webhooks. Get notified when monitors go down or recover.

How It Works

Uptime Monitor sends alerts to Microsoft Teams using Workflow webhooks. Messages use Adaptive Card format with a title, detail text, and action buttons.

  • Monitor name appears as a clickable button linking to the dashboard
  • Down alerts show the error reason
  • Recovery alerts include total downtime

Setup Instructions

Step 1: Create Workflow Webhook in Teams

  1. 1

    Open the Teams channel where you want alerts

  2. 2

    Click the + icon or go to channel settings

  3. 3

    Search for Workflows and select it

  4. 4

    Choose Post to a channel when a webhook request is received

  5. 5

    Give the workflow a name (e.g., "Uptime Alerts")

  6. 6

    Copy the webhook URL

Step 2: Configure in Uptime Monitor

  1. 1

    In Uptime Monitor, go to Settings → Contacts

  2. 2

    Click Add Contact and select Microsoft Teams

  3. 3

    Enter a name (e.g., "Production Alerts") and paste your webhook URL

  4. 4

    Save the contact

  5. 5

    Add the Microsoft Teams contact to your monitors

Message Format

Messages are sent as Adaptive Cards with a title, detail text, and an action button:

Down Alert

Production API is DOWN

Connection timeout after 10000ms.

[View Monitor]

Recovery Alert

Production API is UP!

It was down for 5 minutes.

[View Monitor]

Note: Adaptive Cards include action buttons that link directly to the monitor details page in your dashboard.

Best Practices

  • Use dedicated alert channels

    Create separate Teams channels for different environments or severity levels

  • Multiple contacts for redundancy

    Create multiple Teams contacts for different channels and assign to monitors

  • Test webhook connectivity

    Verify webhooks are working by pausing and resuming a monitor

  • Teams Workflow webhooks require HTTPS

    Ensure your webhook URL uses HTTPS, which is the default for Teams Workflow webhooks

Troubleshooting

Common Issues

Messages not appearing

  • • Verify webhook URL is correct and complete
  • • Check channel permissions and workflow status
  • • Ensure Teams contact is assigned to monitors

Webhook errors

  • • Regenerate the webhook URL in Teams Workflows
  • • Check Teams admin policies for webhook restrictions
  • • Ensure the webhook URL uses HTTPS

Office 365 Connectors deprecated

  • • Office 365 Connectors are deprecated; use Workflow webhooks instead
  • • If you were using an old connector URL, create a new Workflow webhook