Agent skill
teams-api
Microsoft Teams automation using Graph API, Bot Framework, Adaptive Cards, and webhooks for enterprise messaging and collaboration
Install this agent skill to your Project
npx add-skill https://github.com/vamseeachanta/workspace-hub/tree/main/.claude/skills/business/communication/teams-api
SKILL.md
Teams Api
When to Use This Skill
USE when:
- Building bots for Microsoft 365 organizations
- Creating enterprise notification systems
- Integrating with Azure DevOps and Microsoft ecosystem
- Building approval workflows in Teams
- Automating meeting scheduling and management
- Creating messaging extensions for Teams apps
- Implementing compliance-aware messaging solutions
- Building internal tools with Adaptive Cards
DON'T USE when:
- Organization uses Slack primarily (use slack-api)
- Need simple webhooks only (use incoming webhooks directly)
- No Microsoft 365 subscription available
- Building consumer-facing chat applications
- Need real-time gaming or high-frequency updates
Prerequisites
Azure App Registration
# 1. Go to Azure Portal -> Azure Active Directory -> App registrations
# 2. New registration:
# - Name: "Teams Bot App"
# - Supported account types: Accounts in this organizational directory
# - Redirect URI: Web - https://your-app.azurewebsites.net/auth
# Required API Permissions (Microsoft Graph):
# Application permissions:
# - ChannelMessage.Send - Send channel messages
*See sub-skills for full details.*
### Python Environment Setup
```bash
# Create virtual environment
python -m venv teams-bot-env
source teams-bot-env/bin/activate # Linux/macOS
# Install dependencies
pip install azure-identity msgraph-sdk botbuilder-core aiohttp
# Create requirements.txt
cat > requirements.txt << 'EOF'
*See sub-skills for full details.*
### Bot Framework Registration
```bash
# 1. Go to https://dev.botframework.com/bots/new
# 2. Or use Azure Portal -> Create a resource -> Bot Channels Registration
# Bot configuration:
# - Messaging endpoint: https://your-app.azurewebsites.net/api/messages
# - Microsoft App ID: from App Registration
# - Enable Teams channel
# For local development with ngrok:
ngrok http 3978
# Update messaging endpoint to ngrok URL
Version History
| Version | Date | Changes |
|---|---|---|
| 1.0.0 | 2026-01-17 | Initial release with comprehensive Teams API patterns |
Resources
- Microsoft Graph API
- Bot Framework SDK
- Adaptive Cards Designer
- Teams App Manifest
- Teams Webhook Connectors
This skill provides production-ready patterns for Microsoft Teams automation, enabling enterprise messaging and collaboration workflows.
Sub-Skills
- 1. Microsoft Graph API Client
- 2. Adaptive Cards
- 3. Incoming Webhooks
- 4. Bot Framework Integration
- 5. Proactive Messaging
- 6. Meeting Automation
- Azure DevOps Pipeline Integration (+1)
- 1. Rate Limiting (+2)
- Common Issues
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
gsd-complete-milestone
Archive completed milestone and prepare for next version
gsd-reapply-patches
Reapply local modifications after a GSD update
gsd-verify-work
Validate built features through conversational UAT
gsd-thread
Manage persistent context threads for cross-session work
clinical-trial-protocol
Generate clinical trial protocols for medical devices or drugs through a modular, waypoint-based architecture with research-only and full protocol modes.
single-cell-rna-qc
Performs quality control on single-cell RNA-seq data (.h5ad or .h5 files) using scverse best practices with MAD-based filtering and comprehensive visualizations.
Didn't find tool you were looking for?