Summary: Coming soon — Azure Bot Service app with adaptive cards, JWT-verified messaging endpoint, and invoke handler for Start plan actions. Use Teams incoming webhooks for channel reminders today.

Microsoft Teams bot

Status: Coming soon — not enabled in production yet. The setup below is for when platform credentials are provisioned.

1. Azure Bot registration

  1. Create an Azure Bot (Multi Tenant) in Azure Portal.
  2. Set messaging endpoint: https://www.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

Frequently asked questions

The Teams bot is coming soon (not enabled in production yet). When available: register an Azure Bot, set the messaging endpoint to your Contrax app URL, and link your Microsoft 365 tenant ID in Workspace settings. Use Teams incoming webhooks today for channel reminders.

Planned commands (coming soon): queue (at-risk renewals with Start plan buttons), coverage (renewal plan coverage percent), and help.