Merge pull request #259550 from valindrae/mid-call-actions-ga2

Mid call actions ga2

Author: prmerger-automator[bot]

articles/communication-services/concepts/call-automation/azure-communication-services-azure-cognitive-services-integration.md

@@ -6,25 +6,22 @@ author: kunaal
 ms.service: azure-communication-services
 ms.subservice: call-automation
 ms.topic: include
-ms.date: 08/17/2023
+ms.date: 11/27/2023
 ms.author: kpunjabi
 ms.custom: references_regions
 services: azure-communication-services
 ---
 
 # Connect Azure Communication Services with Azure AI services
 
-[!INCLUDE [Public Preview Disclaimer](../../includes/public-preview-include-document.md)]
-
-
-Azure Communication Services Call Automation APIs provide developers the ability to steer and control the Azure Communication Services Telephony, VoIP or WebRTC calls using 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. These content specific APIs are orchestrated through **Azure Cognitive Services** with support for customization of AI models without developers needing to terminate media streams on their services and streaming back to Azure for AI functionality. 
+Azure Communication Services Call Automation APIs provide developers the ability to steer and control the Azure Communication Services Telephony, VoIP or WebRTC calls using 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. These content specific APIs are orchestrated through **Azure AI Services** with support for customization of AI models without developers needing to terminate media streams on their services and streaming back to Azure for AI functionality. 
 
 All this is possible with one-click where enterprises can access a secure solution and link their models through the portal. Furthermore, developers and enterprises don't need to manage credentials. Connecting your Azure AI services uses managed identities to access user-owned resources. Developers can use managed identities to authenticate any resource that supports Microsoft Entra authentication.
 
 BYO Azure AI services can be easily integrated into any application regardless of the programming language. When creating an Azure Resource in Azure portal, enable the BYO option and provide the URL to the Azure AI services. This simple experience allows developers to meet their needs, scale, and avoid investing time and resources into designing and maintaining a custom solution.
 
 > [!NOTE]
-> This integration is only supported in limited regions for Azure AI services, for more information about which regions are supported please view the limitations section at the bottom of this document. This integration only supports Multi-service Cognitive Service resource, so we recommend if you're creating a new Azure Cognitive Service resource you create a Multi-service Cognitive Service resource or when you're connecting an existing resource confirm that it is a Multi-service Cognitive Service resource.
+> This integration is supported in limited regions for Azure AI services, for more information about which regions are supported please view the limitations section at the bottom of this document. This integration only supports Multi-service Cognitive Service resource, we recommend if you're creating a new Azure AI Service resource you create a Multi-service Cognitive Service resource or when you're connecting an existing resource confirm that it is a Multi-service Cognitive Service resource.
 
 ## Common use cases
 
@@ -124,8 +121,17 @@ This integration between Azure Communication Services and Azure AI services is o
 - northcentralus
 - southcentralus
 - westcentralus
-- westeu
+- westeurope
 - uksouth
+- northeurope
+- southafricanorth
+- canadacentral
+- centralindia
+- eastasia
+- southeastasia
+- australiaeast
+- brazilsouth
+- uaenorth
 
 ## Next steps
 - Learn about [playing audio](../../concepts/call-automation/play-action.md) to callers using Text-to-Speech.

articles/communication-services/how-tos/call-automation/control-mid-call-media-actions.md

@@ -6,16 +6,14 @@ author: kunaal
 ms.topic: how-to
 ms.service: azure-communication-services
 ms.subservice: call-automation
-ms.date: 08/09/2023
+ms.date: 11/16/2023
 ms.author: kpunjabi
 ms.custom: public_preview
 services: azure-communication-services
 ---
 
 # How to control mid-call media actions with Call Automation
 
-[!INCLUDE [Public Preview Disclaimer](../../includes/public-preview-include-document.md)]
-
 Call Automation uses a REST API interface to receive requests for actions and provide responses to notify whether the request was successfully submitted or not. Due to the asynchronous nature of calling, most actions have corresponding events that are triggered when the action completes successfully or fails. This guide covers the actions available to developers during calls, like Send DTMF and Continuous DTMF Recognition. Actions are accompanied with sample code on how to invoke the said action.
 
 Call Automation supports various other actions to manage calls and recording that aren't included in this guide.
