Summary: Azure Bot Service app with adaptive cards, JWT-verified messaging endpoint, and invoke handler for Start plan actions.
Microsoft Teams bot
1. Azure Bot registration
- Create an Azure Bot (Multi Tenant) in Azure Portal.
- Set messaging endpoint:
https://app.usecontrax.com/api/integrations/teams/messages(handles both messages and adaptive card invoke actions). - Enable Teams channel.
- Copy Microsoft App ID and create a client secret →
MICROSOFT_APP_ID,MICROSOFT_APP_PASSWORD.
2. Link tenant in Contrax
In Contrax Workspace settings, paste your Microsoft 365 tenant ID into Teams tenant ID. The bot resolves the workspace from activity.conversation.tenantId.
3. Commands
queue— adaptive card with at-risk rows and Start plan buttonscoverage— renewal plan coverage %help— usage summary
4. Security
Contrax verifies Bot Framework JWTs (issuer https://api.botframework.com, audience = your App ID) using jose + Microsoft JWKS.