Microsoft Teams โ
Send Adaptive Card notifications to Microsoft Teams channels via Power Automate Workflows webhooks.
Overview โ
- ๐ข Enterprise Ready โ Native Microsoft 365 integration
- ๐ Adaptive Cards โ Structured content with FactSet layouts
- ๐จ Color-Coded Status โ Visual status indicators on titles
- ๐ Rich Field Layout โ Key-value pairs displayed as facts
Configuration โ
| Field | Description | Default | Required |
|---|---|---|---|
| Webhook URL | Teams Workflow webhook URL | โ | โ |
Setup Guide โ
1. Create an Incoming Webhook in Teams โ
Microsoft Teams uses Power Automate Workflows for incoming webhooks (the legacy Office 365 Connector method is deprecated).
Using Workflows (Recommended) โ
- Open the target Teams channel
- Click the โฏ (More options) menu on the channel
- Select Workflows
- Search for "Post to a channel when a webhook request is received"
- Click the template and follow the setup wizard
- Name the workflow (e.g., "DBackup Notifications")
- Select the target team and channel
- Click Add workflow
- Copy the generated webhook URL
URL Format
The webhook URL should look like:
https://prod-XX.westeurope.logic.azure.com:443/workflows/...or
https://TENANT.webhook.office.com/webhookb2/...Do not confuse this with the deprecated Office 365 Connector URL format.
2. Configure in DBackup โ
- Go to Notifications in the sidebar
- Click Add Notification
- Select Microsoft Teams
- Paste the webhook URL
- Click Test to verify
- Save
3. Test the Connection โ
Click Test to send a test notification. You should see an Adaptive Card appear in your Teams channel within a few seconds.
Message Format โ
Teams notifications use Adaptive Cards v1.4 with the following structure:
| Element | Content |
|---|---|
| Title | Event name with status color (Attention/Good/Warning) |
| Body | Summary message text |
| FactSet | Structured key-value pairs (job name, duration, size, etc.) |
| Footer | ISO 8601 timestamp |
Color Mapping โ
Since Adaptive Cards only support named colors, DBackup maps hex colors to the closest Adaptive Card color:
| Status | Adaptive Card Color | Appears As |
|---|---|---|
| Success | Good | Green text |
| Failure | Attention | Red text |
| Warning | Warning | Yellow text |
| Informational | Accent | Blue text |
| Other | Default | Theme default |
Multiple Channels โ
Create separate webhooks and notification channels for different purposes:
- #production-alerts โ Critical backup notifications
- #infrastructure โ System events and restore notifications
- #dev-notifications โ Development environment backups
Troubleshooting โ
Webhook Returns 400 โ
Teams returned 400: Bad RequestSolutions:
- Verify the webhook URL is from a Power Automate Workflow, not a deprecated Office 365 Connector
- Ensure the workflow is still active and not disabled
- Check if the Teams channel still exists
Webhook Returns 401/403 โ
Teams returned 401: UnauthorizedSolutions:
- The workflow may have expired โ recreate it
- Check if the user who created the workflow still has access to the channel
- Verify the workflow hasn't been disabled by an admin
Card Not Rendering โ
If the notification arrives but appears as raw JSON:
- Ensure the workflow template is "Post to a channel when a webhook request is received"
- The workflow must be configured to accept Adaptive Card payloads
- Try recreating the workflow with the recommended template
Workflow Not Triggering โ
Solutions:
- Check the Power Automate portal for workflow errors
- Verify the workflow is turned on
- Check if you've hit the Power Automate connector limits for your plan
Best Practices โ
- Use Power Automate Workflows โ The legacy Office 365 Connector method is deprecated by Microsoft
- Label workflows clearly โ Name them "DBackup - Production" etc. for easy management
- Monitor workflow health โ Check Power Automate portal periodically for failures
- Separate channels by criticality โ Production vs. development notifications
- Document the webhook creator โ Workflows are tied to the creating user's account