Skip to content

Commit 1681b51

Browse files
committed
Editorial
Ran Acrolinx and improved txt
1 parent 9c4c49d commit 1681b51

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

articles/communication-services/how-tos/call-automation/teams-interop-call-automation.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -18,12 +18,12 @@ services: azure-communication-services
1818

1919
[!INCLUDE [Public Preview Notice](../../includes/public-preview-include.md)]
2020

21-
In this quickstart, we use the Azure Communication Services Call Automation APIs to add, remove and transfer call to a Teams user.
21+
In this quickstart, we use the Azure Communication Services Call Automation APIs to add, remove, and transfer call to a Teams user.
2222

2323
## Prerequisites
2424

2525
- An Azure account with an active subscription, for details see [Create an account for free.](https://azure.microsoft.com/free/).
26-
- A Microsoft Teams phone license and a Teams tenant with administrative privileges. Teams phone license is a must in order to use this feature, learn more about Teams licenses [here](https://www.microsoft.com/microsoft-teams/compare-microsoft-teams-bundle-options). The Microsoft Teams user must also be `voice` enabled, see [setting-up-your-phone-system](/microsoftteams/setting-up-your-phone-system). Administrative privileges are required to authorize Communication Services resource to call Teams users, explained later in Step 1.
26+
- A Microsoft Teams Phone license and a Teams tenant with administrative privileges. Teams Phone license is a must in order to use this feature, learn more about Teams licenses [here](https://www.microsoft.com/microsoft-teams/compare-microsoft-teams-bundle-options). The Microsoft Teams user must also be `voice` enabled, see [setting-up-your-phone-system](/microsoftteams/setting-up-your-phone-system). Administrative privileges are required to authorize Communication Services resource to call Teams users, explained later in Step 1.
2727
- A deployed [Communication Service resource](../../quickstarts/create-communication-resource.md) and valid connection string found by selecting Keys in left side menu on Azure portal.
2828
- [Acquire a PSTN phone number from the Communication Service resource](../../quickstarts/telephony/get-phone-number.md). Note the phone number you acquired to use in this quickstart.
2929
- An Azure Event Grid subscription to receive the `IncomingCall` event.
@@ -32,7 +32,7 @@ In this quickstart, we use the Azure Communication Services Call Automation APIs
3232

3333
## Step 1: Authorization for your Azure Communication Services Resource to enable calling to Microsoft Teams users
3434

35-
To enable calling through Call Automation APIs, a [Microsoft Teams Administrator](/entra/identity/role-based-access-control/permissions-reference#teams-administrator) or [Global Administrator](/entra/identity/role-based-access-control/permissions-reference#global-administrator) must explicitly enable the Communication Services resource(s) access to their tenant to allow calling.
35+
To enable calling through Call Automation APIs, a [Microsoft Teams Administrator](/entra/identity/role-based-access-control/permissions-reference#teams-administrator) or [Global Administrator](/entra/identity/role-based-access-control/permissions-reference#global-administrator) must explicitly enable the Communication Services resources access to their tenant to allow calling.
3636

3737
[Set-CsTeamsAcsFederationConfiguration (MicrosoftTeamsPowerShell)](/powershell/module/teams/set-csteamsacsfederationconfiguration)
3838
Tenant level setting that enables/disables federation between their tenant and specific Communication Services resources.
@@ -43,9 +43,9 @@ User policy that allows the admin to further control which users in their organi
4343
<a name='step-2-use-the-graph-api-to-get-azure-ad-object-id-for-teams-users-and-optionally-check-their-presence'></a>
4444

4545
## Step 2: Use the Graph API to get Microsoft Entra object ID for Teams users and optionally check their presence
46-
A Teams user’s Microsoft Entra object ID (OID) is required to add them to or transfer to them from a Communication Services call. The OID can be retrieved through 1) Office portal, 2) Microsoft Entra admin center, 3) Microsoft Entra Connect; or 4) Graph API. The example below uses Graph API.
46+
A Teams user’s Microsoft Entra object ID (OID) is required to add them to or transfer to them from a Communication Services call. The OID can be retrieved through 1) Office portal, 2) Microsoft Entra admin center, 3) Microsoft Entra Connect; or 4) Graph API. The following example uses Graph API.
4747

48-
Consent must be granted by a Microsoft Entra admin before Graph can be used to search for users, learn more by following on the [Microsoft Graph Security API overview](/graph/security-concept-overview) document. The OID can be retrieved using the list users API to search for users. The following shows a search by display name, but other properties can be searched as well:
48+
A Microsoft Entra admin must grand consent before Graph can be used to search for users, learn more by following on the [Microsoft Graph Security API overview](/graph/security-concept-overview) document. The OID can be retrieved using the list users API to search for users. The following example shows a search by display name, but you can also search for other properties:
4949

5050
[List users using Microsoft Graph v1.0](/graph/api/user-list):
5151
```rest
@@ -133,11 +133,11 @@ call_connection_client.add_participant(target_participant = CallInvite(
133133

134134
-----
135135

136-
On the Microsoft Teams desktop client, Jack's call will be sent to the Microsoft Teams user through an incoming call toast notification.
136+
On the Microsoft Teams desktop client, Jack's call is sent to the Microsoft Teams user through an incoming call toast notification.
137137

138138
![Screenshot of Microsoft Teams desktop client, Jack's call is sent to the Microsoft Teams user through an incoming call toast notification.](./media/incoming-call-toast-notification-teams-user.png)
139139

140-
After the Microsoft Teams user accepts the call, the in-call experience for the Microsoft Teams user will have all the participants displayed on the Microsoft Teams roster. Note that your application that is managing the call using Call Automation API will remain hidden to Teams user on the call screen.
140+
After the Microsoft Teams user accepts the call, the in-call experience for the Microsoft Teams user displays all the participants on the Microsoft Teams roster. Your application that is managing the call using Call Automation API remains hidden to Teams user on the call screen.
141141
![Screenshot of Microsoft Teams user accepting the call and entering the in-call experience for the Microsoft Teams user.](./media/active-call-teams-user.png)
142142

143143
## Step 4: Remove a Teams user from an existing Communication Services call controlled by Call Automation APIs

0 commit comments

Comments
 (0)