Skip to content

Commit 71b15c9

Browse files
v-ccolinv-ccolin
authored
Merge pull request #206355 from tomaschladek/patch-14
Update teams-endpoint.md
2 parents 0e85d92 + caeb187 commit 71b15c9

File tree

11 files changed

+390
-49
lines changed

11 files changed

+390
-49
lines changed

‎articles/communication-services/concepts/interop/custom-teams-endpoint-use-cases.md

Lines changed: 34 additions & 28 deletions
Large diffs are not rendered by default.

‎articles/communication-services/concepts/interop/guest/capabilities.md

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
---
2+
title: Capabilities for Teams guests
3+
titleSuffix: An Azure Communication Services concept document
4+
description: Calling capabilities of Azure Communication Services support for Teams guests
5+
author: tomaschladek
6+
ms.author: tchladek
7+
ms.date: 7/9/2022
8+
ms.topic: conceptual
9+
ms.service: azure-communication-services
10+
ms.subservice: teams-interop
11+
---
12+
13+
# Capabilities for Teams guests
14+
15+
In this article, you will learn which capabilities are supported for Teams guests using Azure Communication Services SDKs.
16+
17+
## Client capabilities
18+
The following table shows supported client-side capabilities available in Azure Communication Services SDKs:
19+
20+
| Capability | Supported |
21+
| --- | --- |
22+
| Send and receive chat messages | ✔️ |
23+
| Use typing indicators | ✔️ |
24+
| Read receipt | ❌ |
25+
| File sharing | ❌ |
26+
| Reply to chat message | ❌ |
27+
| React to chat message | ❌ |
28+
| Audio and video calling | ✔️ |
29+
| Share screen and see shared screen | ✔️ |
30+
| Manage Teams convenient recording | ❌ |
31+
| Manage Teams transcription | ❌ |
32+
| Receive closed captions | ❌ |
33+
| Add and remove meeting participants | ❌ |
34+
| Raise and lower hand | ❌ |
35+
| See raised and lowered hand | ❌ |
36+
| See and set reactions | ❌ |
37+
| Control Teams third-party applications | ❌ |
38+
| Interact with a poll or Q&A | ❌ |
39+
| Set and unset spotlight | ❌ |
40+
| See PowerPoint Live | ❌ |
41+
| See Whiteboard | ❌ |
42+
| Participation in breakout rooms | ❌ |
43+
| Apply background effects | ❌ |
44+
| See together mode video stream | ❌ |
45+
46+
When Teams guest leaves the meeting, or the meeting ends, they can no longer send or receive new chat messages and no longer have access to messages sent and received during the meeting.
47+
48+
## Server capabilities
49+
50+
The following table shows supported server-side capabilities available in Azure Communication Services:
51+
52+
|Capability | Supported |
53+
| --- | --- |
54+
| [Manage ACS call recording](../../voice-video-calling/call-recording.md) | ❌ |
55+
| [Azure Metrics](../../metrics.md) | ✔️ |
56+
| [Azure Monitor](../../logging-and-diagnostics.md) | ✔️ |
57+
| [Azure Communication Services Insights](../../analytics/insights.md) | ✔️ |
58+
| [Azure Communication Services Voice and video calling events](../../../../event-grid/communication-services-voice-video-events.md) | ❌ |
59+
60+
61+
## Teams capabilities
62+
63+
The following table shows supported Teams capabilities:
64+
65+
|Capability | Supported |
66+
| --- | --- |
67+
| [Teams Call Analytics](/MicrosoftTeams/use-call-analytics-to-troubleshoot-poor-call-quality) | ✔️ |
68+
| [Teams real-time Analytics](/microsoftteams/use-real-time-telemetry-to-troubleshoot-poor-meeting-quality) | ❌ |
69+
70+
71+
## Next steps
72+
73+
- [Authenticate as Teams guest](../../../quickstarts/access-tokens.md)
74+
- [Join Teams meeting audio and video as Teams guest](../../../quickstarts/voice-video-calling/get-started-teams-interop.md)
75+
- [Join Teams meeting chat as Teams guest](../../../quickstarts/chat/meeting-interop.md)
76+
- [Join meeting options](../../../how-tos/calling-sdk/teams-interoperability.md)
77+
- [Communicate as Teams user](../../teams-endpoint.md).
78+

