How to Set Up Microsoft Teams Alerts in Trackz

Overview

The Microsoft Teams integration posts a MessageCard to a channel of your choice whenever Trackz fires an alert — downtime detected, SSL certificate expiring, SMTP failure, or performance regression. Each card is color-coded by event type via its themeColor so your team can triage at a glance without opening the dashboard.

Prerequisites

• A Microsoft Teams workspace where you can install apps and add connectors to a channel
• A Trackz account on any paid plan (integrations are not included on the Free plan)

Note: Microsoft deprecated the legacy Office 365 Connector experience in 2024. The modern replacement is Power Automate workflows, but the Incoming Webhook connector URL still works and is the simplest way to receive alerts today. We will migrate this guide to a Power Automate flow if Microsoft fully sunsets it.

Step 1: Create an Incoming Webhook in Teams

1. Open Microsoft Teams and navigate to the channel where you want to receive alerts.
2. Click the ••• menu next to the channel name and choose Manage channel → Connectors (or Apps → Incoming Webhook depending on your tenant).
3. Find Incoming Webhook in the connector list and click Configure.
4. Give the webhook a name (e.g., Trackz Alerts) and optionally upload an avatar.
5. Click Create.
6. Copy the webhook URL — it looks like https://<tenant>.webhook.office.com/webhookb2/<uuid>@<uuid>/IncomingWebhook/<id>/<uuid>. Keep it handy for the next step.
7. Click Done.

Step 2: Add the Integration in Trackz

1. In your Trackz dashboard, go to Settings → Integrations.
2. Click Add Integration.
3. Select Microsoft Teams from the integration picker.
4. Enter a name for this integration (e.g., #alerts channel).
5. Paste the webhook URL you copied from Teams into the Webhook URL field.
6. Click Connect.

The integration will appear in your list with a green Active badge.

Trackz validates that the URL begins with https:// and points to either webhook.office.com or outlook.office.com. URLs from any other domain will be rejected.

Step 3: Assign Alerts to Monitors

Integrations receive alerts from all monitors in your workspace by default. If you want fine-grained control, use the Webhook integration type instead, which supports per-event filtering.

Testing Your Integration

1. In Settings → Integrations, click on your Microsoft Teams integration row to open the detail page.
2. Click Send test.
3. Within a few seconds, a test card should appear in your Teams channel.
4. The card will show a sample alert title, message, and metadata fields.

If no message arrives, check the troubleshooting section below.

Alert Card Format

Trackz sends Teams MessageCard payloads with the following structure:

Field	Content
themeColor	Red E74C3C = downtime · Green 2ECC71 = recovery · Orange F39C12 = SSL expiry · Orange E67E22 = SMTP failure · Purple 9B59B6 = performance regression
summary	Alert title (used by Teams for notification previews)
activityTitle	Alert name (e.g., Downtime detected: api.example.com)
activityText	Human-readable alert message
facts	Key/value pairs from the alert metadata: monitor name, URL, event type, response code, etc.

Troubleshooting

No message in Teams after sending a test

• Confirm the webhook URL contains webhook.office.com or outlook.office.com — Trackz rejects other domains at save time.
• Check that the connector still exists: Channel → Manage channel → Connectors → Configured.
• Verify the channel has not been archived or that the connector has not been disabled by an admin.

Integration shows as Disabled

• Toggle the integration back to active in Settings → Integrations using the toggle button.

Cards arrive but without color

• Some Teams clients render themeColor only on the desktop and web apps. Mobile may show a plain card; this is a Teams rendering limitation.

Webhook was deleted or rotated in Teams

• Delete the integration in Trackz and create a new one with the new webhook URL. Webhook URLs cannot be edited in place to avoid drift between the connector and the saved configuration.