Connect Microsoft Teams¶
Step-by-step guide to connecting Microsoft Teams to Thalian for finding alert delivery.
Prerequisites¶
- Microsoft Teams workspace where you want to receive alerts
- Teams admin or sufficient permissions to manage connectors/webhooks in a channel
Connect via OAuth¶
- Go to Integrations → Browse
- Find Microsoft Teams and click Connect
- Click Authorize with Microsoft
- Sign in with your Microsoft account
- Review the requested permissions
- Click Accept to grant consent
- You'll be redirected back to Thalian — the integration is now connected
Requested Permissions¶
Teams shares the Microsoft OAuth consent with Entra ID. The scopes specific to Teams are:
| Scope | Justification |
|---|---|
ChannelMessage.Send |
Reserved for future Teams alert delivery |
Team.ReadBasic.All |
Reserved for future Teams workspace enumeration |
For the full list of Microsoft scopes, see Connect Microsoft Entra ID.
Alternative: Webhook¶
If your organization restricts OAuth for Teams:
- In Microsoft Teams, go to the channel where you want to receive alerts
- Click the channel name → Connectors (or Manage channel → Connectors)
- Find Incoming Webhook and click Configure
- Give the webhook a name (e.g.,
Thalian Alerts) and click Create - Copy the webhook URL
- In Thalian, select the Webhook connection method
- Paste the webhook URL and click Save
Configure Alert Delivery¶
After connecting Teams:
- Open the Microsoft Teams integration card in Integrations
- Toggle Alerts on
- Set the severity threshold — only findings at or above this level are sent
Thalian sends adaptive card notifications for each new finding that meets your threshold.
What Thalian Uses Teams For¶
Teams is used exclusively for alert delivery. Thalian does not read or sync messages, files, or user data from Teams. When a new finding is generated that meets your severity threshold, Thalian posts an adaptive card to your configured channel.
For a full list of supported platforms, see Integrations Guide.