azure-communication-services

name	azure-communication-services
description	Expert knowledge for Azure Communication Services development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building ACS calling/chat apps, PSTN/phone numbers, SMS/email, Teams interop, or Job Router workloads, and other Azure Communication Services related development tasks. Not for Azure AI Bot Service (use azure-bot-service), Azure Notification Hubs (use azure-notification-hubs), Azure Web PubSub (use azure-web-pubsub), Azure SignalR Service (use azure-signalr-service).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-04-12","generator":"docs2skills/1.0.0"}

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), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools 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_fetch with query string from=learn-agent-skill. Returns Markdown.
• Fallback: Use fetch_webpage with query string from=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-L153	Guidance on ACS/Teams design decisions: PSTN options and pricing, phone numbers, Teams interop and licensing, gov cloud usage, and migrating from Twilio Video/Chat to ACS.
Architecture & Design Patterns	L154-L159	Designing scalable contact center solutions with ACS and patterns for integrating ACS with ExpressRoute for secure, private connectivity and network architecture.
Limits & Quotas	L160-L227	Limits, quotas, regional availability, and restrictions for ACS calling, phone numbers, email, Teams interop, media features, and troubleshooting token/metric-related issues.
Security	L228-L254	Security, auth, and compliance for ACS: encryption, identities, HMAC, webhooks, Teams interop controls, captions/RTT/transcription data, caller ID, WhatsApp/email, and emergency calling.
Configuration	L255-L334	Monitoring, logging, metrics, and diagnostics for ACS (chat, voice/video, SMS, email, calling, routing), plus configuration for Teams interop, domains, routing, UI library, and SMS/email compliance.
Integrations & Coding Patterns	L335-L481	Patterns and code to integrate ACS calling, chat, SMS, email, Rooms, Job Router, and WhatsApp with apps, bots, Teams, OpenAI, push/events, media, and telephony features.
Deployment	L482-L486	Infrastructure and deployment guidance for Azure Communication Services: direct routing requirements and automating ACS/Email resource provisioning with PowerShell.

Troubleshooting

Topic	URL
Use Job Router operational logs for diagnostics	https://learn.microsoft.com/en-us/azure/communication-services/concepts/analytics/logs/router-logs
Troubleshoot ACS email custom domain configuration issues	https://learn.microsoft.com/en-us/azure/communication-services/concepts/email/email-domain-configuration-troubleshooting
Monitor logs and metrics for ACS Teams external users	https://learn.microsoft.com/en-us/azure/communication-services/concepts/interop/guest/monitor-logs-metrics
Troubleshoot common Teams Phone extensibility issues with ACS	https://learn.microsoft.com/en-us/azure/communication-services/concepts/interop/tpe/teams-phone-extensibility-troubleshooting
Resolve common Azure SMS questions and issues	https://learn.microsoft.com/en-us/azure/communication-services/concepts/sms/sms-faq
Troubleshoot ACS direct routing outbound call failures	https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/monitoring-troubleshooting-telephony/troubleshoot-outbound-calls
Fix ACS direct routing TLS certificate and SIP OPTIONS issues	https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/monitoring-troubleshooting-telephony/troubleshoot-tls-certificate-sip-options
Troubleshoot ACS PSTN call failures using result codes	https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/troubleshooting-pstn-call-failures
Collect troubleshooting information for Azure Communication Services

Best Practices

