Skip to content

Commit 13eefcc

Browse files
committed
fixed comments'
1 parent f8e1466 commit 13eefcc

File tree

3 files changed

+13
-13
lines changed

3 files changed

+13
-13
lines changed

articles/communication-services/concepts/teams-endpoint.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
title: Build Azure Communication Services support Teams identities
2+
title: Integrate communication as Teams user with Azure Communication Services
33
titleSuffix: An Azure Communication Services concept document
4-
description: This article discusses how to build Azure Communication Services support Teams identities.
4+
description: This article discusses how to integrate communication as Teams user with Azure Communication Services.
55
author: tomaschladek
66
manager: nmurav
77
services: azure-communication-services
@@ -12,25 +12,25 @@ ms.topic: conceptual
1212
ms.service: azure-communication-services
1313
ms.subservice: teams-interop
1414
---
15-
# Build Azure Communication Services support Teams identities
15+
# Integrate communication as Teams user with Azure Communication Services and Graph API
1616

1717
[!INCLUDE [Public Preview](../includes/public-preview-include-document.md)]
1818

19-
You can use Azure Communication Services and Graph API to build Azure Communication Services support Teams identities to communicate with the Microsoft Teams client or other Azure Communication Services support Teams identities. With Azure Communication Services support Teams identities, you can customize a voice, video, chat, and screen-sharing experience for Teams users.
19+
You can use Azure Communication Services and Graph API to integrate communication as Teams user into your products to communicate with other people in and outside your organization. With Azure Communication Services supporting Teams identities and Graph API, you can customize a voice, video, chat, and screen-sharing experience for Teams users.
2020

2121
You can use the Azure Communication Services Identity SDK to exchange Azure Active Directory (Azure AD) access tokens of Teams users for Communication Identity access tokens. The diagrams in the next sections demonstrate multitenant use cases, where fictional company Fabrikam is the customer of fictional company Contoso.
2222

2323
## Calling
2424

2525
Voice, video, and screen-sharing capabilities are provided via Azure Communication Services Calling SDKs. The following diagram shows an overview of the process you'll follow as you integrate your calling experiences with Azure Communication Services support Teams identities.
2626

27-
![Diagram of the process of enabling the calling feature for Azure Communication Services support Teams identities experience.](./media/teams-identities/teams-identity-calling-overview.svg)
27+
![Diagram of the process to integrate the calling capabilities into your product with Azure Communication Services.](./media/teams-identities/teams-identity-calling-overview.svg)
2828

2929
## Chat
3030

31-
Optionally, you can also use Azure Communication Services support Teams identities to integrate chat capabilities by using Graph APIs. For more information about the Graph API, see the [chat resource type](/graph/api/channel-post-messages) documentation.
31+
Optionally, you can also use Graph API to integrate chat capabilities into your product. For more information about the Graph API, see the [chat resource type](/graph/api/channel-post-messages) documentation.
3232

33-
![Diagram of the process of enabling the chat feature for Azure Communication Services support Teams identities experience.](./media/teams-identities/teams-identity-chat-overview.png)
33+
![Diagram of the process to integrate the chat capabilities into your product with Graph API.](./media/teams-identities/teams-identity-chat-overview.png)
3434

3535
## Azure Communication Services permissions
3636

articles/communication-services/quickstarts/manage-teams-identity.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ ms.custom: mode-other
1717

1818
[!INCLUDE [Public Preview](../../communication-services/includes/public-preview-include-document.md)]
1919

20-
In this quickstart, you'll build a .NET console application to authenticate a Microsoft 365 user by using the Microsoft Authentication Library (MSAL) and retrieving a Microsoft Azure Active Directory (Azure AD) user token. You'll then exchange that token for an access token of Teams user with the Azure Communication Services Identity SDK. The access token for Teams user can then be used by the Communication Services Calling SDK to build Azure Communication Services support Teams identities.
20+
In this quickstart, you'll build a .NET console application to authenticate a Microsoft 365 user by using the Microsoft Authentication Library (MSAL) and retrieving a Microsoft Azure Active Directory (Azure AD) user token. You'll then exchange that token for an access token of Teams user with the Azure Communication Services Identity SDK. The access token for Teams user can then be used by the Communication Services Calling SDK to integrate calling capability as Teams user.
2121

