Synchronize Groups from Microsoft Entra ID to Cloud Voice

When Cloud Voice is connected to Microsoft Entra ID, you can choose which directory groups flow into your phone system and become extension groups. This page walks through defining that group synchronization rule and explains how the resulting extension groups behave.

Before you begin

The integration between Cloud Voice and Microsoft Entra ID must already be in place. Which setup guide applies depends on your phone system’s firmware version:

• Firmware 84.22.0.138 or later: follow Integrate Cloud Voice with Microsoft Entra ID.
• Firmware earlier than 84.22.0.138: follow Integrate Cloud Voice with Microsoft Entra ID (Legacy).

Note

Every synced group becomes an extension group, and Cloud Voice supports a maximum of 63 extension groups. That ceiling is the effective limit on how many Microsoft Entra ID groups you can bring in.

Define the group synchronization rule

1. Sign in to the Cloud Voice management portal and open Integrations > Collaboration.

2. Scroll to the Group Synchronization section and turn the switch on.

   

3. Open the Synchronize for drop-down list and choose which groups to pull from Microsoft Entra ID.

   

   Option	What it syncs
   All Groups	Brings in every group from your Microsoft Entra ID directory.
   Specific Group Type	Brings in only the group types you pick. After choosing this option, select one or more values in the Type drop-down: Security Group (all security groups in your directory) or Microsoft 365 (all Microsoft 365 groups in your directory).
   Specific Group	Brings in a hand-picked set of groups. Search for and select the groups you want in the Group drop-down list.

   Note

   The Group drop-down shows up to 200 groups retrieved from Microsoft Entra ID by default. If your directory has more groups than that and you need them listed, contact Cloud Voice support to raise the limit.

   If you later narrow or change which groups are synced, use the Auto delete the Extension Groups no longer in sync option to decide what happens to extension groups that fall out of scope.

   

   • Selected: the orphaned extension groups are removed on the next synchronization.
   • Cleared: the extension groups stay in place and are then managed entirely by Cloud Voice.

   Caution

   Selecting Auto delete the Extension Groups no longer in sync makes Cloud Voice delete those extension groups on the next synchronization, with no separate confirmation prompt. Turn it on only once you are certain the out-of-scope groups are no longer needed. Leave it cleared if you would rather keep the groups and manage them yourself in Cloud Voice.

4. Click Save.

   Note

   The first time you save these synchronization settings, Cloud Voice runs an initial synchronization right away. On later changes, either start a synchronization by hand to apply the rule immediately or let the scheduled synchronization pick it up.

What happens next

Your custom group synchronization rule is now saved. On each run, Cloud Voice queries Microsoft Entra ID against the rule and pulls in the matching groups along with any updated details. Once a synchronization completes:

• You can review the outcome in the Group Synchronization section.

  

• Extension groups that map to Microsoft Entra ID groups are tagged with a Microsoft label and cannot be deleted from Cloud Voice.

• You cannot edit the name or membership of a Microsoft Entra ID-linked extension group directly in Cloud Voice.

Note

Change the name or members of a linked group in Microsoft Entra ID instead. Those edits reach your phone system on the next synchronization.