Microsoft Teams
Route policy denial alerts, budget warnings, and human-in-the-loop approval requests to Microsoft Teams channels via incoming webhooks.
Prerequisites
- A Microsoft Teams channel where you can add a connector
- AIControls admin access
Configure the integration
- In Microsoft Teams, open the target channel, click ··· → Connectors → Incoming Webhook. Configure the webhook and copy the URL.
- In AIControls, go to Settings → Integrations → Microsoft Teams and click Add integration.
- Paste the webhook URL and give the integration a name.
- Select which event types should be delivered to this channel.
- Click Save. AIControls sends a test card immediately — confirm it appears in the Teams channel.
Which events fire
| Event | Behaviour |
|---|---|
| Policy denial | Adaptive Card with agent identity, tool name, and denial reason |
| Budget alert (80%) | Card with current spend, cap, and a link to the Cost dashboard |
| Budget exceeded | Card with blocked status and instructions to raise the cap |
| HITL pending | Card with request details; approvers click a link to act in the AIControls UI |
note
Teams incoming webhooks don't support interactive action buttons. HITL approval cards include a direct link to the Approvals page in AIControls where the approver can act.
Troubleshooting
Test card not appearing
Confirm the connector is still active in Teams — connectors can be removed by channel owners or auto-disabled after inactivity. Recreate the incoming webhook and update the URL in AIControls if needed.
Cards appearing without formatting
Some Teams tenants restrict Adaptive Cards. If cards appear as raw JSON or plain text, contact your Teams administrator to allow Adaptive Card rendering for incoming webhooks.