Update custom-teams-endpoint-use-cases.md

tomaschladek · web-flow · commit 28cbc0341257 · 2022-02-01T15:35:40.000+01:00
diff --git a/articles/communication-services/concepts/interop/custom-teams-endpoint-use-cases.md b/articles/communication-services/concepts/interop/custom-teams-endpoint-use-cases.md
@@ -13,30 +13,30 @@ ms.service: azure-communication-services
 ms.subservice: teams-interop
 ---
 
-# Custom Teams Endpoint - Use cases
+# Custom Teams Endpoint — Use cases
 
-Microsoft Teams provides identities managed by Azure Active Directory and calling experiences controlled by Teams Admin Center and policies. Users might have assigned licenses to enable PSTN connectivity and advanced calling capabilities of Teams Phone System. Azure Communication Services are supporting Teams identities for managing Teams VoIP calls, Teams PSTN calls, and join Teams meetings. Developers might extend the Azure Communication Services with Graph API to provide contextual data from Microsoft 365 ecosystem. This page is providing inspiration on how to leverage existing Microsoft technologies to provide an end-to-end experience for calling scenarios with Teams users and Azure Communication Services calling SDKs. 
+Microsoft Teams provides identities managed by Azure Active Directory and calling experiences controlled by Teams Admin Center and policies. Users might have assigned licenses to enable PSTN connectivity and advanced calling capabilities of Teams Phone System. Azure Communication Services are supporting Teams identities for managing Teams VoIP calls, Teams PSTN calls, and join Teams meetings. Developers might extend the Azure Communication Services with Graph API to provide contextual data from Microsoft 365 ecosystem. This page is providing inspiration on how to use existing Microsoft technologies to provide an end-to-end experience for calling scenarios with Teams users and Azure Communication Services calling SDKs. 
 
 ## Use case 1: Make outbound Teams PSTN call
 This scenario is showing a multi-tenant use case, where company Contoso is providing SaaS to company Fabrikam. SaaS allows Fabrikam's users to make Teams PSTN calls via a custom website that takes the identity of the Teams user and configuration of the PSTN connectivity assigned to that Teams user.
 
 ![Diagram is showing user experience of Alice making Teams PSTN call to customer Megan.](./media/custom-teams-endpoint/end-to-end-use-cases/cte-e2e-cte-to-pstn-out-overview.svg)
 
-The following sequence diagram is showing detailed steps of initiating a PSTN call:
+The following sequence diagram shows detailed steps of initiation of a Teams PSTN call:
 
 :::image type="content" source="./media/custom-teams-endpoint/end-to-end-use-cases/cte-e2e-cte-to-pstn-out-full.svg" alt-text="Sequence diagram is describing detailed set of steps, that happens to initiate a Teams PSTN call using Azure Communication Services and Teams." lightbox="./media/custom-teams-endpoint/end-to-end-use-cases/cte-e2e-cte-to-pstn-out-full.svg":::
 
 ### Steps
 1. Authenticate Alice from Fabrikam in Contoso's client application: Alice is using a browser to open Fabrikam's web page and authenticates. You can find more details about [the authentication with Teams identity](./custom-teams-endpoint-authentication-overview.md). If the authentication is successful, Alice is redirected to the initial page.
 2. Load customers and their PSTN numbers: Contoso provides custom logic to retrieve the list of customers and their associated phone numbers. This list is rendered on the initial page to Alice.
-3. Initiate a call to Megan: Alice selects a button to initiate a PSTN call to Megan in the Contoso's Client application. Client application leverages Azure Communication Services calling SDK to provide the calling capability. First, it creates an instance of callAgent, that holds the Azure Communication Services access token acquired during 1st step.
+3. Initiate a call to Megan: Alice selects a button to initiate a PSTN call to Megan in the Contoso's Client application. Client application uses Azure Communication Services calling SDK to provide the calling capability. First, it creates an instance of callAgent, that holds the Azure Communication Services access token acquired during first step.
 
 ```js
 const callClient = new CallClient(); 
 tokenCredential = new AzureCommunicationTokenCredential('<AlICE_ACCESS_TOKEN>');
 callAgent = await callClient.createCallAgent(tokenCredential)
 ```