‎articles/communication-services/concepts/interop/guest/limitations.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
title: Known issues and limitations
3+
titleSuffix: An Azure Communication Services concept document
4+
description: Known issues and limitations of Azure Communication Services support for Teams guests
5+
author: tomaschladek
6+
ms.author: tchladek
7+
ms.date: 7/9/2022
8+
ms.topic: conceptual
9+
ms.service: azure-communication-services
10+
ms.subservice: teams-interop
11+
---
12+
13+
# Known issues and limitations
14+
15+
- When using Microsoft Graph to [list the participants in a Teams meeting](/graph/api/call-list-participants), details for Communication Services users are not currently included.
16+
- Teams meetings support up to 1000 participants, but the Azure Communication Services Calling SDK currently only supports 350 participants, and Chat SDK supports 250 participants.
17+
- With [Cloud Video Interop for Microsoft Teams](/microsoftteams/cloud-video-interop), some devices have seen issues when a Communication Services user shares their screen.
18+
- [Teams activity handler events](/microsoftteams/platform/bots/bot-basics?tabs=csharp) for bots don't fire when Communication Services users join a Teams meeting.
19+
20+
## Next steps
21+
22+
- [Authenticate as Teams guest](../../../quickstarts/access-tokens.md)
23+
- [Join Teams meeting audio and video as Teams guest](../../../quickstarts/voice-video-calling/get-started-teams-interop.md)
24+
- [Join Teams meeting chat as Teams guest](../../../quickstarts/chat/meeting-interop.md)
25+
- [Join meeting options](../../../how-tos/calling-sdk/teams-interoperability.md)
26+
- [Communicate as Teams user](../../teams-endpoint.md).

