Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into nw-vnetflow

Author: halkazwini

articles/azure-cache-for-redis/cache-migration-guide.md

@@ -7,6 +7,8 @@ description: Learn how to migrate your existing cache to Azure Cache for Redis
 ms.topic: conceptual
 ms.custom:
   - ignite-2024
+  - migration
+  - aws-to-azure
 ms.date: 11/17/2021
 ---
 # Migrate to Azure Cache for Redis

articles/azure-resource-manager/management/resource-name-rules.md

@@ -2,7 +2,7 @@
 title: Naming rules and restrictions for Azure resources
 description: Learn the rules and restrictions for naming Azure resources.
 ms.topic: conceptual
-ms.date: 02/19/2025
+ms.date: 03/14/2025
 ---
 
 # Naming rules and restrictions for Azure resources
@@ -634,9 +634,10 @@ In the following tables, the term alphanumeric refers to:
 > | netAppAccounts / backups | NetApp account | 3-225 | Alphanumerics, underscores, periods, and hyphens <br><br> Start with alphanumeric. |
 > | netAppAccounts / backupPolicies | NetApp account | 1-64 | Alphanumerics, underscores, and hyphens <br><br> Start with alphanumeric. |
 > | netAppAccounts / capacityPools | NetApp account | 1-64 |  Alphanumerics, underscores, and hyphens<br><br>Start with alphanumeric. |
+> | netAppAccounts / shareNames | NetApp account | 1-64 | Alphanumerics and hyphens. <br><br>Start with alphanumeric.<br><br>Underscores aren't supported. |
 > | netAppAccounts / snapshots | NetApp account | 1-255 | Alphanumerics, underscores, and hyphens <br><br> Start with alphanumeric. |
 > | netAppAccounts / snapshotPolicies | NetApp account | 1-64 |  Alphanumerics, underscores, and hyphens<br><br>Start with alphanumeric. |
-> | netAppAccounts / volumes | NetApp account | 1-64 | Alphanumerics, underscores, and hyphens <br><br> Start with alphanumeric. <br><br> Volume can't be named `bin` or `default`. |
+> | netAppAccounts / volumes | NetApp account | 1-64 | Alphanumerics and hyphens <br><br> Start with alphanumeric. <br><br> Volume can't be named `bin` or `default`. |
 > | netAppAccounts / volumeGroups | NetApp account | 3-64 |  Alphanumerics, underscores, and hyphens<br><br>Start with alphanumeric. |
 
 ## Microsoft.Network

articles/communication-services/.openpublishing.redirection.communication-services.json

@@ -475,6 +475,11 @@
         "source_path_from_root": "/articles/communication-services/concepts/interop/teams-interop-group-calls.md",
         "redirect_url": "/azure/communication-services/concepts/interop/guest/calling-capabilities",
         "redirect_document_id": false
+        },
+        {
+            "source_path_from_root": "/azure/communication-services/concepts/interop/calling-chat.md",
+            "redirect_url": "/azure/communication-services/concepts/interop/teams-user-calling",
+            "redirect_document_id": false
         }
     ]
 }

articles/communication-services/concepts/call-automation/answer-machine-detection.md