@@ -59,19 +57,25 @@ You can send DTMF tones to an external participant, which may be useful when you
 Send a list of DTMF tones to an external participant.
 ### [csharp](#tab/csharp)
 ```csharp
-var tones = new DtmfTone[] { DtmfTone.One, DtmfTone.Two, DtmfTone.Three, DtmfTone.Pound };
+var tones = new DtmfTone[] { DtmfTone.One, DtmfTone.Two, DtmfTone.Three, DtmfTone.Pound }; 
+var sendDtmfTonesOptions = new SendDtmfTonesOptions(tones, new PhoneNumberIdentifier(calleePhonenumber))
+{ 
+	OperationContext = "dtmfs-to-ivr" 
+}; 
 
-await callAutomationClient.GetCallConnection(callConnectionId) 
-    .GetCallMedia() 
-    .SendDtmfTonesAsync(tones, new PhoneNumberIdentifier(c2Target), "dtmfs-to-ivr"); 
+var sendDtmfAsyncResult = await callAutomationClient.GetCallConnection(callConnectionId) 
+	.GetCallMedia() 
+        .SendDtmfTonesAsync(sendDtmfTonesOptions); 
 ```
 ### [Java](#tab/java)
 ```java
 List<DtmfTone> tones = Arrays.asList(DtmfTone.ONE, DtmfTone.TWO, DtmfTone.THREE, DtmfTone.POUND); 
+SendDtmfTonesOptions options = new SendDtmfTonesOptions(tones, new PhoneNumberIdentifier(c2Target)); 
+options.setOperationContext("dtmfs-to-ivr"); 
 callAutomationClient.getCallConnectionAsync(callConnectionId) 
-    .getCallMediaAsync() 
-    .sendDtmfTonesWithResponse(tones, new PhoneNumberIdentifier(c2Target), "dtmfs-to-ivr") 
-    .block(); 
+	.getCallMediaAsync() 
+	.sendDtmfTonesWithResponse(options) 
+	.block(); 
 ```
 ### [JavaScript](#tab/javascript)
 ```javascript
@@ -169,10 +173,12 @@ await callAutomationClient.GetCallConnection(callConnectionId)
 ```
 ### [Java](#tab/java)
 ```java
+ContinuousDtmfRecognitionOptions options = new ContinuousDtmfRecognitionOptions(new PhoneNumberIdentifier(c2Target)); 
+options.setOperationContext("dtmf-reco-on-c2"); 
 callAutomationClient.getCallConnectionAsync(callConnectionId) 
-        .getCallMediaAsync() 
-        .startContinuousDtmfRecognitionWithResponse(new PhoneNumberIdentifier(c2Target), "dtmf-reco-on-c2") 
-        .block(); 
+	.getCallMediaAsync() 
+	.startContinuousDtmfRecognitionWithResponse(options) 
+	.block(); 
 ```
 ### [JavaScript](#tab/javascript)
 ```javascript
@@ -204,16 +210,23 @@ When your application no longer wishes to receive DTMF tones from the participan
 Stop detecting DTMF tones sent by participant.
 ### [csharp](#tab/csharp)
 ```csharp
-await callAutomationClient.GetCallConnection(callConnectionId) 
-    .GetCallMedia() 
-    .StopContinuousDtmfRecognitionAsync(new PhoneNumberIdentifier(c2Target), "dtmf-reco-on-c2"); 
+var continuousDtmfRecognitionOptions = new ContinuousDtmfRecognitionOptions(new PhoneNumberIdentifier(callerPhonenumber)) 
+{ 
+    OperationContext = "dtmf-reco-on-c2" 
+}; 
+
+var startContinuousDtmfRecognitionAsyncResult = await callAutomationClient.GetCallConnection(callConnectionId) 
+    .GetCallMedia() 
+    .StartContinuousDtmfRecognitionAsync(continuousDtmfRecognitionOptions); 
 ```
 ### [Java](#tab/java)
 ```java