2222
> [!NOTE]
2323
> When you're in a production environment, we recommend that you implement this exchange mechanism in back-end services, because requests for an exchange are signed with a secret.
@@ -37,7 +37,7 @@ The following sections will guide you through the steps for administrators, deve
3737

3838
The Administrator role has extended permissions in Azure AD. Members of this role can set up resources and can read information from the Azure portal. In the following diagram, you can see all actions that have to be executed by Administrators.
3939

40-
![Administrator actions to enable Azure Communication Services support Teams identities experience](./media/teams-identities/teams-identity-admin-overview.svg)
40+
![Administrator actions to enable Azure Communication Services support for Teams identities.](./media/teams-identities/teams-identity-admin-overview.svg)
4141

4242
1. The Contoso Administrator creates or selects an existing *application* in Azure Active Directory. The property *Supported account types* defines whether users from various tenants can authenticate to the application. The property *Redirect URI* redirects a successful authentication request to the Contoso *server*.
4343
1. The Contoso Administrator adds API permissions to `Teams.ManageCalls` and `Teams.ManageChats` from Communication Services.
@@ -112,7 +112,7 @@ The Contoso developer needs to set up the *client application* to authenticate u
112112

113113
The developer's required actions are shown in following diagram:
114114

115-
![Diagram of developer actions to enable Azure Communication Services support Teams identities experience.](./media/teams-identities/teams-identity-developer-overview.svg)
115+
![Diagram of developer actions to enable Azure Communication Services support for Teams identities.](./media/teams-identities/teams-identity-developer-overview.svg)
116116

117117
1. The Contoso developer configures the Microsoft Authentication Library (MSAL) to authenticate the user for the application that was created earlier by the Administrator for Communication Services Teams.ManageCalls and Teams.ManageChats permissions.
118118
1. The Contoso developer initializes the Communication Services Identity SDK and exchanges the incoming Azure AD user token for the access token of Teams user via the identity SDK. The access token of Teams user is then returned to the *client application*.
@@ -145,14 +145,14 @@ For more information about setting up environments in public documentation, see
145145

146146
The user represents the Fabrikam users of the Contoso application. The user experience is shown in the following diagram:
147147

148-
![Diagram of user actions to enable Azure Communication Services support Teams identities experience.](./media/teams-identities/teams-identity-user-overview.svg)
148+
![Diagram of user actions to enable Azure Communication Services support for Teams identities.](./media/teams-identities/teams-identity-user-overview.svg)
149149

150150
1. The Fabrikam user uses the Contoso *client application* and is prompted to authenticate.
151151
1. The Contoso *client application* uses the MSAL to authenticate the user against the Fabrikam Azure AD tenant for the Contoso application with Communication Services Teams.ManageCalls and Teams.ManageChats permissions.
152152
1. Authentication is redirected to the *server*, as defined in the property *Redirect URI* in the MSAL and the Contoso application.
153153
1. The Contoso *server* exchanges the Azure AD user token for the access token of Teams user by using the Communication Services Identity SDK and returns the access token of Teams user to the *client application*.
154154

155-
With a valid access token for Teams user in the *client application*, developers can integrate the Communication Services Calling SDK and build Azure Communication Services support Teams identities.
155+
With a valid access token for Teams user in the *client application*, developers can integrate the Communication Services Calling SDK and manage calls as Teams user.
156156

157157
## Next steps
158158

articles/communication-services/toc.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -238,7 +238,7 @@ items:
238238
href: concepts/teams-interop.md
239239
- name: Join a Teams meeting
240240
href: concepts/join-teams-meeting.md
241-
- name: Azure Communication Services support Teams identities
241+
- name: Communication for Teams identities
242242
items:
243243
- name: Overview
244244
href: concepts/teams-endpoint.md

0 commit comments

Comments
 (0)