@@ -0,0 +1,74 @@
+---
+title: Building Answer Machine Detection
+titleSuffix: An Azure Communication Services concept document
+description: Learn how to 
+author: Kunaal
+ms.service: azure-communication-services
+ms.subservice: call-automation
+ms.topic: conceptual
+ms.date: 03/07/2025
+ms.author: kpunjabi
+ms.custom: public_preview
+---
+
+# Implementing Answer Machine Detection with Call Automation
+
+Answer Machine Detection (AMD) helps contact centers identify whether a call is answered by a human or an answering machine. This article describes how to implement an AMD solution using Dual-Tone Multi-Frequency (DTMF) tones with Azure Communication Services existing play and recognize APIs.
+
+To achieve this goal, developers can implement logic that uses the call connected event and plays an automated message. This message requests the callee to press a specific key to verify they're human before connecting them to an agent or playing a more specific message.
+
+## Step-by-step guide 
+1. Create an outbound call. For more information about creating outbound calls, see [Make an outbound call using Call Automation](../../quickstarts/call-automation/quickstart-make-an-outbound-call.md).
+2. Once the call is answered, you get a `CallConnected` event. This event lets your application know that the call is answered. At this stage, it could be a human or an answer machine.
+3. After receiving the `CallConnected` event your application should use the [recognize API](./recognize-action.md) and play a message to the callee requesting them to press a number on their dial pad to validate they're human, for example, your application might say "This is a call from [your company name] regarding [reason for call]. Press 1 to be connected to an agent."
+4. If the user presses a key on the dialpad, Azure Communication Services sends a `RecognizeCompleted` event to your application. This indicates that a human answered the call and you should continue with your regular workflow.
+5. If no DTMF input is received, Azure Communication Services sends a `RecognizeFailed` event to your application. This indicates that this call went to voicemail and you should follow your voicemail flow for this call.
+
+## Example code 
+
+```csharp
+//... rest of your code
+
+var ttsMessage = "This is a call from [your company name] regarding [reason for call]. Please press 1 to be connected to an agent.";
+var playSource = new TextSource(ttsMessage)
+{
+    PlaySourceId = "playSourceId"
+};
+
+var playOptions = new PlayOptions
+{
+    Loop = false
+};
+
+callConnection.Play(playSource, playOptions);
+
+var recognizeOptions = new RecognizeOptions(new DtmfOptions(new[] { DtmfTone.One }))
+{
+    InterruptPrompt = false,
+    InitialSilenceTimeout = TimeSpan.FromSeconds(5),
+    PlayPrompt = playSource
+};
+
+var recognizeResult = callConnection.Recognize(recognizeOptions);
+
+// Handle the recognition result
+if (recognizeResult.Status == RecognizeResultStatus.Recognized && recognizeResult.RecognizedTone == DtmfTone.One)
+{
+    // Connect the call to an agent
+    Console.WriteLine("Human detected. Connecting to an agent...");
+    // Add your logic to connect the call to an agent
+}
+else
+{
+    // Classify the call as an answering machine
+    Console.WriteLine("No response detected. Classifying as an answering machine...");
+    // Add your logic to handle answering machine
+}
+
+//... rest of your code
+```
+
+## Next steps
+- Learn more about [Call Automation](../../concepts/call-automation/call-automation.md) and its features. 
+- Learn more about [Play action](../../concepts/call-automation/play-action.md).
+- Learn more about [Recognize action](../../concepts/call-automation/recognize-action.md).

articles/communication-services/concepts/interop/calling-chat.md

@@ -45,7 +45,7 @@ Following table shows when to use Virtual Rooms.
 | When user roles and permissions are needed to conduct well-managed communications. | ✔️ |
 | When solution requires Teams interoperability.* | ❌ |
 
-\* If the solution requires interoperability between Teams and Azure Communication Services, use [Teams interoperability calls](../interop/calling-chat.md)
+\* If the solution requires interoperability between Teams and Azure Communication Services, use [Teams interoperability calls](../interop/teams-user-calling.md)
 
 ## How to conduct calls in Virtual Rooms
 

articles/communication-services/concepts/rooms/room-concept.md

@@ -10,7 +10,7 @@ ms.author: rifox
 ## Place a call
 
 To create and start a call you need to call the `CallAgent.startCall()` method and provide the `Identifier` of the callee(s).
-To join a group call you need to call the `CallAgent.join()` method and provide the groupId. Group Ids must be in GUID or UUID format.
+To join a group call you need to call the `CallAgent.join()` method and provide the groupId. Group IDs must be in GUID or UUID format.
 
 Call creation and start are synchronous. The call instance allows you to subscribe to all events on the call.
 
@@ -176,7 +176,7 @@ call.unmute(appContext).get();
 
 While you are in a call, the hardware volume keys on the phone should allow the user to change the call volume.
 This is done by using the method `setVolumeControlStream` with the stream type `AudioManager.STREAM_VOICE_CALL` on the Activity where the call is being placed.
