MS Teams Alert Notifications

Use this guide to send DurableStack alert notifications to an MS Teams channel.

Before you start

• MS Teams alert dispatch is a Pro feature in DurableStack.
• You need Microsoft Teams permissions to create or manage an incoming webhook for the destination channel.
• You need access to the DurableStack app with organization-level integration management permissions.

1) Create an MS Teams incoming webhook

1. Open Microsoft guidance for Teams webhooks/connectors: https://learn.microsoft.com/microsoftteams/platform/webhooks-and-connectors/how-to/connectors-using
2. Add an incoming webhook to the target channel.
3. Copy the webhook URL.

Treat this URL like a secret. Anyone with the URL can post to that channel.

2) Add the integration in DurableStack

1. In DurableStack, go to Workspace > Organizations.
2. Open Manage Integrations for your organization.
3. In MS Teams Integrations, select Add MS Teams Integration.
4. Enter:
   • Name: a clear destination label (example: MS Teams Incident Channel)
   • Target URL: the Teams incoming webhook URL
5. Save the integration.

Integrations are organization-scoped, so they can be reused across projects in the same organization.

3) Send a test notification

From the Organization Integrations page, click Test on the MS Teams integration.

• If the test succeeds, Teams should receive a sample alert card.
• If it fails, DurableStack shows an error toast with details.

4) Use the integration in an alert rule

1. Go to Alerts > Manage Alerts for your project.
2. Create or edit a rule.
3. In Dispatch, enable MS Teams.
4. Choose one of:
   • an existing MS Teams integration, or
   • Create new integration and save it inline
5. Save the alert rule.

Troubleshooting

• summary/text is required style errors: Teams rejected the payload because required card fields were missing.
• Message delivery failed: webhook URL may be invalid, removed, or no longer authorized for the channel.
• Connector not found/invalid/disabled: recreate the webhook and update the DurableStack integration target URL.

Security and operations

• Store webhook URLs in secure secret systems during setup and rotation workflows.
• Rotate webhook URLs periodically and after channel administration changes.
• Use integration names that clearly map to team ownership and escalation paths.