Merge pull request #259128 from valindrae/ga2-release

Ga2 release

Author: American-Dipper

articles/communication-services/concepts/call-automation/call-automation.md

@@ -21,7 +21,7 @@ Azure Communication Services Call Automation provides developers the ability to
 Some of the common use cases that can be built using Call Automation include:
 
 - Program VoIP or PSTN calls for transactional workflows such as click-to-call and appointment reminders to improve customer service.
-- Build interactive interaction workflows to self-serve customers for use cases like order bookings and updates, using Play (Audio URL) and Recognize (DTMF) actions.
+- Build interactive interaction workflows to self-serve customers for use cases like order bookings and updates, using Play (Audio URL, Text-to-Speech and SSML) and Recognize (DTMF and Voice) actions.
 - Integrate your communication applications with Contact Centers and your private telephony networks using Direct Routing.
 - Protect your customer's identity by building number masking services to connect buyers to sellers or users to partner vendors on your platform.
 - Increase engagement by building automated customer outreach programs for marketing and customer service.
@@ -44,7 +44,13 @@ The following list presents the set of features that are currently available in
 |                       | Reject an incoming call                           | ✔️    | ✔️    |     ✔️         |    ✔️   |
 | Mid-call scenarios    | Add one or more endpoints to an existing call     | ✔️    | ✔️    |     ✔️         |    ✔️   |
 |                       | Play Audio from an audio file                     | ✔️    | ✔️    |     ✔️         |    ✔️   |
+|                       | Play Audio using Text-to-Speech                   | ✔️    | ✔️    |     ✔️         |    ✔️   |
 |                       | Recognize user input through DTMF                 | ✔️    | ✔️    |     ✔️         |    ✔️   |
+|                       | Recognize user voice inputs                       | ✔️    | ✔️    |     ✔️         |    ✔️   |
+|                       | Start continuous DTMF recognition                 | ✔️    | ✔️    |     ✔️         |    ✔️   |
+|                       | Stop continuous DTMF recognition                  | ✔️    | ✔️    |     ✔️         |    ✔️   |
+|                       | Send DTMF                                         | ✔️    | ✔️    |     ✔️         |    ✔️   |
+|                       | Mute participant                                  | ✔️    | ✔️    |     ✔️         |    ✔️   |
 |                       | Remove one or more endpoints from an existing call| ✔️    | ✔️    |     ✔️         |    ✔️   |
 |                       | Blind Transfer* a 1:1 call to another endpoint    | ✔️    | ✔️    |     ✔️         |    ✔️   |
 |                       | Hang up a call (remove the call leg)              | ✔️    | ✔️    |     ✔️         |    ✔️   |
@@ -96,6 +102,15 @@ When your application answers a call or places an outbound call, you can play an
 **Recognize input**
 After your application has played an audio prompt, you can request user input to drive business logic and navigation in your application. To learn more, view our [concepts](./recognize-action.md) and how-to guide for [Gathering user input](../../how-tos/call-automation/recognize-action.md).
 
+**Continuous DTMF recognition**
+When your application needs to be able to receive DTMF tones at any point in the call without the application needing to trigger a specific recognize action. This can be useful in scenarios where an agent is on a call and needs the user to enter in some kind of ID or tracking number. To learn more about how to use this view our [guide](../../how-tos/call-automation/control-mid-call-media-actions.md).
+
+**Send DTMF**
+When your application needs to send DTMF tones to an external participant, this could be for purposes like dialing out to an external agent and providing the extension number, or something like navigating an external IVR menu.
+
+**Mute**
+Your application can mute certain users based on your business logic. The user would then need to unmute themselves manually if they want to speak. 
+
 **Transfer**
 When your application answers a call or places an outbound call to an endpoint, that call can be transferred to another destination endpoint. Transferring a 1:1 call removes your application's ability to control the call using the Call Automation SDKs.
 
@@ -152,11 +167,16 @@ The Call Automation events are sent to the web hook callback URI specified when
 | ParticipantsUpdated    | The status of a participant changed while your application’s call leg was connected to a call  |
 | PlayCompleted | Your application successfully played the audio file provided |
 | PlayFailed | Your application failed to play audio |
-| PlayCanceled | The requested play action has been canceled. |
+| PlayCanceled | The requested play action has been canceled |
 | RecognizeCompleted | Recognition of user input was successfully completed |
-| RecognizeCanceled | The requested recognize action has been canceled. |
+| RecognizeCanceled | The requested recognize action has been canceled |
 | RecognizeFailed | Recognition of user input was unsuccessful <br/>*to learn more about recognize action events view our how-to guide for [gathering user input](../../how-tos/call-automation/recognize-action.md)*|
