Azure Communication Services Skill
This skill provides expert guidance for Azure Communication Services. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.
How to Use This Skill
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,
L35-L120), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools are not available, suggest the user install it: Installation Guide
This skill requires network access to fetch documentation content:
- Preferred: Use
mcp_microsoftdocs:microsoft_docs_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L37-L111 | Diagnosing and fixing ACS calling, SMS, email, Teams, PSTN, audio/video, device, network, and SDK issues, plus collecting logs, UFD events, and diagnostics for support. |
| Best Practices | L112-L137 | Best practices for ACS calling, SMS, email, IDs, auth, Teams interop, network/quality, spam/opt-out compliance, and production-ready virtual visit and meeting experiences. |
| Decision Making | L138-L154 | Guidance for planning ACS solutions: Teams interop in gov clouds, PSTN/phone number options, pricing/licensing, and migration from Twilio Video/Chat to ACS Calling/Chat. |
| Architecture & Design Patterns | L155-L160 | Designing scalable contact center solutions with ACS and patterns for integrating ACS with ExpressRoute for secure, private connectivity and network architecture. |
| Limits & Quotas | L161-L228 | Limits, quotas, and regional rules for ACS calling, phone numbers, SMS, email sending, Teams interop, media features, and emergency/toll‑free/direct routing constraints. |
| Security | L229-L254 | Security, auth, and compliance for ACS: encryption, identities, HMAC, caller ID, email/SMTP, Teams interop, captions/transcription, emergency calling, and secure webhooks/Rooms. |
| Configuration | L255-L332 | Configuring monitoring, logging, metrics, and insights for ACS (chat, voice/video, calls, SMS, email), plus setup for Teams interop, direct routing, UI Library options, and SMS/email domain/sender settings. |
| Integrations & Coding Patterns | L333-L480 | Patterns and end-to-end integrations for ACS calling, chat, SMS, email, Rooms, Job Router, Teams/Phone, WhatsApp, OpenAI/bots, push, UI library, and telephony/OS frameworks. |
| Deployment | L481-L485 | Infrastructure and deployment guidance for Azure Communication Services: direct routing requirements and automating ACS/Email resource provisioning with PowerShell. |
Troubleshooting
Best Practices
Decision Making
Architecture & Design Patterns
| Topic | URL |
|---|---|
| Architect contact center solutions with Azure Communication Services | https://learn.microsoft.com/en-us/azure/communication-services/tutorials/contact-center |
| Architect ACS with ExpressRoute for private connectivity | https://learn.microsoft.com/en-us/azure/communication-services/tutorials/integrate-express-route |
Limits & Quotas
Security
Configuration
Integrations & Coding Patterns
Deployment
| Topic | URL |
|---|---|
| Meet infrastructure requirements for ACS direct routing | https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure |
| Automate ACS and Email resource deployment with PowerShell | https://learn.microsoft.com/en-us/azure/communication-services/samples/email-resource-management |