Microsoft Teams Channel

Connect Microsoft Teams

Teams runs as an Azure Bot that reuses the same Azure AD app as the Microsoft 365 integration. Install @omadia/integration-microsoft365 first — it owns the app credentials (client id / secret / tenant); this channel only adds Teams-specific knobs.

1. Register the Azure Bot

1. Azure Portal → create an Azure Bot resource.
2. Use the existing app registration from the Microsoft 365 integration (same Microsoft App ID).
3. Configuration → Messaging endpoint: <your-public-base-url>/api/teams/messages.
4. Channels → enable Microsoft Teams.

2. Upload the Teams app

Upload the Teams app package (manifest.json + icons as a ZIP) in Teams under Apps → Manage your apps → Upload a custom app.

3. Optional knobs

• OAuth Connection Name: if you add a v4 OAuth connection in the Azure Bot Service, put its name here to enable calendar SSO (OBO flow). Empty → calendar tools report sso_unavailable.
• Notify Team ID: the AAD groupId of the team where bell notifications appear — get it via Teams → Team settings → Get link to team (groupId query param) or Graph Explorer (/teams). Empty → log-only.
• Attachment prefix, topic URL and directory label have safe defaults.