events

Author: vac0224

articles/communication-services/quickstarts/events/includes/create-event-subscription-az-cli.md

@@ -3,7 +3,7 @@ author: pgrandhi
 ms.service: azure-communication-services
 ms.custom: devx-track-azurecli
 ms.topic: include
-ms.date: 01/27/2024
+ms.date: 06/28/2024
 ms.author: pgrandhi
 ---
 

articles/communication-services/quickstarts/events/includes/create-event-subscription-azp.md

@@ -2,7 +2,7 @@
 author: pgrandhi
 ms.service: azure-communication-services
 ms.topic: include
-ms.date: 01/26/2024
+ms.date: 06/28/2024
 ms.author: pgrandhi
 ---
 

articles/communication-services/quickstarts/events/includes/create-event-subscription-net.md

@@ -2,7 +2,7 @@
 author: pgrandhi
 ms.service: azure-communication-services
 ms.topic: include
-ms.date: 01/28/2024
+ms.date: 06/28/2025
 ms.author: pgrandhi
 ---
 
@@ -23,6 +23,7 @@ First, install the Microsoft Azure Event Grid Management library for .NET with [
 ```csharp
 dotnet add package Azure.ResourceManager.EventGrid;
 ```
+
 Include the Event Grid Management SDK in your C# project:
 
 ```csharp
@@ -33,8 +34,11 @@ using Microsoft.Azure.Management.EventGrid.Models;
 ## Authenticate with Azure Identity library
 
 1. Create a Microsoft Entra application and Service Principal and set up a client secret or trusted certificate issued by certificate authority. Follow the instructions at [Register a Microsoft Entra app and create a service principal](/entra/identity-platform/howto-create-service-principal-portal).
+
 1. Store the secret or the certificate in the Azure Keyvault. 
+
 1. Give contributor or owner access to the subscription to that application following the instructions at [Grant a user access to Azure resources using the Azure portal](/azure/role-based-access-control/quickstart-assign-role-user-portal).
+
 1. Read more about [Authorizing access to Event Grid resources](/azure/event-grid/security-authorization).
 
 The Azure Identity library provides Microsoft Entra ID token authentication support across the Azure SDK. It provides a set of TokenCredential implementations, which you can use to construct Azure SDK clients that support Microsoft Entra token authentication. For more information, see [Azure Identity client library for .NET](/dotnet/api/overview/azure/identity-readme).
@@ -159,7 +163,7 @@ await eventGridClient.EventSubscriptions.UpdateAsync(
 
 ## Delete event Subscription
 
-This code sample shows how to delete the event subscription for the webhook subscriber endpoint.
+This sample code shows how to delete the event subscription for the webhook subscriber endpoint.
 
 ```csharp
 string webhookUri = $"<webhookUri>";

articles/communication-services/quickstarts/events/includes/create-event-subscription-powershell.md

@@ -3,7 +3,7 @@ author: pgrandhi
 ms.service: azure-communication-services
 ms.custom: devx-track-azurepowershell
 ms.topic: include
-ms.date: 01/27/2024
+ms.date: 06/28/2025
 ms.author: pgrandhi
 ---
 
@@ -24,18 +24,19 @@ First, install the Azure Communication Services module ```Az.EventGrid``` using
 ```PowerShell
 PS C:\> Install-Module Az.EventGrid
 ```
+
 1. Sign in to your Azure subscription with the [Connect-AzAccount](/powershell/module/az.accounts/connect-azaccount) command and follow the on-screen directions.
 
-   ```PowerShell
-   Connect-AzAccount
-   ```
+  ```PowerShell
+  Connect-AzAccount
+  ```
 
 2. If your identity is associated with more than one subscription, then set your active subscription to **subscription of the Web PubSub** resource that you want to move.
 
-   ```PowerShell
-   $context = Get-AzSubscription -SubscriptionId <subscription-id>
-   Set-AzContext $context
-   ```
+  ```PowerShell
+  $context = Get-AzSubscription -SubscriptionId <subscription-id>
+  Set-AzContext $context
+  ```
 
 To create an event subscription using the [Azure PowerShell](/powershell/azure/get-started-azureps), use the [`New-AzEventGridSubscription`](/powershell/module/az.eventgrid/new-azeventgridsubscription) command. 
 
@@ -86,4 +87,4 @@ Get-AzResource
 
 ## Next steps
 
-- For information on other commands, see [Az.EventGrid PowerShell Module](/powershell/module/az.eventgrid/new-azeventgridsubscription).
+- For information about other commands, see [Az.EventGrid PowerShell Module](/powershell/module/az.eventgrid/new-azeventgridsubscription).

articles/communication-services/quickstarts/events/subscribe-to-events.md

@@ -1,12 +1,12 @@
 ---
-title: Subscribe to Azure Communication Services Events
-titleSuffix: An Azure Communication Services quickstart
+title: Subscribe to events
+titleSuffix: An Azure Communication Services article
 description: This article describes how to subscribe to events from Azure Communication Services.
 author: pgrandhi
 manager: rasubram
 services: azure-communication-services
 ms.author: pgrandhi
-ms.date: 01/26/2024
+ms.date: 06/28/2025
 ms.topic: quickstart
 ms.service: azure-communication-services
 ms.subservice: arm
@@ -15,7 +15,7 @@ ms.custom: mode-other, devx-track-azurecli, devx-track-azurepowershell
 ms.devlang: azurecli 
 ---
 
-# Subscribe to Azure Communication Services events
+# Subscribe to events
 
 This article describes how to subscribe to events from Azure Communication Services through the portal, Azure CLI, PowerShell, and .NET SDK.
 

articles/communication-services/quickstarts/voice-video-calling/handle-calling-events.md

@@ -1,36 +1,39 @@
 ---
-title: Quickstart - Handle voice and video calling events
-titleSuffix: An Azure Communication Services quickstart
-description: Learn how to handle voice and video calling events using Azure Communication Services.
+title: View calling events
+titleSuffix: An Azure Communication Services article
+description: This article describes how to handle voice and video calling events using Azure Communication Services.
 author: laithrodan
 manager: micahvivion
 services: azure-communication-services
 ms.author: laithrodan
-ms.date: 12/10/2021
+ms.date: 06/28/2025
 ms.topic: quickstart
 ms.service: azure-communication-services
 ms.subservice: calling 
 ms.custom: mode-other
 ---
-# Quickstart: Handle voice and video calling events
+
+# View calling events
+
 [!INCLUDE [Public Preview](../../includes/public-preview-include-document.md)]
 
-Get started with Azure Communication Services by using Azure Event Grid to handle Communication Services voice and video calling events.
+You can use Azure Event Grid to handle Communication Services voice and video calling events.
 
 ## About Azure Event Grid
 
-[Azure Event Grid](../../../event-grid/overview.md) is a cloud-based eventing service. In this article, you'll learn how to subscribe to events for [communication service events](../../../event-grid/event-schema-communication-services.md), and trigger an event to view the result. Typically, you send events to an endpoint that processes the event data and takes actions. In this article, we'll send the events to a web app that collects and displays the messages.
+[Azure Event Grid](../../../event-grid/overview.md) is a cloud-based eventing service. This article describes how to subscribe to events for [communication service events](../../../event-grid/event-schema-communication-services.md), and trigger an event to view the result. Typically, you send events to an endpoint that processes the event data and takes actions. In this article, we send the events to a web app that collects and displays the messages.
 
 ## Prerequisites
+
 - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
-- An Azure Communication Service resource. Further details can be found in the [Create an Azure Communication Services resource](../create-communication-resource.md) quickstart.
+- An Azure Communication Service resource. For more information, see [Create an Azure Communication Services resource](../create-communication-resource.md).
 - An Azure Communication Services voice and video calling enabled client. [Add voice calling to your app](../voice-video-calling/getting-started-with-calling.md).
 
-## Setting up
+## Set up
 
 ### Enable Event Grid resource provider
 
-If you haven't previously used Event Grid in your Azure subscription, you may need to register the Event Grid resource provider following the steps below:
+If you're new to Event Grid, you might need to register the Event Grid resource provider following these steps:
 
 In the Azure portal:
 
@@ -40,11 +43,11 @@ In the Azure portal:
 4. Find **Microsoft.EventGrid**.
 5. If not registered, select **Register**.
 
-It may take a moment for the registration to finish. Select **Refresh** to update the status. When **Status** is **Registered**, you're ready to continue.
+It might take a moment for the registration to finish. Select **Refresh** to update the status. When **Status** is **Registered**, you're ready to continue.
 
 ### Event Grid Viewer deployment
 
-For this quickstart, we will use the [Azure Event Grid Viewer Sample](/samples/azure-samples/azure-event-grid-viewer/azure-event-grid-viewer/) to view events in near-real time. This will provide the user with the experience of a real-time feed. In addition, the payload of each event should be available for inspection as well.
+In this article, we use the [Azure Event Grid Viewer Sample](/samples/azure-samples/azure-event-grid-viewer/azure-event-grid-viewer/) to view events in near-real time. This  provides the user with the experience of a real-time feed. In addition, the payload of each event should be available for inspection as well.
 
 ## Subscribe to voice and video calling events using web hooks
 
@@ -56,7 +59,7 @@ Press **Add Event Subscription** to enter the creation wizard.
 
 On the **Create Event Subscription** page, Enter a **name** for the event subscription.
 
-You can subscribe to specific events, to tell Event Grid which of the voice and video events you want to subscribe to, and where to send the events. Select the events you'd like to subscribe to from the dropdown menu. For voice and video calling you'll have the option to choose `Call Started`, `Call Ended`, `Call Participant added` and `Call Participant Removed`.
+You can subscribe to specific events, to tell Event Grid which of the voice and video events you want to subscribe to, and where to send the events. Select the events you want to subscribe to from the dropdown menu. For voice and video calling, you can choose `Call Started`, `Call Ended`, `Call Participant added`, or `Call Participant Removed`.
 
 If you're prompted to provide a **System Topic Name**, feel free to provide a unique string. This field has no impact on your experience and is used for internal telemetry purposes.
 
@@ -70,37 +73,36 @@ Select **Web Hook** for **Endpoint type**.
 
 For **Endpoint**, click **Select an endpoint**, and enter the URL of your web app.
 
-In this case, we will use the URL from the [Azure Event Grid Viewer Sample](/samples/azure-samples/azure-event-grid-viewer/azure-event-grid-viewer/) we set up earlier in the quickstart. The URL for the sample will be in the format: `https://{{site-name}}.azurewebsites.net/api/updates`
+In this case, we use the URL from the [Azure Event Grid Viewer Sample](/samples/azure-samples/azure-event-grid-viewer/azure-event-grid-viewer/) we set up earlier in the quickstart. The URL for the sample uses the format: `https://{{site-name}}.azurewebsites.net/api/updates`
 
 Then select **Confirm Selection**.
 
 :::image type="content" source="./../sms/media/handle-sms-events/select-events-create-selectwebhook-epadd.png" alt-text="Screenshot showing confirming a Web Hook Endpoint.":::
 
-## Viewing voice and video calling events
+## View voice and video calling events
 
-### Triggering voice and video calling events
+### Trigger voice and video calling events
 
 To view event triggers, we must first generate the events.
 
-- `Call Started` events are generated when a Azure Communication Services voice and video call is started. To trigger this event, just start a call attached to your Communication Services resource.
-- `Call Ended` events are generated when a Azure Communication Services voice and video call is ended. To trigger this event, just end a call attached to your Communication Services resource.
+- `Call Started` events are generated when an Azure Communication Services voice and video call is started. To trigger this event, just start a call attached to your Communication Services resource.
+- `Call Ended` events are generated when an Azure Communication Services voice and video call is ended. To trigger this event, just end a call attached to your Communication Services resource.
 - `Call Participant Added` events are generated when a participant is added to an Azure Communication Services voice and video call. To trigger this event, add a participant to an Azure Communication Services voice and video call attached to your Communication Services resource.
 - `Call Participant Removed` events are generated when a participant is removed from an Azure Communication Services voice and video call. To trigger this event, remove a participant from an Azure Communication Services voice and video call attached to your Communication Services resource.
 
 Check out the full list of [events supported by Azure Communication Services](../../../event-grid/event-schema-communication-services.md).
 
-### Receiving voice and video calling events
+### Receive voice and video calling events
 
-Once you complete either action above you will notice that voice and video calling events are sent to your endpoint. These events will show up in the [Azure Event Grid Viewer Sample](/samples/azure-samples/azure-event-grid-viewer/azure-event-grid-viewer/) we set up at the beginning. You can press the eye icon next to the event to see the entire payload.
+Once you complete either action of the previous actions, you notice voice and video calling events are sent to your endpoint. These events show up in the [Azure Event Grid Viewer Sample](/samples/azure-samples/azure-event-grid-viewer/azure-event-grid-viewer/) we set up at the beginning. You can press the eye icon next to the event to see the entire payload.
 
 Learn more about the [event schemas and other eventing concepts](../../../event-grid/event-schema-communication-services.md).
 
 ## Clean up resources
 
 If you want to clean up and remove a Communication Services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it. Learn more about [cleaning up resources](../create-communication-resource.md#clean-up-resources).
 
+## Related articles
 
-You may also want to:
-
- - [Learn about event handling concepts](../../../event-grid/event-schema-communication-services.md)
- - [Learn about Event Grid](../../../event-grid/overview.md)
+- [Learn about event handling concepts](../../../event-grid/event-schema-communication-services.md)
+- [Learn about Event Grid](../../../event-grid/overview.md)