-This allows the hardware volume keys to change the volume of the call (denoted by a phone icon or something similar on the volume slider), preventing to change the volume for other sound profiles, like alarms, media or system wide volume. For more information, you can check [Handling changes in audio output
+This allows the hardware volume keys to change the volume of the call (denoted by a phone icon or something similar on the volume slider), preventing changing the volume for other sound profiles, like alarms, media or system wide volume. For more information, you can check [Handling changes in audio output
  | Android Developers](https://developer.android.com/guide/topics/media-apps/volume-and-earphones).
 
 ```java
@@ -267,6 +267,8 @@ State can be one of
 > [!NOTE]
 > To use this API please use the Azure Communication Services Calling Android SDK version 2.11.0 or higher. 
 
+Now when a PSTN participant is muted, they should get an announcement that they have been muted and that they can press a key combination (e.g. *6) to unmute themselves. When they press *6, they should be unmuted.
+
 To mute all other participants in a call, use the `muteAllRemoteParticipants` API on the call.
 
 ```java
@@ -296,7 +298,7 @@ call = callAgent.startCall(context, participants, options);
 startService(yourForegroundServiceIntent);
 ```
 
-And stop the Foreground Service when you hangup the call or the call's status is Disconnected, for example:
+And stop the Foreground Service when you hang up the call or the call's status is Disconnected, for example:
 
 ```java
 call.hangUp(new HangUpOptions()).get();

articles/communication-services/how-tos/calling-sdk/includes/manage-calls/manage-calls-android.md

@@ -238,6 +238,8 @@ var videoStreams = remoteParticipant.videoStreams // [RemoteVideoStream, RemoteV
 > [!NOTE]
 > To use this API please use the Azure Communication Services Calling iOS SDK version 2.13.0 or higher. 
 
+Now when a PSTN participant is muted, they should get an announcement that they have been muted and that they can press a key combination (e.g. *6) to unmute themselves. When they press *6, they should be unmuted.
+
 To mute all other participants in a call, use the `muteAllRemoteParticipants` API on the call.
 
 ```swift

articles/communication-services/how-tos/calling-sdk/includes/manage-calls/manage-calls-ios.md

@@ -998,6 +998,8 @@ items:
       href: how-tos/call-automation/play-action.md
     - name: Gather user input with recognize action
       href: how-tos/call-automation/recognize-action.md
+    - name: Implement Answer Machine Detection
+      href: concepts/call-automation/answer-machine-detection.md
   - name: Call recording
     items:
     - name: Call recording overview

articles/communication-services/toc.yml

@@ -73,16 +73,14 @@ Perform the following steps to create a sample flow with the connector in Power
 ### Logic Apps
 
 Perform the following steps to create a sample flow with the connector in Logic Apps.
-1. Navigate to your logic app in the [Azure portal](https://portal.azure.com). Select **Workflows** from the left navigation menu, and **+ Add**. Follow the prompts to create a new workflow.
-1. Select your new flow and enter into the **Designer**.
+1. Navigate to your logic app in the [Azure portal](https://portal.azure.com). Select **Development Tools > Logic app designer** from the left navigation menu.
 1. Add a trigger to your app.
-1. Select **Choose an operation** to add an action from the Azure Digital Twins connector. Search for *Azure Digital Twins* on the **Azure** tab to find the data connection. Select the Azure Digital Twins connection.
+1. Add an action to the flow. To find the Azure Digital Twins connector, search for *Azure Digital Twins*. Select **See more**.
     :::image type="content" source="media/how-to-use-power-platform-logic-apps-connector/logic-apps-action.png" alt-text="Screenshot of Logic Apps, showing the Azure Digital Twins connector." lightbox="media/how-to-use-power-platform-logic-apps-connector/logic-apps-action.png":::
-1. You see a list of all the [actions](/connectors/azuredigitaltwins) that are available with the connector. Pick one of them to interact with the [Azure Digital Twins APIs](/rest/api/azure-digitaltwins/).
-1. After selecting an action from the Azure Digital Twins connector, you're asked to enter authentication details to create the connection.
+1. This shows you a list of all the [actions](/connectors/azuredigitaltwins) that are available with the connector. Pick one of them to interact with the [Azure Digital Twins APIs](/rest/api/azure-digitaltwins/).
+1. After selecting an action from the Azure Digital Twins connector, you're asked to enter authentication details to create the connection. Where the connection asks for **ADT Instance Name**, enter the [host name of your instance](how-to-set-up-instance-portal.md#verify-success-and-collect-important-values).
 1. You can continue to edit or add more steps to your workflow, using other connectors to build out your integration scenario.
 
-
 ## Limitations and suggestions
 
 Here are some limitations of the connector and suggestions for working with them.