Topic	URL
Apply best practices for ACS Calling SDK usage	https://learn.microsoft.com/en-us/azure/communication-services/concepts/best-practices
Implement answer machine detection with DTMF logic	https://learn.microsoft.com/en-us/azure/communication-services/concepts/call-automation/answer-machine-detection
Apply best practices for Communication Services user access tokens	https://learn.microsoft.com/en-us/azure/communication-services/concepts/credentials-best-practices
Manage Azure email opt-outs for B2C delivery	https://learn.microsoft.com/en-us/azure/communication-services/concepts/email/email-optout-management
Improve Azure email sender reputation and complaints	https://learn.microsoft.com/en-us/azure/communication-services/concepts/email/sender-reputation-managed-suppression-list
Govern Teams meeting experience for ACS virtual visits	https://learn.microsoft.com/en-us/azure/communication-services/concepts/interop/virtual-visits/govern-meeting-experience
Optimize user experience for ACS–Teams virtual appointments	https://learn.microsoft.com/en-us/azure/communication-services/concepts/interop/virtual-visits/plan-user-experience
Choose and use Raw ID string identifiers in ACS	https://learn.microsoft.com/en-us/azure/communication-services/concepts/raw-id-use-cases
Follow Azure SMS and email messaging policies	https://learn.microsoft.com/en-us/azure/communication-services/concepts/sms/messaging-policy
Fill Azure SMS short code program brief correctly

Decision Making

Topic	URL
Use Azure Advisor recommendations for ACS optimization	https://learn.microsoft.com/en-us/azure/communication-services/concepts/advisor-overview
Use ACS Teams interop in government cloud environments	https://learn.microsoft.com/en-us/azure/communication-services/concepts/interop/guest/government-cloud
Use ACS Teams user features in government cloud environments	https://learn.microsoft.com/en-us/azure/communication-services/concepts/interop/teams-user/government-cloud
Choose PSTN connectivity options and estimate cost for Teams Phone extensibility	https://learn.microsoft.com/en-us/azure/communication-services/concepts/interop/tpe/teams-phone-extensibility-connectivity-cost
Decide on migration from Twilio Video to ACS Calling	https://learn.microsoft.com/en-us/azure/communication-services/concepts/migrate-to-azure-communication-services
Choose ACS phone number types and regions	https://learn.microsoft.com/en-us/azure/communication-services/concepts/numbers/number-types
Understand pricing model for ACS Teams interop scenarios	https://learn.microsoft.com/en-us/azure/communication-services/concepts/pricing/teams-interop-pricing
Plan ACS PSTN usage with pricing and billing rules	https://learn.microsoft.com/en-us/azure/communication-services/concepts/pstn-pricing
Determine Teams license requirements for ACS Teams interop	https://learn.microsoft.com/en-us/azure/communication-services/quickstarts/eligible-teams-licenses
Design and integrate custom event platforms with Teams and ACS

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

Topic	URL
Understand Call Automation metrics definitions and units	https://learn.microsoft.com/en-us/azure/communication-services/concepts/analytics/logs/call-automation-metrics
Supported MIME types for ACS email attachments	https://learn.microsoft.com/en-us/azure/communication-services/concepts/email/email-attachment-allowed-mime-types
Request higher email sending quotas in ACS	https://learn.microsoft.com/en-us/azure/communication-services/concepts/email/email-quota-increase
Review known issues and limitations for ACS Teams external users	https://learn.microsoft.com/en-us/azure/communication-services/concepts/interop/guest/limitations
Argentina ACS phone number availability and restrictions	https://learn.microsoft.com/en-us/azure/communication-services/concepts/numbers/phone-number-management-for-argentina
Australia ACS phone number availability and restrictions	https://learn.microsoft.com/en-us/azure/communication-services/concepts/numbers/phone-number-management-for-australia
Austria ACS phone number availability and restrictions	https://learn.microsoft.com/en-us/azure/communication-services/concepts/numbers/phone-number-management-for-austria
Belgium ACS phone number availability and restrictions	https://learn.microsoft.com/en-us/azure/communication-services/concepts/numbers/phone-number-management-for-belgium
Brazil ACS phone number availability and restrictions	https://learn.microsoft.com/en-us/azure/communication-services/concepts/numbers/phone-number-management-for-brazil

Security

