🚀 Install AlertMind AI for Microsoft Teams

Quick start (1–2 minutes)

1. Click Open in Microsoft Teams to install the app, then open a 1:1 chat with the bot and send any message (this initializes proactive DMs).
2. Select your alert source: config alert_platform pagerduty|splunk|ocm
3. Connect your alert platform(s) by pointing webhooks to your AlertMind domain (e.g., https://alertmind-ai.onrender.com):
   • PagerDuty (v3) → /hooks/pd/<team_id> (alt: /slack/pagerduty/webhook/<team_id>)
   • Splunk On-Call → /hooks/splunk/<team_id>
   • IBM OCM → /hooks/ocm/<team_id>
4. Optional: set a Teams admin for proactive DMs:
   • config teams_admin_user_id <AAD Object ID>
   • config teams_admin_upns you@company.com
5. Upload docs with uploadkb or paste a table with ingesttable | ....
6. Ask kb <question> or see a digest with summary.

Tip: You can also type menu to open setup cards inside the bot.

Optional: Connect Microsoft account (Graph extras)

This enables optional Graph features (e.g., org-wide user lookups). Proactive DMs work without Graph as soon as you’ve messaged the bot once. Your team_id is stored locally in your browser for convenience.

Alternative: Sideload

1. Download: teams-app.zip
2. In Teams: Apps → Manage your apps → Upload a custom app
3. Select the ZIP and follow the prompts

Bot endpoint must be /teams/api/messages and MICROSOFT_APP_ID/MICROSOFT_APP_PASSWORD must be set.

Available commands

• menu — open the Home card
• help — examples & setup
• kb <question> — knowledge base Q&A
• summary — recent alert digest
• alert — explore past alerts (filters: urgency, service, containing, trend)
• uploadkb / ingesttable — add docs/tables to the KB
• config — backend/model/plan/admin settings
• clearkb — admin-only KB reset (with confirmation)

Permissions

Default (recommended) — no Microsoft Graph permissions required. The bot sends proactive messages using the stored conversation reference after you’ve messaged it once.

Optional Graph scopes (only if you enable the connect step above):

• openid profile email offline_access — basic sign-in + token refresh
• User.Read — greet/route by your profile
• Chat.ReadWrite — optional; only if you plan to send messages via Graph instead of Bot Framework
• Group.ReadWrite.All — optional; advanced scenarios (e.g., creating/managing group chats). Avoid for marketplace review unless necessary.

We store only what’s needed (team ID, tenant ID, installer UPN/ID if provided, and tokens if you opt into Graph). You can revoke access anytime.

Troubleshooting

• No DMs from the bot? Open a 1:1 with the bot and send a message to refresh the conversation reference.
• Webhook not firing? Ensure the URL path includes your exact team_id.
• Admin actions blocked? Set config teams_admin_user_id <AAD Object ID> and config teams_admin_upns you@company.com.

Need help? Visit the Support page.