Microsoft Teams
Install the SigSentry Teams app to run analyses with @SigSentry analyze
The SigSentry Teams app installs as a bot. Once added to a team and channel, run analyses by mentioning the bot:
@SigSentry analyze checkout returning 500s last 30 minutesPrerequisites
| Need | Notes |
|---|---|
| Teams workspace | Permission to add apps to teams |
| At least one project in SigSentry | Logs and (optionally) repos connected |
Setup walkthrough
Click "Install Teams" in SigSentry
Go to Settings → Integrations → Microsoft Teams → Install. You'll be redirected to Microsoft's app authorization flow.
Authorize on Microsoft's side
Sign in with the account that has rights to add apps in your Teams tenant. SigSentry requests these permissions:
| Permission | Why |
|---|---|
Bot.SendNotification | Post analysis results to channels |
User.ReadBasic.All | Identity-map Teams users to SigSentry users |
Chat.Read.All | Read thread context for follow-ups |
Click Accept.
Add the app to a team
After authorization, in Teams: open the team you want the app in, click the + tab, search for SigSentry, and add it. The app is now available in that team's channels.
Return to SigSentry
The connected workspace appears under Settings → Integrations → Connected workspaces.
Run a test command
In any channel where the app is added, mention it:
@SigSentry analyze test smoke last 1 hourThe diagnosis posts as a threaded reply within 30–60 seconds.
Command syntax
Teams uses bot mentions instead of slash commands:
@SigSentry analyze <description> <time-expression> [--project=<slug>]
@SigSentry help
@SigSentry projectsThe grammar is identical to Slack's — see Command grammar.
Threading
Teams thread replies work identically to Slack. Follow-up questions in the same thread are treated as follow-ups on the original analysis.
Revoking access
| For | Action |
|---|---|
| Whole workspace | Teams admin → Apps → SigSentry → Remove |
| Specific channel | Remove the app tab from the channel |
Or disconnect from SigSentry under Settings → Integrations → Connected workspaces → Disconnect.
Troubleshooting
| Symptom | Likely cause |
|---|---|
| Bot doesn't respond to mentions | App not added to that channel; add via the + tab |
| "User not authorized" | Teams email doesn't match a SigSentry user, or project access list excludes them |
| Bot doesn't post replies | Re-authorize the install from Settings → Integrations → Teams |
| Tenant restrictions blocking install | Talk to your Microsoft 365 admin to allow SigSentry in app permission policies |