Microsoft Teams Notifications

Overview

The Microsoft Teams integration delivers real-time ISMS notifications directly into a Teams channel. Messages are rendered as Adaptive Cards, providing a rich, interactive format that displays event details, severity, and a direct link back to Standardise.

Like the Slack integration, you select which ISMS events trigger notifications. Teams notifications are available on Starter plans and above.

Creating a Teams Webhook

Microsoft Teams supports incoming webhooks through two methods. Choose whichever is available in your organisation:

Option A: Workflows App (Recommended)

1. Open the target channel in Teams and click the + tab or go to Manage channel > Connectors.
2. Search for the Workflowsapp and create a new workflow using the “Post to a channel when a webhook request is received” template.
3. Copy the generated webhook URL — you will paste this into Standardise.

Option B: Legacy Incoming Webhook Connector

1. In the target channel, select Connectors > Incoming Webhook.
2. Give the webhook a name (e.g. “Standardise”) and optionally upload a logo.
3. Click Create and copy the webhook URL.

Note: Microsoft is deprecating legacy connectors in favour of the Workflows app. If you are setting up a new integration, use Option A.

Setup Steps

1. In Standardise, navigate to Settings > Integrations and click Add Integration.
2. Select Microsoft Teams as the provider.
3. Paste the webhook URL you copied from Teams.
4. Select the ISMS events you want forwarded to the channel — for example, incident.created, risk.created, document.approved, and audit.completed.
5. Click Test Connection to send a sample Adaptive Card to the channel. Confirm it displays correctly, then save.

Adaptive Card Format

Each notification is delivered as an Adaptive Card containing:

• Event title— a brief summary of what happened (e.g. “New Incident Reported”).
• Details— relevant fields such as severity, status, assigned owner, and timestamps.
• Action button— a “View in Standardise” link that takes you directly to the relevant item.
• Severity colour — the card accent colour matches the event severity (red for critical, orange for medium, green for positive, blue for informational).

Troubleshooting

• Webhook URL rejected — Ensure the URL starts with https:// and is a valid Teams webhook endpoint. Workflows and legacy connectors produce different URL formats; both are supported.
• Cards not rendering — Some older Teams clients may not fully support Adaptive Cards. Ensure your Teams app is up to date.
• Webhook stopped working — If the Workflow or connector was deleted in Teams, the webhook URL becomes invalid. Create a new webhook and update the URL in Settings > Integrations.