Teams Integration

Overview

When an AI agent action requires human approval, Aira can post an Adaptive Card to your Microsoft Teams channel with action details and a link to review it in the dashboard.

Beta feature. Enable it in Dashboard → Configuration → Feature Flags → teams_integration.

Setup

Teams integration uses Workflows (Power Automate) — no Azure app registration required.

Step 1: Create a Workflow webhook in Teams

In Teams, open the channel where you want notifications
Click the + button or go to Workflows in the channel
Search for "Post to a channel when a webhook request is received"
Select the channel, give the workflow a name (e.g. "Aira"), and click Save
Copy the webhook URL that appears

The webhook URL is a long URL starting with https://. Keep it safe — anyone with this URL can post to your channel.

Step 2: Enable the Feature Flag

Cloud: Contact support@airaproof.com to enable teams_integration for your organization.

Self-hosted:

echo "ENABLE_TEAMS_INTEGRATION=true" >> /opt/aira/.env
docker rollout api
docker compose restart worker

Or toggle it in Dashboard → Configuration → Feature Flags.

Step 3: Configure in Dashboard

Go to Dashboard → Integrations → Teams
Paste the webhook URL from Step 1
Click Connect to Teams
Click Send test notification to verify

Step 4: Enable the Notification Channel

Go to Dashboard → Decisions → Approval Channels and toggle Microsoft Teams on.

How It Works

When an action requires approval:

Aira posts an Adaptive Card to your Teams channel via the workflow webhook
The card shows the action type, agent, and details
A Review in dashboard button links to the action in Aira
The approver reviews and approves or denies in the dashboard
A cryptographic receipt is generated as usual

Notification Channels

You can configure which channels receive approval notifications:

Email — enabled by default
Slack — available after connecting (see Slack Integration)
Teams — available after connecting

Configure at Dashboard → Decisions → Approval Channels. You can use any combination.

All channels are notification-only. Approval and denial always happen in the Aira dashboard — this ensures a single, auditable approval surface.

Disconnecting

Go to Dashboard → Integrations → Teams → Disconnect. Notifications will stop going to Teams immediately. Other channels continue as configured.

Troubleshooting

"Connect to Teams" button is greyed out:

Verify the URL starts with https://
Check that the teams_integration feature flag is enabled

Notifications not appearing in Teams:

Click Send test notification to check connectivity
Verify the workflow is still active in Power Automate
Check API logs: docker compose logs api | grep teams

"Teams returned status 400" error:

The webhook URL may have expired or been regenerated. Create a new workflow and reconfigure.

"Teams returned status 403" error:

The workflow may have been disabled or the authentication settings require a tenant token. Use the "Anyone" authentication option when creating the workflow.

Teams Integration

On this page