Microsoft Teams Integration

Send PixoMonitor alerts directly to Microsoft Teams channels. Keep your team informed about service status without leaving their collaboration hub.

Overview

The Microsoft Teams integration uses incoming webhooks to deliver formatted message cards to any Teams channel. Alerts include:

Color-coded cards — Visual status indication at a glance
Structured information — Monitor name, URL, status, and error details
Action buttons — One-click link to view monitor details in PixoMonitor
Team visibility — Everyone in the channel sees alerts instantly

Teams webhooks work great for enterprise environments where Teams is the primary communication tool.

Setting Up Teams Alerts

Open the Teams Channel

Navigate to the Microsoft Teams channel where you want to receive alerts:

Open Microsoft Teams
Go to the team and channel for alerts
Click the ••• (more options) button next to the channel name

Add an Incoming Webhook

Configure the webhook connector:

Select Connectors (or Manage channel → Connectors)
Find Incoming Webhook in the list
Click Configure (or Add if not already added)

Configure the Webhook

Set up your webhook:

Enter a name (e.g., "PixoMonitor Alerts")
Optionally upload a custom image for the webhook
Click Create
Copy the webhook URL that appears

The URL looks like:

https://outlook.office.com/webhook/...

Add to PixoMonitor

In PixoMonitor, go to Settings → Alert Channels and click Add Alert Channel:

Name: A descriptive name (e.g., "Teams #infrastructure")
Type: Select Microsoft Teams
Webhook URL: Paste the Teams webhook URL
Click Save

Assign to Monitors

Edit your monitors to include the Teams alert channel, or set it as a default for new monitors.

Alert Message Format

Teams alerts appear as MessageCards with color-coded theme:

DOWN Alert

The card displays with a red theme color:

🔴 PixoMonitor Alert

Monitor     MyWebsite
Status      DOWN
URL         https://mywebsite.com
Error       Connection timeout after 30000ms
Time        3/24/2026, 10:30:45 AM

[View Monitor]

UP (Recovery) Alert

The card displays with a green theme color:

✅ PixoMonitor Alert

Monitor     MyWebsite
Status      UP
URL         https://mywebsite.com
Time        3/24/2026, 10:35:12 AM

[View Monitor]

Degraded Alert

The card displays with an orange theme color:

⚠️ PixoMonitor Alert

Monitor     MyWebsite
Status      DEGRADED
URL         https://mywebsite.com
Time        3/24/2026, 10:32:00 AM

[View Monitor]

The "View Monitor" button links directly to the monitor's detail page in PixoMonitor, making it easy to investigate issues.

Webhook Connector Locations

Depending on your Teams version and admin settings, you might find the webhook connector in different places:

New Teams Experience

Click ••• next to the channel name
Select Manage channel
Click Edit next to Connectors
Search for "Incoming Webhook"

Classic Teams

Click ••• next to the channel name
Select Connectors
Find "Incoming Webhook" and click Configure

Keeps alerts separate from regular team conversations
Easy to review alert history
Team members can configure their own notification preferences

Channel Notification Settings

Configure Teams notifications for your alert channel:

Click the ••• next to the channel name
Select Channel notifications
Choose:
- All activity: Get notified for every alert
- Off: Check the channel manually
- Custom: Configure specific notification rules

Organize by Team

For larger organizations:

Create alert channels in relevant team spaces
Infrastructure team gets infrastructure alerts
Application teams get their specific app alerts
On-call channels for immediate attention items

Multiple Teams Channels

You can create multiple Teams alert channels in PixoMonitor to:

Route different monitors to different teams
Separate production and staging alerts
Send critical alerts to multiple channels simultaneously

Integration with Teams Features

@Mentions

While PixoMonitor doesn't directly @mention users, you can:

Configure channel settings to notify everyone on new messages
Use Power Automate to forward critical alerts with @mentions
Set up channel moderation to highlight webhook messages

Mobile Notifications

Teams mobile app notifications work automatically:

Ensure Teams mobile notifications are enabled on your device
Configure channel notification settings
Critical alerts will reach team members even when away from desktop

Troubleshooting

Alerts Not Appearing

Verify webhook URL: Ensure the URL starts with https://outlook.office.com/webhook/ or similar Microsoft domain
Test the channel: Use PixoMonitor's Test button
Check connector status: The connector might have been removed or disabled
Verify permissions: You need permission to add connectors to the channel

"Bad Request" Error

The webhook URL might be malformed or expired
Try creating a new webhook in Teams

"Forbidden" Error

The connector may have been disabled by an administrator
The webhook URL might have been revoked
Contact your Teams administrator

Messages Appear but No Notifications

Check your Teams notification settings
Verify channel notification preferences
Ensure Teams desktop/mobile notifications are enabled
Check "Do Not Disturb" status

Webhook URL Expired

Microsoft Teams webhook URLs can expire or become invalid if:

The connector is removed from the channel
The channel is deleted
Organization policies revoke connectors

Create a new webhook if your URL stops working.

Security Considerations

URL protection: Keep webhook URLs private—anyone with the URL can post to your channel
Channel visibility: All channel members can see alert messages
Connector auditing: Teams admins can audit connector usage
Data in transit: All communications are encrypted via HTTPS