Skip to content

Commit 3f62587

Browse files
Emma-msCopilot
andcommitted
Improve readme for different telephony client
Co-authored-by: Copilot <copilot@github.com>
1 parent f71237d commit 3f62587

1 file changed

Lines changed: 3 additions & 3 deletions

File tree

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,8 @@ The Azure voice live API is a solution enabling low-latency, high-quality speech
88

99
The Azure Communication Services Calls Automation APIs provide telephony integration and real-time event triggers to perform actions based on custom business logic specific to their domain. Within the call automation APIs developers can use simple AI powered APIs, which can be used to play personalized greeting messages, recognize conversational voice inputs to gather information on contextual questions to drive a more self-service model with customers, use sentiment analysis to improve customer service overall. Learn more about [Azure Communication Services (Call Automation)](https://learn.microsoft.com/azure/communication-services/concepts/call-automation/call-automation).
1010

11+
As an alternative for telephony integration, the Twilio Media Streams API provides access to the raw audio from a Programmable Voice call by streaming it over WebSockets to a destination you specify. This enables use cases such as real-time transcriptions, sentiment analysis, voice authentication, and more. You can also stream raw audio into a Twilio Voice call from another application. Learn more about [Twilio Media Streams](https://www.twilio.com/docs/voice/media-streams).
12+
1113

1214
<div align="center">
1315

@@ -31,7 +33,7 @@ The solution includes:
3133
- **Azure Communication Services (ACS)** — enterprise PSTN with Call Automation (default)
3234
- **Twilio** — PSTN via Twilio Media Streams with webhook signature validation
3335

34-
> **Telephony selection:** Only one telephony provider is active at a time. The server auto-detects based on which credentials are configured (e.g. `TWILIO_AUTH_TOKEN` present → Twilio, otherwise → ACS).
36+
> **Telephony selection:** Only one telephony provider can be active at a time. The service automatically selects the provider based on the configured credentials. If no credentials are provided, Azure Communication Services is used by default.
3537
- **Ambient Scenes** (optional): Add realistic background audio (office, call center) or use custom audio files to simulate real-world environments
3638
- Flexible configuration to customize prompts, ASR, TTS, and behavior
3739
- Easy extension to other client types such as [Audiohook](https://learn.microsoft.com/azure/ai-services/speech-service/how-to-use-audiohook)
@@ -238,8 +240,6 @@ Once your event subscription is configured and the phone number is active:
238240

239241
You can switch the telephony provider from ACS to **Twilio** by setting `TWILIO_AUTH_TOKEN`. When this token is configured, the server registers Twilio routes (`/voice` and `/twilio/ws`) instead of ACS routes. Inbound calls are handled via [Twilio Media Streams](https://www.twilio.com/docs/voice/media-streams) — the server validates the request, connects the caller's audio to the AI agent via a real-time WebSocket, and bridges it to Azure Voice Live.
240242
241-
> To switch back to ACS, simply remove or unset `TWILIO_AUTH_TOKEN` and redeploy.
242-
243243
**Prerequisites:**
244244
- A [Twilio account](https://www.twilio.com/try-twilio) with a phone number
245245
- Your **Twilio Auth Token** (found in the [Twilio Console](https://www.twilio.com/console))

0 commit comments

Comments
 (0)