Microsoft Teams Integration

Receive MaxRMM alert notifications as adaptive cards in your Teams channels.

Overview

The Teams integration sends alert notifications as Adaptive Cards to a Microsoft Teams channel via an Incoming Webhook connector. Cards include severity color-coding, alert details, and agent information.

Step 1: Create a Teams Incoming Webhook

1. In Microsoft Teams, navigate to the channel where you want to receive notifications (e.g., #IT-Alerts)
2. Click the ... (more options) next to the channel name
3. Select Connectors (or Manage channel → Connectors)
4. Find Incoming Webhook and click Configure
5. Enter a name (e.g., "MaxRMM Alerts") and optionally upload the MaxRMM logo
6. Click Create
7. Copy the webhook URL — it looks like:
   https://your-org.webhook.office.com/webhookb2/...

Step 2: Configure in MaxRMM

Via the Dashboard

1. Go to Settings → Integrations
2. Click Add Integration
3. Select Microsoft Teams
4. Paste the webhook URL
5. Click Save

Via the API

POST /api/integration-config
Content-Type: application/json
Authorization: Bearer <access-token>

{
  "slug": "teams",
  "config": {
    "webhookUrl": "https://your-org.webhook.office.com/webhookb2/..."
  }
}

Step 3: Test the Integration

POST /api/integration-config/:id/test
Authorization: Bearer <access-token>

A test adaptive card should appear in your Teams channel with the title "Test notification from MaxRMM" and a test agent hostname.

Adaptive Card Format

Alert notifications are sent as Teams Adaptive Cards with:

• Color-coded header — Red for critical, yellow for warning, blue for info
• Alert title — Description of the condition that triggered
• Agent hostname — Which endpoint fired the alert
• Category — The metric type (cpu, ram, disk, av, service, offline)
• Severity — Critical, warning, or info
• Timestamp — When the alert was created

What Gets Notified

• New alerts — When any alert fires on any agent
• Resolved alerts — When an alert is resolved
• Agent offline events — When an agent stops reporting

Managing the Integration

Disable temporarily

PUT /api/integration-config/:id
{
  "enabled": false
}

Update webhook URL

PUT /api/integration-config/:id
{
  "config": {
    "webhookUrl": "https://your-org.webhook.office.com/webhookb2/NEW-URL"
  }
}

Remove the integration

DELETE /api/integration-config/:id

Troubleshooting