‎articles/communication-services/concepts/interop/guest/overview.md

Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
---
2+
title: Communication as Teams guest
3+
titleSuffix: An Azure Communication Services concept document
4+
description: Introduction to Azure Communication Services support for Teams guests
5+
author: tomaschladek
6+
ms.author: tchladek
7+
ms.date: 7/9/2022
8+
ms.topic: conceptual
9+
ms.service: azure-communication-services
10+
ms.subservice: teams-interop
11+
---
12+
13+
# Communication as Teams guest
14+
15+
You can use Azure Communication Services to build applications that enable external users to join and participate in Teams meetings as Teams anonymous users (Guests). Customers can join Teams meetings from within your applications or websites. The main benefits are:
16+
- No requirement to download Teams desktop, mobile or web clients for external users
17+
- External users don't lose context by switching to another application
18+
- Browser support on mobile devices
19+
- User interface (UI) customization
20+
- No additional Teams licenses are required
21+
22+
## Use cases
23+
Here are real-world examples of applications:
24+
- Healthcare provider uses Teams clients to conduct telehealth virtual visit with a patient who uses a healthcare provider application or website
25+
- Customers interested in mortgage schedules virtual consultation on Bank's website with a Bank clerk, who joins consultation via Teams client
26+
- Manufacturer schedules a virtual conference for partners to announce the launch of a new product. Partners can join the launch via a web browser on their phones
27+
28+
## Prototyping
29+
30+
Developers can experiment with the capabilities on multiple levels to evaluate, learn and customize the product.
31+
32+
### Low code or no-code
33+
34+
You can create an identity and access token for Teams guests on Azure portal without a single line of code. [Here are steps how to do it](../../../quickstarts/identity/quick-create-identity.md).
35+
36+
With a valid identity, access token, and Teams meeting URL, you can use [Azure Communication Services UI Library](https://azure.github.io/communication-ui-library/?path=/story/composites-call-with-chat-jointeamsmeeting--join-teams-meeting) to join Teams meeting without any code.
37+
38+
### Single-click deployment
39+
40+
The [Azure Communication Services Calling Hero Sample](../../../samples/calling-hero-sample.md) demonstrates how developers can use Azure Communication Services Calling Web SDK to join a Teams meeting from a web application as a Teams guest. You can experiment with the capability with single-click deployment to Azure.
41+
42+
### Coding
43+
44+
The data flow for joining Teams meetings is available at the [client and server architecture page](../../client-and-server-architecture.md). When implementing the experience, you must implement client logic for real-time communication and server logic for authentication. The following articles will guide you in implementing the communication for Teams guests.
45+
46+
High-level coding articles:
47+
1. [Authenticate as Teams guest](../../../quickstarts/access-tokens.md)
48+
1. [Stateful Client (Meeting)](https://azure.github.io/communication-ui-library/?path=/story/composites-meeting-basicexample--basic-example)
49+
50+
Low-level coding articles:
51+
1. [Join Teams meeting audio and video as Teams guest](../../../quickstarts/voice-video-calling/get-started-teams-interop.md)
52+
1. [Join Teams meeting chat as Teams guest](../../../quickstarts/chat/meeting-interop.md)
53+
1. [Join meeting options](../../../how-tos/calling-sdk/teams-interoperability.md)
54+
55+
## Supported use cases
56+
57+
The following table show supported use cases for Teams guest with Azure Communication Services:
58+
59+
| Scenario | Supported |
60+
| --- | --- |
61+
| Join Teams meeting | ✔️ |
62+
| Join channel Teams meeting [1] | ✔️ |
63+
| Join Teams webinar [2] | ✔️ |
64+
| [Join Teams live events](/microsoftteams/teams-live-events/what-are-teams-live-events).| ❌ |
65+
| Join [Teams meeting scheduled in application for personal use](https://www.microsoft.com/microsoft-teams/teams-for-home) | ❌ |
66+
| Join Teams 1:1 or group call | ❌ |
67+
| Join Teams 1:1 or group chat | ❌ |
68+
69+
- [1] Teams guests can join a channel Teams meeting with audio and video, but they won't be able to send or receive any chat messages
70+
- [2] Teams guest users may join a Teams webinar. However, the presenter and attendee roles aren't honored for Teams guests. Thus Teams guests on Azure Communication Services SDKs could perform actions not intended for attendees, such as screen sharing, turning their camera on/off, or unmuting themselves, if your application provides UX for those actions.
71+
72+
## Pricing
73+
Any licensed Teams users can schedule Teams meetings and share the invite with external users. External users can join the Teams meeting experience via existing Teams desktop, mobile, and web clients without additional charge. External users joining via Azure Communication Services SDKs will pay
74+
[standard Azure Communication Services consumption](https://azure.microsoft.com/pricing/details/communication-services/) for audio, video, and chat. There's no additional fee for the interoperability capability itself.
75+
76+
77+
## Next steps
78+
79+
- [Authenticate as Teams guest](../../../quickstarts/access-tokens.md)
80+
- [Join Teams meeting audio and video as Teams guest](../../../quickstarts/voice-video-calling/get-started-teams-interop.md)
81+
- [Join Teams meeting chat as Teams guest](../../../quickstarts/chat/meeting-interop.md)
82+
- [Join meeting options](../../../how-tos/calling-sdk/teams-interoperability.md)
83+
- [Communicate as Teams user](../../teams-endpoint.md).

‎articles/communication-services/concepts/interop/guest/privacy.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
---
2+
title: User privacy for Teams guests
3+
titleSuffix: An Azure Communication Services concept document
4+
description: User privacy requirements in Azure Communication Services support for Teams guests
5+
author: tomaschladek
6+
ms.author: tchladek
7+
ms.date: 7/9/2022
8+
ms.topic: conceptual
9+
ms.service: azure-communication-services
10+
ms.subservice: teams-interop
11+
---
12+
13+
# Privacy
14+
Interoperability between Azure Communication Services and Microsoft Teams enables your applications and users to participate in Teams calls, meetings, and chats. It is your responsibility to ensure that the users of your application are notified when recording or transcription are enabled in a Teams call or meeting.
15+
16+
Microsoft will indicate to you via the Azure Communication Services API that recording or transcription has commenced, and you must communicate this fact, in real-time, to your users within your application's user interface. You agree to indemnify Microsoft for all costs and damages incurred due to your failure to comply with this obligation.
17+
18+
## Chat storage
19+
20+
All chat messages sent by Teams users or Communication Services users during a Teams meeting are stored in the geographic region associated with the Microsoft 365 organization hosting the meeting. For more information, review the article [Location of data in Microsoft Teams](/microsoftteams/location-of-data-in-teams). For each Teams guest joining via Azure Communication Services SDKs in the meetings, there is a copy of the most recently sent message stored in the geographic region associated with the Communication Services resource used to develop the Communication Services application. Review the article [Region availability and data residency](./privacy.md).
21+
22+
Azure Communication Services will delete all copies of the most recently sent message per Teams retention policies. If no retention policy is defined, Azure Communication Services deletes data after 30 days. For more information about Teams retention policies, review the article [Learn about retention for Microsoft Teams](/microsoft-365/compliance/retention-policies-teams).
23+
24+
## Next steps
25+
26+
- [Authenticate as Teams guest](../../../quickstarts/access-tokens.md)
27+
- [Join Teams meeting audio and video as Teams guest](../../../quickstarts/voice-video-calling/get-started-teams-interop.md)
28+
- [Join Teams meeting chat as Teams guest](../../../quickstarts/chat/meeting-interop.md)
29+
- [Join meeting options](../../../how-tos/calling-sdk/teams-interoperability.md)
30+
- [Communicate as Teams user](../../teams-endpoint.md).

‎articles/communication-services/concepts/interop/guest/teams-administration.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
title: Teams controls for Teams guest
3+
titleSuffix: An Azure Communication Services concept document
4+
description: Teams administrator controls to impact Azure Communication Services support for Teams guests
5+
author: tomaschladek
6+
ms.author: tchladek
7+
ms.date: 7/9/2022
8+
ms.topic: conceptual
9+
ms.service: azure-communication-services
10+
ms.subservice: teams-interop
11+
---
12+
13+
# Teams administrator controls
14+
Teams administrators have the following policies to control the experience for Teams guests in Teams meetings.
15+
16+
|Setting name|Policy scope|Description| Supported |
17+
| ---- | ----| ----| --- |
18+
| [Anonymous users can join a meeting](/microsoftteams/meeting-settings-in-teams#allow-anonymous-users-to-join-meetings) | organization-wide | If disabled, Teams guests can't join Teams meeting | ✔️ |
19+
| [Let anonymous people join a meeting](/microsoftteams/meeting-settings-in-teams#allow-anonymous-users-to-join-meetings) | per-organizer | If disabled, Teams guests can't join Teams meeting | ✔️ |
20+
| [Let anonymous people start a meeting](/microsoftteams/meeting-settings-in-teams#allow-anonymous-users-to-join-meetings)| per-organizer | If enabled, Teams guests can start a Teams meeting without Teams user | ✔️ |
21+
| [Automatically admit people](/microsoftteams/meeting-policies-participants-and-guests#automatically-admit-people) | per-organizer | If set to "Everyone", Teams guests can bypass lobby. Otherwise, Teams guests have to wait in the lobby until an authenticated user admits them.| ✔️ |
22+
| [Who can present in meetings](/microsoftteams/meeting-policies-in-teams-general#designated-presenter-role-mode) | per-user | Controls who in the Teams meeting can share screen | ❌ |
23+
| [Blocked anonymous join client types](/powershell/module/skype/set-csteamsmeetingpolicy) | per-organizer | If property "BlockedAnonymousJoinClientTypes" is set to "Teams" or "Null", the Teams guests via Azure Communication Services can join Teams meeting | ✔️ |
24+
25+
Your custom application should consider user authentication and other security measures to protect Teams meetings. Be mindful of the security implications of enabling anonymous users to join meetings. Use the [Teams security guide](/microsoftteams/teams-security-guide#addressing-threats-to-teams-meetings) to configure capabilities available to anonymous users.
26+
27+
## Next steps
28+
29+
- [Authenticate as Teams guest](../../../quickstarts/access-tokens.md)
30+
- [Join Teams meeting audio and video as Teams guest](../../../quickstarts/voice-video-calling/get-started-teams-interop.md)
31+
- [Join Teams meeting chat as Teams guest](../../../quickstarts/chat/meeting-interop.md)
32+
- [Join meeting options](../../../how-tos/calling-sdk/teams-interoperability.md)
33+
- [Communicate as Teams user](../../teams-endpoint.md).

‎articles/communication-services/concepts/interop/guest/teams-client-experience.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
title: Teams client experience for Teams guest
3+
titleSuffix: An Azure Communication Services concept document
4+
description: Teams client experience of Azure Communication Services support for Teams guests
5+
author: tomaschladek
6+
ms.author: tchladek
7+
ms.date: 7/9/2022
8+
ms.topic: conceptual
9+
ms.service: azure-communication-services
10+
ms.subservice: teams-interop
11+
---
12+
13+
# Experience for users in Teams client
14+
Teams guest joining Teams meeting with Azure Communication Services SDKs will be represented in Teams client as any other Teams anonymous user. Teams guests will be marked as "external" in the participant's lists as Teams clients. As Teams anonymous users, their capabilities in the Teams meeting will be limited regardless of the assigned Teams meeting role.
15+
16+
## Next steps
17+
18+
- [Authenticate as Teams guest](../../../quickstarts/access-tokens.md)
19+
- [Join Teams meeting audio and video as Teams guest](../../../quickstarts/voice-video-calling/get-started-teams-interop.md)
20+
- [Join Teams meeting chat as Teams guest](../../../quickstarts/chat/meeting-interop.md)
21+
- [Join meeting options](../../../how-tos/calling-sdk/teams-interoperability.md)
22+
- [Communicate as Teams user](../../teams-endpoint.md).

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

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

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

‎articles/communication-services/concepts/troubleshooting-info.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -304,7 +304,7 @@ You can find your current Teams license using [licenseDetails](/graph/api/resour
304304
]
305305
}
306306
```
307-
1. Find license detail where property `servicePlanName` has one of the values in the [Eligible Teams Licenses table](../quickstarts/eligible-teams-licenses.md#eligible-teams-licenses)
307+
1. Find license detail where property `servicePlanName` has one of the values in the [Eligible Teams Licenses table](../quickstarts/eligible-teams-licenses.md)
308308
309309
310310
## Calling SDK error codes

0 commit comments

Comments
 (0)