Skip to content

Commit 7d41576

Browse files
v-dirichardsv-dirichards
authored
Merge pull request #272205 from jamescadd/teams-interop-join-group-call
Adds top level linkable page for Teams tenant federation, adds SME Co…
2 parents 4addcc4 + 7e82f8e commit 7d41576

File tree

6 files changed

+141
-12
lines changed

6 files changed

+141
-12
lines changed

‎articles/communication-services/concepts/call-automation/call-automation-teams-interop.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -15,10 +15,11 @@ ms.custom: public_preview
1515
# Deliver expedient customer service by adding Microsoft Teams users in Call Automation workflows
1616

1717
[!INCLUDE [Public Preview Notice](../../includes/public-preview-include.md)]
18+
[!INCLUDE [Teams Phone license](../../includes/teams-phone-license-include.md)]
1819

1920
Businesses are looking for innovative ways to increase the efficiency of their customer service operations. Azure Communication Services Call Automation provides developers the ability to build programmable customer interactions using real-time event triggers to perform actions based on custom business logic. For example, with support for interoperability with Microsoft Teams, developers can use Call Automation APIs to add subject matter experts (SMEs). These SMEs, who use Microsoft Teams, can be added to an existing customer service call to provide expert advice and help resolve a customer issue.
2021

21-
This interoperability with Microsoft Teams over VoIP makes it easy for developers to implement per-region multi-tenant trunks that maximize value and reduce telephony infrastructure overhead. Each new tenant will be able to use this setup in a few minutes after Microsoft Teams admin has granted necessary permissions to the Azure Communication Services resource.
22+
This interoperability with Microsoft Teams over VoIP makes it easy for developers to implement per-region multitenant trunks that maximize value and reduce telephony infrastructure overhead. Each new tenant will be able to use this setup in a few minutes after Microsoft Teams admin has granted necessary permissions to the Azure Communication Services resource.
2223

2324
## Use-cases
2425

@@ -71,9 +72,7 @@ The following list presents the set of features that are currently available in
7172
| -----------------| ----------- |
7273
| Microsoft Teams Desktop | ✔️ |
7374
| Microsoft Teams Web | ✔️ |
74-
| Microsoft Teams iOS | ✔️ |
75-
| Microsoft Teams Android | ✔️ |
76-
| Azure Communications Services signed in with Microsoft 365 Identity | ❌ |
75+
| Azure Communications Services user app signed in with Microsoft 365 Identity | ✔️ |
7776

7877
> [!NOTE]
7978
> While in preview, the support for Microsoft Teams mobile apps is available with limited functionality and some features might not work properly.
@@ -85,7 +84,7 @@ The following list presents the set of features that are currently available in
8584
## Next steps
8685

8786
> [!div class="nextstepaction"]
88-
> [Get started with adding a Microsoft Teams user to an ongoing call using Call Automation](./../../how-tos/call-automation/teams-interop-call-automation.md)
87+
> [Get started with adding a Microsoft Teams user to an ongoing call using Call Automation](../../how-tos/call-automation/teams-interop-call-automation.md)
8988
9089
Here are some articles of interest to you:
9190
- Learn more about [Call Automation](../../concepts/call-automation/call-automation.md) and its features.