+ContinuousDtmfRecognitionOptions options = new ContinuousDtmfRecognitionOptions(new PhoneNumberIdentifier(c2Target)); 
+options.setOperationContext("dtmf-reco-on-c2"); 
 callAutomationClient.getCallConnectionAsync(callConnectionId) 
-        .getCallMediaAsync() 
-        .stopContinuousDtmfRecognitionWithResponse(new PhoneNumberIdentifier(c2Target), "dtmf-reco-on-c2") 
-        .block(); 
+	.getCallMediaAsync() 
+	.stopContinuousDtmfRecognitionWithResponse(options) 
+	.block(); 
 ```
 ### [JavaScript](#tab/javascript)
 ```javascript
@@ -242,40 +255,38 @@ Your application receives event updates when these actions either succeed or fai
 Example of how you can handle a DTMF tone successfully detected.
 ### [csharp](#tab/csharp)
 ``` csharp
-if (acsEvent is ContinuousDtmfRecognitionToneReceived continuousDtmfRecognitionToneReceived) 
+if (acsEvent is ContinuousDtmfRecognitionToneReceived continuousDtmfRecognitionToneReceived) 
 { 
-    logger.LogInformation("Tone detected: sequenceId={sequenceId}, tone={tone}, context={context}", 
-        continuousDtmfRecognitionToneReceived.ToneInfo.SequenceId, 
-        continuousDtmfRecognitionToneReceived.ToneInfo.Tone, 
-        continuousDtmfRecognitionToneReceived.OperationContext); 
+	logger.LogInformation("Tone detected: sequenceId={sequenceId}, tone={tone}", 
+	continuousDtmfRecognitionToneReceived.SequenceId, 
+        continuousDtmfRecognitionToneReceived.Tone); 
 } 
 ```
 ### [Java](#tab/java)
 ``` java
-if (acsEvent instanceof ContinuousDtmfRecognitionToneReceived) { 
-    ContinuousDtmfRecognitionToneReceived event = (ContinuousDtmfRecognitionToneReceived) acsEvent; 
-    log.info("Tone detected: sequenceId=" + event.getToneInfo().getSequenceId() 
-        + ", tone=" + event.getToneInfo().getTone().convertToString() 
-        + ", context=" + event.getOperationContext()); 
+ if (acsEvent instanceof ContinuousDtmfRecognitionToneReceived) { 
+	ContinuousDtmfRecognitionToneReceived event = (ContinuousDtmfRecognitionToneReceived) acsEvent; 
+	log.info("Tone detected: sequenceId=" + event.getSequenceId() 
+		+ ", tone=" + event.getTone().convertToString() 
+		+ ", context=" + event.getOperationContext()); 
 } 
 ```
 ### [JavaScript](#tab/javascript)
 ```javascript
-if (event.type === "Microsoft.Communication.ContinuousDtmfRecognitionToneReceived") {
-	console.log("Tone detected: sequenceId=%s, tone=%s, context=%s",
-		eventData.toneInfo.sequenceId,
-		eventData.toneInfo.tone,
-		eventData.operationContext);
-
-}
+if (event.type === "Microsoft.Communication.ContinuousDtmfRecognitionToneReceived") { 
+	console.log("Tone detected: sequenceId=%s, tone=%s, context=%s", 
+        	eventData.sequenceId, 
+        	eventData.tone, 
+		eventData.operationContext); 
+} 
 ```
 ### [Python](#tab/python)
 ```python
-if event.type == "Microsoft.Communication.ContinuousDtmfRecognitionToneReceived": 
-    app.logger.info("Tone detected: sequenceId=%s, tone=%s, context=%s", 
-                    event.data['toneInfo']['sequenceId'], 
-                    event.data['toneInfo']['tone'], 
-                    event.data['operationContext']) 
+if event.type == "Microsoft.Communication.ContinuousDtmfRecognitionToneReceived":  
+	app.logger.info("Tone detected: sequenceId=%s, tone=%s, context=%s",  
+		event.data['sequenceId'],  
+                event.data['tone'],  
+		event.data['operationContext'])  
 ```
 -----