docs: Microsoft Teams (App) alert integration

[MikaKerman]

For the docs team

Adds a new Cloud alert-integration page for the Microsoft Teams app (bot) integration — the new app-based Teams integration that replaces the legacy webhook integration.

What's here

• New page: docs/cloud/integrations/alerts/ms-teams-app.mdx — titled "Microsoft Teams (App)".
• Legacy page updated: docs/cloud/integrations/alerts/ms-teams.mdx — renamed to "Microsoft Teams (Legacy webhook)" with a deprecation warning pointing to the new app page.
• Nav reordered in docs/mint.json — the new app page now appears before the legacy webhook page.
• Screenshots — all included as local images under docs/images/teams/.

Page structure

1. Hero — alert Adaptive Card screenshot showing a real alert in Teams.
2. Connecting — simplified 3-step flow:
   • Install the Elementary app from the Microsoft Teams app store.
   • Click Connect to Elementary in the welcome card (connects automatically in Elementary).
   • Pick a default channel to start receiving alerts.
3. Bot commands — @Elementary help and @Elementary connect, each with a screenshot.
4. Supported channels — standard channels only (not private/shared).
5. Disconnecting — covers both directions (from Elementary UI and from Microsoft Teams).

Screenshots included

• Hero alert card (Adaptive Card in Teams)
• Welcome card ("Elementary has been added to this team!")
• Connected dialog (Elementary UI)
• Teams cards after successful connection
• Messaging app connected state (Elementary UI)
• @Elementary help response
• @Elementary connect response

Changes from initial draft

• Simplified from 5 connection steps to 3 — no unnecessary back-and-forth between Elementary and Teams.
• Removed the requirement to start from Elementary's UI to get the app store link — users go directly to the Teams app store.
• Every step clearly labels where the action happens (In Elementary / In Microsoft Teams).
• All placeholder screenshot URLs replaced with real local images.
• Legacy webhook page now has a deprecation warning.

Summary by CodeRabbit

• Documentation
  • Added a new guide for Microsoft Teams (App) alerts, including Teams app installation, setup in Elementary, default channel behavior, alert-rule routing, bot commands, and disconnect steps (single Elementary account per Teams team).
  • Updated the existing Microsoft Teams webhook documentation to “Microsoft Teams (Legacy webhook)” and added a deprecation warning directing new setups to the Teams App.
  • Updated the Integrations navigation to include the new Teams App page.

[github-actions]

👋 @MikaKerman
Thank you for raising your pull request.
Please make sure to add tests and document all user-facing changes.
You can do this by editing the docs files in this pull request.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 08ff12c6-07c8-4d1d-92d4-1a35ba1b348f

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

• @coderabbitai resume to resume automatic reviews.
• @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

• ▶️ Resume reviews
• 🔍 Trigger review

📝 Walkthrough

Walkthrough

A Microsoft Teams App alert documentation page was added with setup, routing, commands, supported channels, and disconnect instructions. The legacy webhook page was marked deprecated, and the new page was added to the documentation navigation.

Changes

MS Teams Alert Documentation

Layer / File(s)	Summary
Teams App integration page docs/cloud/integrations/alerts/ms-teams-app.mdx, docs/mint.json	Adds documentation for the Teams App integration, including setup, routing, bot commands, supported channels, disconnection, and navigation registration.
Legacy webhook deprecation docs/cloud/integrations/alerts/ms-teams.mdx	Renames the legacy Teams webhook page and replaces its introduction with a deprecation warning pointing to the Teams App page.

Estimated code review effort: 1 (Trivial) | ~3 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly matches the main change: adding the Microsoft Teams App alert integration docs.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch teams-app-docs

---

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/cloud/integrations/alerts/ms-teams-app.mdx`:
- Around line 14-19: The MS Teams app docs still contain placeholder image
sources in the screenshot frames, so replace every REPLACE_WITH_HOSTED_URL
reference with the real hosted asset URLs or remove the affected <Frame>/<img>
blocks until the screenshots are available. Update the repeated screenshot
sections in the MDX page consistently so the visible examples in the alert
walkthrough all render correctly before publishing.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 2365a114-3dff-4a0b-8b00-a3c9f3ab266a

📥 Commits

Reviewing files that changed from the base of the PR and between 809127c and 49a1b46.

📒 Files selected for processing (2)

• docs/cloud/integrations/alerts/ms-teams-app.mdx
• docs/mint.json