-|RecordingStateChanged | Status of recording action has changed from active to inactive or vice versa. |
+|RecordingStateChanged | Status of recording action has changed from active to inactive or vice versa |
+| ContinuousDtmfRecognitionToneReceived | StartContinuousDtmfRecognition completed successfully and a DTMF tone was received from the participant |
+| ContinuousDtmfRecognitionToneFailed | StartContinuousDtmfRecognition completed but an error occurred while handling a DTMF tone from the participant |
+| ContinuousDtmfRecognitionStopped | Successfully executed StopContinuousRecognition |
+| SendDtmfCompleted | SendDTMF completed successfully and the DTMF tones were sent to the target participant |
+| SendDtmfFailed | An error occurred while sending the DTMF tones |
 
 To understand which events are published for different actions, refer to [this guide](../../how-tos/call-automation/actions-for-call-control.md) that provides code samples and sequence diagrams for various call control flows. 
 

articles/communication-services/concepts/call-automation/play-action.md

@@ -15,10 +15,9 @@ The play action provided through the Azure Communication Services Call Automatio
 - Providing Azure Communication Services access to prerecorded audio files of WAV format, that Azure Communication Services can access with support for authentication
 - Regular text that can be converted into speech output through the integration with Azure AI services.
 
-You can use the newly announced integration between [Azure Communication Services and Azure AI services](./azure-communication-services-azure-cognitive-services-integration.md) to play personalized responses using Azure [Text-To-Speech](../../../../articles/cognitive-services/Speech-Service/text-to-speech.md). You can use human like prebuilt neural voices out of the box or create custom neural voices that are unique to your product or brand. For more information on supported voices, languages and locales see [Language and voice support for the Speech service](../../../../articles/cognitive-services/Speech-Service/language-support.md). (Supported in public preview)
-
+You can use the newly announced integration between [Azure Communication Services and Azure AI services](./azure-communication-services-azure-cognitive-services-integration.md) to play personalized responses using Azure [Text-To-Speech](../../../../articles/cognitive-services/Speech-Service/text-to-speech.md). You can use human like prebuilt neural voices out of the box or create custom neural voices that are unique to your product or brand. For more information on supported voices, languages and locales see [Language and voice support for the Speech service](../../../../articles/cognitive-services/Speech-Service/language-support.md).
 > [!NOTE]
-> Azure Communication Services currently supports two file formats, MP3 files and WAV files formatted as 16-bit PCM mono channel audio recorded at 16KHz. You can create your own audio files using [Speech synthesis with Audio Content Creation tool](../../../ai-services/Speech-Service/how-to-audio-content-creation.md). 
+> Azure Communication Services currently supports two file formats, MP3 files with ID3V2TAG and WAV files formatted as 16-bit PCM mono channel audio recorded at 16KHz. You can create your own audio files using [Speech synthesis with Audio Content Creation tool](../../../ai-services/Speech-Service/how-to-audio-content-creation.md). 
 
 ## Prebuilt Neural Text to Speech voices
 Microsoft uses deep neural networks to overcome the limits of traditional speech synthesis with regard to stress and intonation in spoken language. Prosody prediction and voice synthesis occur simultaneously, resulting in a more fluid and natural sounding output. You can use these neural voices to make interactions with your chatbots and voice assistants more natural and engaging. There are over 100 prebuilt voices to choose from. Learn more about [Azure Text-to-Speech voices](../../../../articles/cognitive-services/Speech-Service/language-support.md).
@@ -40,7 +39,7 @@ The play action can also be used to play hold music for callers. This action can
 ### Playing compliance messages
 As part of compliance requirements in various industries, vendors are expected to play legal or compliance messages to callers, for example, “This call is recorded for quality purposes.”.
 
-## Sample architecture for playing audio in call using Text-To-Speech (Public preview)
+## Sample architecture for playing audio in call using Text-To-Speech
 
 ![Diagram showing sample architecture for Play with AI.](./media/play-ai.png)
 

articles/communication-services/how-tos/call-automation/includes/play-audio-how-to-js.md

@@ -5,7 +5,7 @@ services: azure-communication-services
 author: Kunaal Punjabi
 ms.service: azure-communication-services
 ms.subservice: call-automation
-ms.date: 08/10/2023
+ms.date: 11/20/2023
 ms.topic: include
 ms.topic: include file
 ms.author: kpunjabi
