Microsoft Teams Notifications for Uptime Monitoring

Microsoft Teams is the communication hub for many enterprises. Integrating uptime monitoring with Teams ensures your operations team sees alerts where they already work. Here's how to set it up.

Why Microsoft Teams?

• Enterprise standard - Already deployed in many organizations
• Rich integrations - Power Automate, connectors, apps
• Adaptive cards - Beautiful formatted alerts
• Channel organization - Route alerts appropriately
• Mobile app - Get push notifications

Setting Up Incoming Webhooks

Step 1: Create Webhook

1. Open Microsoft Teams
2. Navigate to the target channel
3. Click "..." menu → "Connectors"
4. Find "Incoming Webhook"
5. Click "Configure"
6. Name it (e.g., "Uptime Alerts")
7. Optionally upload an icon
8. Click "Create"
9. Copy the webhook URL

Step 2: Add to Monitoring

In your monitoring service:

1. Go to notification settings
2. Add Microsoft Teams webhook
3. Paste the webhook URL
4. Test the connection

Message Formatting

Simple Message

{
  "text": "🔴 Production API is DOWN"
}

Adaptive Card (Recommended)

{
  "@type": "MessageCard",
  "@context": "http://schema.org/extensions",
  "themeColor": "FF0000",
  "summary": "Production API is DOWN",
  "sections": [{
    "activityTitle": "🔴 CRITICAL: Service Down",
    "facts": [
      {"name": "Monitor", "value": "Production API"},
      {"name": "URL", "value": "https://api.example.com"},
      {"name": "Status", "value": "HTTP 500"},
      {"name": "Duration", "value": "5 minutes"},
      {"name": "Location", "value": "US-East"}
    ],
    "markdown": true
  }],
  "potentialAction": [{
    "@type": "OpenUri",
    "name": "View Dashboard",
    "targets": [{
      "os": "default",
      "uri": "https://dashboard.example.com"
    }]
  }]
}

Color Coding

Use themeColor for visual indicators:

Channel Organization

Recommended Structure

General Team
├── 📢 Announcements
├── 💬 General
└── 🔧 Operations
    ├── Alerts - Production
    ├── Alerts - Staging
    └── Incident Management

Webhook Per Channel

Create separate webhooks for:

• Production critical alerts
• Staging alerts
• Different services

Power Automate Integration

For advanced workflows, use Power Automate:

Example: Create Incident Task

1. Trigger: When webhook receives alert
2. Parse JSON from body
3. Create task in Planner
4. Assign to on-call person
5. Post to Teams channel

Example: Escalation Flow

1. Trigger: Alert received
2. Wait 10 minutes
3. Check if acknowledged
4. If not, send to manager channel
5. Create phone call alert

Actionable Messages

Add buttons for quick actions:

{
  "@type": "MessageCard",
  "sections": [...],
  "potentialAction": [
    {
      "@type": "OpenUri",
      "name": "View Dashboard",
      "targets": [{"os": "default", "uri": "https://..."}]
    },
    {
      "@type": "OpenUri",
      "name": "View Runbook",
      "targets": [{"os": "default", "uri": "https://..."}]
    },
    {
      "@type": "HttpPOST",
      "name": "Acknowledge",
      "target": "https://your-api/acknowledge"
    }
  ]
}

Best Practices

Do

• Use dedicated alerts channels
• Color-code by severity
• Include actionable links
• Test webhooks regularly
• Document channel purposes

Don't

• Alert to general channels
• Use unclear monitor names
• Skip severity indicators
• Ignore Teams notification settings

Testing Webhook

Using PowerShell

$uri = "YOUR_WEBHOOK_URL"
$body = @{
    text = "Test alert from monitoring"
} | ConvertTo-Json

Invoke-RestMethod -Uri $uri -Method Post -Body $body -ContentType "application/json"

Using curl

curl -H "Content-Type: application/json" \
  -d '{"text":"Test alert"}' \
  YOUR_WEBHOOK_URL

Notification Management

Channel Notification Settings

Configure per user:

1. Click channel name → "Channel notifications"
2. Set banner/feed preferences
3. Configure mobile push settings

@Mentions in Alerts

To mention users, use the connector's mention feature or send user IDs:

{
  "text": "<at>John</at> Production is down!",
  "entities": [{
    "type": "mention",
    "mentioned": {
      "id": "user-id",
      "name": "John"
    },
    "text": "<at>John</at>"
  }]
}

Troubleshooting

Webhook Errors

400 Bad Request:

• Validate JSON format
• Check required fields
• Verify URL encoding

404 Not Found:

• Webhook may be deleted
• Check URL is complete
• Recreate connector

Throttling:

• Teams has rate limits
• Implement retry logic
• Consider batching

Messages Not Appearing

1. Verify webhook URL is correct
2. Check channel still exists
3. Confirm connector is active
4. Review JSON format

Integration Checklist

• Webhook created in target channel
• URL added to monitoring service
• Message format configured
• Test message received
• Color coding verified
• Action buttons working
• Channel notifications configured
• Team informed of new alerts