Skip to content
Holger Imbery edited this page Sep 19, 2025 · 32 revisions

ACSforMCS Documentation

Welcome to ACSforMCS - the telephony integration solution that connects Azure Communication Services with Microsoft Copilot Studio agents.

Quick Navigation

Getting Started

Advanced

Development

What is ACSforMCS?

ACSforMCS enables Microsoft Copilot Studio agents to handle phone calls through Azure Communication Services. Callers can speak naturally with AI agents, with real-time speech-to-text and text-to-speech conversion.

Architecture Overview

Phone Call → Azure Communication Services → ACSforMCS → DirectLine → Copilot Studio

Quick Start Options

Option 1: Deploy to Azure (Recommended)

Deploy to Azure

Post-deployment steps:

  1. Configure phone number and Event Grid (see Phone Number Configuration for detailed steps):

    • Get a phone number from Azure Communication Services
    • Configure Event Grid subscription to route calls to your web app
    • Set up webhook endpoint: https://your-app-name.azurewebsites.net/api/incomingCall
  2. Configure Copilot Studio integration (see DirectLine Secret Setup):

    • Get DirectLine secret from Settings → Security → Web Channel Security
    • Add DirectLine secret to Azure Key Vault
    • Design voice-friendly conversation topics
  3. Use release package for Application Deployment:

    • Download the latest release package
    • Extract and run .\scripts\setup-configuration.ps1 to configure phone number and DirectLine secret
    • Run .\scripts\deploy-application.ps1 to deploy your application code

Option 2: Use Release Package

Download the latest release package and follow the Quick Installation guide.

Key Features

  • Voice-enabled AI conversations through phone calls
  • Real-time speech transcription using Azure Cognitive Services
  • Natural text-to-speech responses with SSML support
  • Call transfer capabilities to human agents
  • Identify CallerID and CalleeID
  • Secure configuration management with Azure Key Vault
  • Production-ready deployment with monitoring endpoints
  • Comprehensive health checks and API documentation

Documentation Structure

This documentation is organized to help you achieve your goals quickly:

Demo

Listen to a sample call interaction: Sample Call Audio

Support

Ready to enable voice conversations for your AI agents? Start with Project Purpose to understand the solution, then proceed to Quick Installation for deployment.

ACSforMCS Documentation

Getting Started

Advanced

Development

Quick Actions

External Links

Demo

Clone this wiki locally