@@ -18,6 +18,10 @@ ms.author: kpunjabi
 - Create a new web service application using the [Call Automation SDK](../../../quickstarts/call-automation/callflows-for-customer-interactions.md).
 - Have Node.js installed, you can install it from their [official website](https://nodejs.org).
 
+### For AI features 
+- Create and connect [Azure AI services to your Azure Communication Services resource](../../../concepts/call-automation/azure-communication-services-azure-cognitive-services-integration.md).
+- Create a [custom subdomain](../../../../ai-services/cognitive-services-custom-subdomains.md) for your Azure AI services resource. 
+
 ## Create a new JavaScript application
 Create a new JavaScript application in your project directory. Initialize a new Node.js project with the following command. This creates a package.json file for your project, which is used to manage your project's dependencies. 
 
@@ -38,21 +42,23 @@ node app.js
 
 ## (Optional) Prepare your audio file if you wish to use audio files for playing prompts
 
-Create an audio file, if you don't already have one, to use for playing prompts and messages to participants. The audio file must be hosted in a location that is accessible to Azure Communication Services with support for authentication. Keep a copy of the URL available for you to use when requesting to play the audio file. Azure Communication Services supports both file types of **MP3** and **WAV files, mono 16-bit PCM at 16 KHz sample rate**. 
+Create an audio file, if you don't already have one, to use for playing prompts and messages to participants. The audio file must be hosted in a location that is accessible to Azure Communication Services with support for authentication. Keep a copy of the URL available for you to use when requesting to play the audio file. Azure Communication Services supports both file types of **MP3 files with ID3V2TAG** and **WAV files, mono 16-bit PCM at 16 KHz sample rate**. 
 
 You can test creating your own audio file using our [Speech synthesis with Audio Content Creation tool](../../../../ai-services/Speech-Service/how-to-audio-content-creation.md).
 
-## (Optional) Connect your Azure Cognitive Service to your Azure Communication Service (Public Preview)
+## (Optional) Connect your Azure Cognitive Service to your Azure Communication Service 
 
-If you would like to use Text-To-Speech capabilities, then it's required for you to connect your [Azure Cognitive Service to your Azure Communication Service](../../../concepts/call-automation/azure-communication-services-azure-cognitive-services-integration.md).
+If you would like to use Text-To-Speech capabilities, then it's **required** for you to connect your [Azure Cognitive Service to your Azure Communication Service](../../../concepts/call-automation/azure-communication-services-azure-cognitive-services-integration.md).
 
 ## Establish a call
 
 By this point you should be familiar with starting calls, if you need to learn more about making a call, follow our [quickstart](../../../quickstarts/call-automation/quickstart-make-an-outbound-call.md). You can also use the code snippet provided here to understand how to answer a call.
 
 ```javascript
-const answerCallOptions: AnswerCallOptions = { cognitiveServicesEndpoint: "<https://sample-callback-uri>" }; 
-await callAutomationClient.answerCall("<Incoming call context>", "<https://sample-callback-uri>", answerCallOptions); 
+const callIntelligenceOptions: CallIntelligenceOptions = { "<https://sample-callback-uri>" }; 
+        const answerCallOptions: AnswerCallOptions = { callIntelligenceOptions: callIntelligenceOptions };
+  
+await acsClient.answerCall("<Incoming call context>", "<https://sample-callback-uri>", answerCallOptions); 
 ```
 
 ## Play audio

articles/communication-services/how-tos/call-automation/includes/play-audio-how-to-python.md

@@ -5,7 +5,7 @@ services: azure-communication-services
 author: Kunaal Punjabi
 ms.service: azure-communication-services
 ms.subservice: azure-communication-services
-ms.date: 08/10/2023
+ms.date: 11/20/2023
 ms.topic: include
 ms.topic: include file
 ms.author: kpunjabi
@@ -18,11 +18,10 @@ ms.author: kpunjabi
 - Create a new web service application using the [Call Automation SDK](../../../quickstarts/call-automation/callflows-for-customer-interactions.md).
 - Have Python installed, you can install from the [official site](https://www.python.org/).
 
-### For AI features (Public preview)
+### For AI features 
 - Create and connect [Azure AI services to your Azure Communication Services resource](../../../concepts/call-automation/azure-communication-services-azure-cognitive-services-integration.md).
 - Create a [custom subdomain](../../../../ai-services/cognitive-services-custom-subdomains.md) for your Azure AI services resource. 
 
-
 ## Create a new Python application
 
 ### Set up a Python virtual environment for your project
@@ -59,7 +58,7 @@ Create an audio file, if you don't already have one, to use for playing prompts
 
 You can test creating your own audio file using our [Speech synthesis with Audio Content Creation tool](../../../../ai-services/Speech-Service/how-to-audio-content-creation.md).
 
-## (Optional) Connect your Azure Cognitive Service to your Azure Communication Service (Public Preview)
+## (Optional) Connect your Azure Cognitive Service to your Azure Communication Service
 
 If you would like to use Text-To-Speech capabilities, then it's required for you to connect your [Azure Cognitive Service to your Azure Communication Service](../../../concepts/call-automation/azure-communication-services-azure-cognitive-services-integration.md).
 
@@ -87,7 +86,7 @@ To play audio to participants using audio files, you need to make sure the audio
 play_source = FileSource(url=audioUri)
 ```
 
-### Play source - Text-To-Speech (Public Preview)
+### Play source - Text-To-Speech 
 
 To play audio using Text-To-Speech through Azure AI services, you need to provide the text you wish to play, as well either the SourceLocale, and VoiceKind or the VoiceName you wish to use. We support all voice names supported by Azure AI services, full list [here](../../../../ai-services/Speech-Service/language-support.md?tabs=tts).
 
@@ -115,7 +114,7 @@ call_automation_client.get_call_connection(call_connection_id).play_media(
 )
 ```
 
-### Play source - Text-To-Speech with SSML (Public Preview)
+### Play source - Text-To-Speech with SSML 
 
 If you want to customize your Text-To-Speech output even more with Azure AI services you can use [Speech Synthesis Markup Language SSML](../../../../ai-services/Speech-Service/speech-synthesis-markup.md) when invoking your play action through Call Automation. With SSML you can fine-tune the pitch, pause, improve pronunciation, change speaking rate, adjust volume and attribute multiple voices.