Topic	URL
Understand data transfer and terms for WhatsApp in Azure	https://learn.microsoft.com/en-us/azure/communication-services/concepts/advanced-messaging/whatsapp/whatsapp-terms-of-service
Configure authentication methods for Azure Communication Services	https://learn.microsoft.com/en-us/azure/communication-services/concepts/authentication
Understand ACS call flow topologies and encryption	https://learn.microsoft.com/en-us/azure/communication-services/concepts/detailed-call-flows
Apply sender authentication best practices in Azure	https://learn.microsoft.com/en-us/azure/communication-services/concepts/email/email-authentication-best-practice
Configure Azure email domains and authentication	https://learn.microsoft.com/en-us/azure/communication-services/concepts/email/email-domain-and-sender-authentication
Use Azure Communication Services in US Government clouds	https://learn.microsoft.com/en-us/azure/communication-services/concepts/government
Configure authentication for single-tenant and multitenant ACS Teams apps	https://learn.microsoft.com/en-us/azure/communication-services/concepts/interop/custom-teams-endpoint-authentication-overview
Configure closed captions for ACS–Teams interop calls	https://learn.microsoft.com/en-us/azure/communication-services/concepts/interop/enable-closed-captions
Enable and license Teams interoperability for ACS users	https://learn.microsoft.com/en-us/azure/communication-services/concepts/interop/enable-interoperability-teams

Configuration

Topic	URL
Configure Advanced Messaging diagnostic logs in Azure	https://learn.microsoft.com/en-us/azure/communication-services/concepts/advanced-messaging/logs
Meet prerequisites to use WhatsApp in Copilot Studio	https://learn.microsoft.com/en-us/azure/communication-services/concepts/advanced-messaging/whatsapp/whatsapp-channel-prerequisites
Use Azure Communication Services chat metrics in Azure Monitor	https://learn.microsoft.com/en-us/azure/communication-services/concepts/analytics/chat-metrics
Configure Azure Monitor logging and metrics for Communication Services	https://learn.microsoft.com/en-us/azure/communication-services/concepts/analytics/enable-logging
Use Call Automation Insights workbooks for monitoring	https://learn.microsoft.com/en-us/azure/communication-services/concepts/analytics/insights/call-automation-insights
Use Call Recording Insights workbooks for analytics	https://learn.microsoft.com/en-us/azure/communication-services/concepts/analytics/insights/call-recording-insights
View Azure Communication Services chat insights with Workbooks	https://learn.microsoft.com/en-us/azure/communication-services/concepts/analytics/insights/chat-insights
Use Azure Workbooks for email insights dashboards	https://learn.microsoft.com/en-us/azure/communication-services/concepts/analytics/insights/email-insights
Monitor SMS activity with Azure insights dashboard	https://learn.microsoft.com/en-us/azure/communication-services/concepts/analytics/insights/sms-insights

Integrations & Coding Patterns

Topic	URL
Stream call audio with Call Automation Audio Streaming APIs	https://learn.microsoft.com/en-us/azure/communication-services/concepts/call-automation/audio-streaming-concept
Integrate Call Automation with Foundry Tools	https://learn.microsoft.com/en-us/azure/communication-services/concepts/call-automation/azure-communication-services-azure-cognitive-services-integration
Use Call Automation play action for audio prompts	https://learn.microsoft.com/en-us/azure/communication-services/concepts/call-automation/play-action
Use real-time transcription with Call Automation	https://learn.microsoft.com/en-us/azure/communication-services/concepts/call-automation/real-time-transcription
Gather caller input with Call Automation Recognize	https://learn.microsoft.com/en-us/azure/communication-services/concepts/call-automation/recognize-action
Configure push notifications for ACS chat and calling apps	https://learn.microsoft.com/en-us/azure/communication-services/concepts/notifications
Use ACS Number Lookup to retrieve phone insights	https://learn.microsoft.com/en-us/azure/communication-services/concepts/numbers/number-lookup-concept
Integrate ACS Number Lookup SDK into applications	https://learn.microsoft.com/en-us/azure/communication-services/concepts/numbers/number-lookup-sdk
Control calls with Call Automation REST actions	https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/actions-for-call-control

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