‎articles/communication-services/concepts/interop/enable-interoperability-teams.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
title: Enable interoperability with Teams
3+
titleSuffix: An Azure Communication Services concept document
4+
description: Enable interoperability with Teams
5+
author: jamescadd
6+
ms.author: jacadd
7+
ms.date: 4/15/2024
8+
ms.topic: conceptual
9+
ms.service: azure-communication-services
10+
ms.subservice: teams-interop
11+
ms.custom: mode-other, devx-track-js
12+
---
13+
14+
# Enable interoperability between Azure Communication Services and a Microsoft Teams tenant
15+
16+
Azure Communication Services can be used to build applications that enable Microsoft Teams external users to participate in calls and meetings with Microsoft Teams users. [Standard Azure Communication Services pricing](https://azure.microsoft.com/pricing/details/communication-services/) applies to these users, but there's no extra fee for the interoperability capability.
17+
18+
For calls with Teams users, ensure the user is Enterprise Voice enabled. To assign the license, use the [Set-CsPhoneNumberAssignment cmdlet](/powershell/module/teams/set-csphonenumberassignment) and set the **EnterpriseVoiceEnabled** parameter to $true. For additional information, see [Set up Teams Phone in your organization](/microsoftteams/setting-up-your-phone-system).
19+
20+
Follow these steps to enable the connection between a Teams tenant and a Communication Services resource.
21+
22+
[!INCLUDE [Enable interoperability in your Teams tenant](../includes/enable-interoperability-for-teams-tenant.md)]

‎articles/communication-services/concepts/interop/teams-interop-group-calls.md

Lines changed: 88 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,88 @@
1+
---
2+
title: Capabilities for Microsoft Teams users in Azure Communication Services group calls
3+
titleSuffix: An Azure Communication Services concept document
4+
description: Experience for Microsoft Teams users joining an Azure Communication Services group call
5+
author: jamescadd
6+
ms.author: jacadd
7+
ms.date: 4/15/2024
8+
ms.topic: conceptual
9+
ms.service: azure-communication-services
10+
ms.subservice: teams-interop
11+
ms.custom: mode-other, devx-track-js
12+
---
13+
14+
# Capabilities for Microsoft Teams users in Azure Communication Services group calls
15+
16+
Azure Communication Services is interoperable with Microsoft Teams. This is especially helpful for business-to-consumer use cases, where an external customer in a custom, branded Azure-powered app or website communicates with an employee using Microsoft Teams. This allows the external customer to enjoy a custom experience, and the employee to have all their communication needs satisfied in a single hub: Teams.
17+
Azure Communication Services can interoperate with Teams in three ways:
18+
- Azure clients can add an individual Teams user to a 1:1 and group calls. This is ideal for customer service situations where your application is adding Teams-hosted subject matter experts to a call to help agents improve their first call resolution rates.
19+
- Azure clients can directly call a Teams Voice App, such as Auto Attendant and Call Queues. Azure Communication Services enables you to connect customers from your website or application to Teams Voice Apps to handle requests and later handoff to Teams agents as configured in Teams admin center.
20+
- Azure clients can join Teams meetings. This type of interoperability is described on a separate page.
21+
22+
This page details capabilities for Teams (or Microsoft 365) users in a call with Communication Services users (scenario #1). Your service can orchestrate and manage these calls, including adding Teams users to these calls, using Call automation SDK. Read more about it [here](../call-automation/call-automation-teams-interop.md).
23+
24+
[!INCLUDE [Teams Phone license](../../includes/teams-phone-license-include.md)]
25+
26+
M365/Teams user can take calls with Communication Services users via Teams client or [a custom client](../teams-endpoint.md) built using the Azure Communication Services SDKs. To learn about features available for Communication Services user, refer to [voice and video capabilities](../voice-video-calling/calling-sdk-features.md) document.
27+
28+
29+
| **Group of features** | **Capability** | **M365 user on a custom client** | **M365 user on a Teams client** |
30+
|---------------------------|-----------------------------------------------------------------------|-----------------------------------|-----------------------------------|
31+
| Core capabilities | Answer an incoming 1:1 or group call from Communication Services | ✔️ | ✔️ |
32+
| | Reject an incoming 1:1 or group call from Communication Services | ✔️ | ✔️ |
33+
| Roster | Add another Teams user to group call (From your tenant or another federated tenant | ✔️ | ✔️ |
34+
| | Promote a one-to-one call into a group call by adding Azure Communication Services user | ❌ | N/A |
35+
| | Add an Azure Communication Services user to group call | ❌ | N/A |
36+
| | Add PSTN user to group call | ❌ | ❌ |
37+
| | Remove a participant from group call | ✔️ | ✔️ |
38+
| | Placing a call honors Teams external access configuration/federation | ✔️ | ✔️ |
39+
| | Adding Teams users honors Teams external access configuration/federation | ✔️ | ✔️ |
40+
| | List participants | ✔️ | ✔️ |
41+
| Mid call control | Turn your video on/off | ✔️ | ✔️ |
42+
| | Turn off incoming video | ❌ | ✔️ |
43+
| | Mute/Unmute mic | ✔️ | ✔️ |
44+
| | Mute another participant | ❌ | ✔️ |
45+
| | Switch between cameras | ✔️ | ✔️ |
46+
| | Place participant on local hold/un-hold | ✔️ | ✔️ |
47+
| | Indicator of dominant speakers in the call | ✔️ | ✔️ |
48+
| | Choose speaker device for calls | ✔️ | ✔️ |
49+
| | Choose microphone for calls | ✔️ | ✔️ |
50+
| | Indicator of participant's state Idle, Early media, Connected, On hold, Disconnected | ✔️ | ✔️ |
51+
| | Indicator of call's state Ringing, Connected, On Hold | ✔️ | ✔️ |
52+
| | Indicate participants being muted | ✔️ | ✔️ |
53+
| | Indicate participants' reasons for terminating the call | ✔️ | ❌ |
54+
| | Mute notifications | N/A | ✔️ |
55+
| Screen sharing | Share the entire screen from within the application | ✔️ | ✔️ |
56+
| | Share a specific application (from the list of running applications) | ✔️ | ✔️ |
57+
| | Share a web browser tab from the list of open tabs | ✔️ | ✔️ |
58+
| | Share content in "content-only" mode | ✔️ | ✔️ |
59+
| | Receive video stream with content for "content-only" screen sharing experience| ✔️ | ✔️ |
60+
| | Share content in "standout" mode | ❌ | ✔️ |
61+
| | Receive video stream with content for a "standout" screen sharing experience | ❌ | ✔️ |
62+
| | Share content in "side-by-side" mode | ❌ | ✔️ |
63+
| | Receive video stream with content for "side-by-side" screen sharing experience | ❌ | ✔️ |
64+
| | Share content in "reporter" mode | ❌ | ✔️ |
65+
| | Receive video stream with content for "reporter" screen sharing experience | ❌ | ✔️ |
66+
| | Share system audio during screen sharing | ✔️ | ✔️ |
67+
| Device Management (MVP) | Ask for permission to use audio and/or video | ✔️ | ✔️ |
68+
| | Get camera list | ✔️ | ✔️ |
69+
| | Set camera | ✔️ | ✔️ |
70+
| | Get selected camera | ✔️ | ✔️ |
71+
| | Get microphone list | ✔️ | ✔️ |
72+
| | Set microphone | ✔️ | ✔️ |
73+
| | Get selected microphone | ✔️ | ✔️ |
74+
| | Get speakers list | ✔️ | ✔️ |
75+
| | Set speaker | ✔️ | ✔️ |
76+
| | Get selected speaker | ✔️ | ✔️ |
77+
| | Test your mic, speaker, and camera with an audio testing service | ✔️ (available by calling 8:echo123) | ✔️ |
78+
| Engagement | Raise and lower hand | ✔️ | ✔️ |
79+
| | Indicate other participants' raised and lowered hands | ✔️ | ✔️ |
80+
| | Trigger reactions | ❌ | ✔️ |
81+
| | Indicate other participants' reactions | ❌ | ✔️ |
82+
| Recording | Be notified of the call being recorded | ✔️ | ✔️ |
83+
| | Teams compliance recording | ✔️ | ✔️ |
84+
| | Manage Teams transcription | ❌ | ✔️ |
85+
| | Receive information of call being transcribed | ✔️ | ✔️ |
86+
| | Manage Teams closed captions | ✔️ | ✔️ |
87+
88+

0 commit comments

Comments
 (0)