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

  1. Create an Azure Bot (Multi Tenant) in Azure Portal.
  2. Set messaging endpoint: https://app.usecontrax.com/api/integrations/teams/messages (handles both messages and adaptive card invoke actions).
  3. Enable Teams channel.
  4. 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 buttons
  • coverage — 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.

← Integrations overview