Raw New Markdown
Generating updated version of doc...
Rendered New Markdown
Generating updated version of doc...
---
title: Tutorial - Integrate Microsoft Teams breakout rooms
titleSuffix: An Azure Communication Services tutorial
description: Use Azure Communication Services SDKs to implement Microsoft Teams breakout rooms.
author: sravanthivelidandla
ms.author: insravan
ms.service: azure-communication-services
ms.subservice: teams-interop
ms.topic: how-to
ms.date: 07/15/2024
ms.custom: template-how-to
---
# Breakout rooms
This article describes how to implement Microsoft Teams breakout rooms with Azure Communication Services. This capability enables Azure Communication Services users in Teams meetings to participate in breakout rooms. Teams administrators control the availability of breakout rooms in Teams meeting with Teams meeting policy. You can find additional information about breakout rooms in [Teams documentation](https://support.microsoft.com/office/use-breakout-rooms-in-microsoft-teams-meetings-7de1f48a-da07-466c-a5ab-4ebace28e461).
## Prerequisites
- An Azure account with an active subscription. See [Create an account for free](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn).
- A deployed Communication Services resource. See [Create a Communication Services resource](../../quickstarts/create-communication-resource.md).
- A user access token to enable the calling client. For more information, see [Create and manage access tokens](../../quickstarts/identity/access-tokens.md).
- Teams meeting organizer needs to assign Teams meeting policy that enables breakout rooms. See [Teams meeting policy](/powershell/module/teams/set-csteamsmeetingpolicy?view=teams-ps&preserve-view=true).
- Optional: Complete the quickstart to [add voice calling to your application](../../quickstarts/voice-video-calling/getting-started-with-calling.md).
Only Microsoft 365 Users with Organizer, Co-Organizer, or Breakout Room manager roles can manage the breakout rooms.
## Support
The following tables define support of breakout rooms in Azure Communication Services.
### Identities and call types
The following table shows support in breakout rooms for specific call type and identity.
|Identities | Teams meeting | Room | 1:1 call | Group call | 1:1 Teams interop call | Group Teams interop call |
|-----------------------------|---------------|------|----------|------------|------------------------|--------------------------|
|Communication Services user | ✔️ | | | | | |
|Microsoft 365 user | ✔️ | | | | | |
### Operations
The following table show support for individual APIs in the calling SDK related to individual identity types.
|Operations | Communication Services user | Microsoft 365 user |
|-----------------------------|------------------------------|-------------------|
|Get assigned breakout room | ✔️ | ✔️ |
|Get all breakout rooms | | ✔️[1] |
|Join breakout room | ✔️ | ✔️ |
|Manage breakout rooms | | |
|Participate in breakout room chat | | ✔️[2] |
|Get breakout room settings|✔️ | ✔️ |
[1] Only Microsoft 365 user with role organizer, co-organizer, or breakout room manager.
[2] Microsoft 365 users can use Graph API to participate in breakout room chat. The thread ID of the chat is provided in the assigned breakout room object.
### SDKs
The following tables show support for the breakout rooms feature in individual Azure Communication Services SDKs.
| Support status | Web | Web UI | iOS | iOS UI | Android | Android UI | Windows |
|----------------|-----|--------|--------|--------|----------|--------|---------|
| Is Supported | ✔️ | | | | | | |
[!INCLUDE [BreakoutRooms Client-side JavaScript](./includes/breakoutrooms/breakoutrooms-web.md)]
## Next steps
- [Learn how to manage calls](./manage-calls.md)
- [Learn how to manage video](./manage-video.md)
- [Learn how to record calls](./record-calls.md)
- [Learn how to transcribe calls](./call-transcription.md)