Microsoft Teams Integration
Connect Microsoft Teams to capture decisions from your team's conversations.
Features
- Real-time capture —
@Alignto capture decisions instantly - Context extraction — Automatically includes surrounding conversation
- Channel support — Works in team channels
- Discover — Scan historical messages for past decisions
Setup (Cloud)
- Go to Settings → Integrations in Align
- Click Connect Teams
- Sign in with your Microsoft account
- Grant permissions for your tenant
- Add the Align bot to your desired channels
Adding Align to Channels
After connecting:
- Go to the Teams channel
- Click + to add a tab/app
- Search for "Align"
- Add the Align bot to the channel
Capturing Decisions
Basic Capture
Mention @Align with the decision:
@Align We decided to migrate to Azure Kubernetes Service
With Context
Include rationale for richer snapshots:
@Align Moving to AKS for the platform migration.
Key factors:
- Better integration with existing Azure services
- Cost optimization through reserved instances
- Team already has Azure expertise
Commands
| Command | Description |
|---|---|
@Align <decision> | Capture a new decision |
@Align help | Show available commands |
Best Practices
- Use standard channels — Align works best in team channels
- Be descriptive — Teams messages are often shorter, add context
- Capture in threads — Reply to the discussion with the decision
- Include stakeholders — Mention decision makers
Permissions
Align requires these Microsoft Graph permissions:
| Permission | Purpose |
|---|---|
ChannelMessage.Read.All | Read messages in channels |
ChannelMessage.Send | Send acknowledgment messages |
User.Read.All | Map Teams users to Align users |
Team.ReadBasic.All | List teams and channels |
Troubleshooting
Align doesn't respond
- Ensure the Align app is installed in your tenant
- Verify the bot is added to the channel
- Check that the bot is not blocked
Permission errors
- Your Teams admin may need to approve the app
- Enterprise tenants may require admin consent
Self-Hosted Setup
See Self-Host OAuth Apps for registering your own Teams/Azure app.