-Then the user needs to start a call to Megan's phone number.
+Then you need to start a call to Megan's phone number.
 
 ```js
 const pstnCallee = { phoneNumber: '<MEGAN_PHONE_NUMBER_E164_FORMAT>' }
@@ -50,20 +50,20 @@ This scenario is showing a multi-tenant use case, where company Contoso is provi
 
 ![Diagram is showing user experience of Alice receiving Teams PSTN call from customer Megan.](./media/custom-teams-endpoint/end-to-end-use-cases/cte-e2e-cte-to-pstn-in-overview.svg)
 
-The following sequence diagram is showing detailed steps of receiving a PSTN call:
+The following sequence diagram shows detailed steps for accepting incoming Teams PSTN calls:
 
 :::image type="content" source="./media/custom-teams-endpoint/end-to-end-use-cases/cte-e2e-cte-to-pstn-in-full.svg" alt-text="Sequence diagram is describing detailed set of steps, that happens to receive a Teams PSTN call using Azure Communication Services and Teams." lightbox="./media/custom-teams-endpoint/end-to-end-use-cases/cte-e2e-cte-to-pstn-in-full.svg":::
 
 ### Steps
 1. Authenticate Alice from Fabrikam in Contoso's client application: Alice is using a browser to open Fabrikam's web page and authenticates. You can find more details about [the authentication with Teams identity](./custom-teams-endpoint-authentication-overview.md). If the authentication is successful, Alice is redirected to the initial page.
-2. Subscribe for receiving calls: Client application leverages Azure Communication Services calling SDK to provide the calling capability. First, it creates an instance of callAgent, that holds the Azure Communication Services access token acquired during 1st step.
+2. Subscribe for receiving calls: Client application uses Azure Communication Services calling SDK to provide the calling capability. First, it creates an instance of callAgent, that holds the Azure Communication Services access token acquired during first step.
 
 ```js
 const callClient = new CallClient(); 
 tokenCredential = new AzureCommunicationTokenCredential('<AlICE_ACCESS_TOKEN>');
 callAgent = await callClient.createCallAgent(tokenCredential)
 ```
-Then user subscribes to the incoming call event.
+Then you subscribe to the incoming call event.
 
 ```js
 const incomingCallHandler = async (args: { incomingCall: IncomingCall }) => {
@@ -74,23 +74,23 @@ const incomingCallHandler = async (args: { incomingCall: IncomingCall }) => {
 };
 callAgent.on('incomingCall', incomingCallHandler);
 ```
-The method _showIncomingCall_ is a custom Contoso's method that will render a user interface to indicate incoming calls and two buttons to accept and decline the call. If the user selects accept button, then the following code is used:
+The method _showIncomingCall_ is a custom Contoso's method that will render a user interface to indicate incoming calls and two buttons to accept and decline the call. If you select accept button, then the following code is used:
 
 ```js
 // Accept the call
 var call = await incomingCall.accept();
 ```
 
-If the user selects the decline button, then the following code is used:
+If you select the decline button, then the following code is used:
 
 
 ```js
 // Reject the call
 incomingCall.reject();
 ```
 
-3. Megan start's a call to PSTN number assigned to Teams user Alice: Megan uses her phone to call Alice. The carrier network will connect to Teams PSTN connectivity assigned to Alice and it will ring all Teams endpoints registered for Alice. It includes existing Teams desktop, mobile, web clients, and applications based on Azure Communication Services calling SDK authenticated as Alice.
-4. Contoso's client application shows Megan's incoming call: Client application receives incoming call notification. _showIncomingCall_ method would use custom Contoso's logic to translate the phone number to customer's name (e.g., a database storing key-value pairs phone number and customer name). When the information is retrieved the notification is shown to Alice in Contoso's client application.
+3. Megan start's a call to PSTN number assigned to Teams user Alice: Megan uses her phone to call Alice. The carrier network will connect to Teams PSTN connectivity assigned to Alice and it will ring all Teams endpoints registered for Alice. It includes: Teams desktop, mobile, web clients, and applications based on Azure Communication Services calling SDK.
+4. Contoso's client application shows Megan's incoming call: Client application receives incoming call notification. _showIncomingCall_ method would use custom Contoso's logic to translate the phone number to customer's name (for example, a database storing key-value pairs consisting of a phone number and customer name). When the information is retrieved, the notification is shown to Alice in Contoso's client application.
 5. Alice accepts the call: Alice selects a button to accept the call and the connection between Alice and Megan is established.
 
 
@@ -99,7 +99,7 @@ This scenario is showing a multi-tenant use case, where company Contoso is provi
 
 ![Diagram is showing user experience of Alice making Teams VoIP call to colleague Megan.](./media/custom-teams-endpoint/end-to-end-use-cases/cte-e2e-cte-to-voip-out-overview.svg)
 
-The following sequence diagram is showing detailed steps of initiating a VoIP call:
+The following sequence diagram shows detailed steps for initiation of a Teams VoIP call:
 
 :::image type="content" source="./media/custom-teams-endpoint/end-to-end-use-cases/cte-e2e-cte-to-voip-out-full.svg" alt-text="Sequence diagram is describing detailed set of steps, that happens to initiate a Teams VoIP call using Azure Communication Services and Teams." lightbox="./media/custom-teams-endpoint/end-to-end-use-cases/cte-e2e-cte-to-voip-out-full.svg":::
 
@@ -116,7 +116,7 @@ Response: response.body.value[1].displayName; // ”Megan Bowen”
 
 Contoso's client application will then show the list of users and the ability to initiate a call to a given user.
 
-3. Initiate a call to Megan: Alice selects a button to initiate a Teams VoIP call to Megan in the Contoso's Client application. Client application leverages Azure Communication Services calling SDK to provide the calling capability. Calls in Teams Clients are associated with Teams chat. First, the application requests creation of a dedicated chat for the VoIP call.
+3. Initiate a call to Megan: Alice selects a button to initiate a Teams VoIP call to Megan in the Contoso's Client application. Client application uses Azure Communication Services calling SDK to provide the calling capability. Calls in Teams Clients are associated with Teams chat. First, the application requests creation of a dedicated chat for the VoIP call.
 
 ```
 POST https://graph.microsoft.com/v1.0/chats
@@ -144,14 +144,14 @@ Permissions: Chat.Create (delegated)
 Response: response.body.value.id; // "19:8c0a1a67-50ce-4114-bb6c-da9c5dbcf6ca_e8b753b5-4117-464e-9a08-713e1ff266b3@unq.gbl.spaces"
 ```
 
-Then the client application creates an instance of callAgent, that holds the Azure Communication Services access token acquired during 1st step.
+Then the client application creates an instance of callAgent, that holds the Azure Communication Services access token acquired during first step.
 
 ```js
 const callClient = new CallClient(); 
 tokenCredential = new AzureCommunicationTokenCredential('<AlICE_ACCESS_TOKEN>');
 callAgent = await callClient.createCallAgent(tokenCredential)
 ```
-Then user starts a call to Megan's Teams ID.
+Then you start a call to Megan's Teams ID.
 
 ```js
 var teamsUser = { microsoftTeamsUserId: 'e8b753b5-4117-464e-9a08-713e1ff266b3'};
@@ -167,13 +167,13 @@ This scenario is showing a multi-tenant use case, where company Contoso is provi
 
 ![Diagram is showing user experience of Alice receiving Teams VoIP call from customer Megan.](./media/custom-teams-endpoint/end-to-end-use-cases/cte-e2e-cte-to-voip-in-overview.svg)
 
-The following sequence diagram is showing detailed steps of receiving a VoIP call:
+The following sequence diagram shows detailed steps for accepting incoming Teams VoIP calls:
 
 :::image type="content" source="./media/custom-teams-endpoint/end-to-end-use-cases/cte-e2e-cte-to-voip-in-full.svg" alt-text="Sequence diagram is describing detailed set of steps, that happens to receive a Teams VoIP call using Azure Communication Services. Graph API, and Teams." lightbox="./media/custom-teams-endpoint/end-to-end-use-cases/cte-e2e-cte-to-voip-in-full.svg":::
 
 ### Steps
 1. Authenticate Alice from Fabrikam in Contoso's client application: Alice is using a browser to open Fabrikam's web page and authenticates. You can find more details about [the authentication with Teams identity](./custom-teams-endpoint-authentication-overview.md). If the authentication is successful, Alice is redirected to the initial page.
-2. Subscribe for receiving calls: Client application leverages Azure Communication Services calling SDK to provide the calling capability. First, it creates an instance of callAgent, that holds the Azure Communication Services access token acquired during 1st step.
+2. Subscribe for receiving calls: Client application uses Azure Communication Services calling SDK to provide the calling capability. First, it creates an instance of callAgent, that holds the Azure Communication Services access token acquired during first step.
 
 ```js
 const callClient = new CallClient(); 
@@ -191,22 +191,22 @@ const incomingCallHandler = async (args: { incomingCall: IncomingCall }) => {
 };
 callAgent.on('incomingCall', incomingCallHandler);
 ```
-The method _showIncomingCall_ is a custom Contoso's method that will render a user interface to indicate incoming calls and two buttons to accept and decline the call. If the user selects accept button then the following code is used:
+The method _showIncomingCall_ is a custom Contoso's method that will render a user interface to indicate incoming calls and two buttons to accept and decline the call. If you select accept button then the following code is used:
 
 ```js
 // Accept the call
 var call = await incomingCall.accept();
 ```
 
-If the user selects the decline button, then the following code is used:
+If you select the decline button, then the following code is used:
 
 
 ```js
 // Reject the call
 incomingCall.reject();
 ```
 
-3. Megan start's a VoIP call to Teams user Alice: Megan uses her Teams desktop client to call Alice. The Teams infrastructure will ring all endpoints associated with Alice. It includes existing Teams desktop, mobile, web clients, and applications based on Azure Communication Services calling SDK authenticated as Alice.
+3. Megan start's a VoIP call to Teams user Alice: Megan uses her Teams desktop client to call Alice. The Teams infrastructure will ring all endpoints associated with Alice. It includes: Teams desktop, mobile, web clients, and applications based on Azure Communication Services calling SDK.
 4. Contoso's client application shows Megan's incoming call: Client application receives incoming call notification. _showIncomingCall_ method would use Graph API to translate the Teams user ID to display name. 
  
 ```
@@ -216,7 +216,7 @@ Response: response.body.value.displayName; // ”Megan Bowen”
 	  response.body.value.id; // "e8b753b5-4117-464e-9a08-713e1ff266b3"
 ```
 
-When the information is retrieved the notification is shown to Alice in Contoso's client application.
+When the information is retrieved, the notification is shown to Alice in Contoso's client application.
 
 5. Alice accepts the call: Alice selects a button to accept the call and the connection between Alice and Megan is established.
 
@@ -225,7 +225,7 @@ This scenario is showing a multi-tenant use case, where company Contoso is provi
 
 ![Diagram is showing user experience of Alice joining Teams Meeting.](./media/custom-teams-endpoint/end-to-end-use-cases/cte-e2e-cte-to-meeting-overview.svg)
 
-The following sequence diagram is showing detailed steps of joining a Teams meeting:
+The following sequence diagram shows detailed steps for joining a Teams meeting:
 
 :::image type="content" source="./media/custom-teams-endpoint/end-to-end-use-cases/cte-e2e-cte-to-meeting-full.svg" alt-text="Sequence diagram is describing detailed set of steps, that happens to join a Teams meeting using Azure Communication Services, Graph API, and Teams." lightbox="./media/custom-teams-endpoint/end-to-end-use-cases/cte-e2e-cte-to-meeting-full.svg":::
 
@@ -245,7 +245,7 @@ Response: response.body.value[0].subject; // ”Project Tailspin”
 
 Contoso's client application will then show the list of Teams meetings and the ability to join them.
 
-3. Join Teams meeting "Project Tailspin": Alice selects a button to join Teams meeting "Project Tailspin" in the Contoso's Client application. Client application leverages Azure Communication Services calling SDK to provide the calling capability. Client applications create an instance of callAgent, that holds the Azure Communication Services access token acquired during 1st step.
+3. Join Teams meeting "Project Tailspin": Alice selects a button to join Teams meeting "Project Tailspin" in the Contoso's Client application. Client application uses Azure Communication Services calling SDK to provide the calling capability. Client applications create an instance of callAgent, that holds the Azure Communication Services access token acquired during first step.
 
 ```js
 const callClient = new CallClient(); 
