[Index]

Model: device/msgraph/Group

Teams

Full HTML Help

Overview

VOSS Automate allows you to manage Microsoft Teams from within the Admin portal. Changes you make to teams in VOSS Automate or in the Microsoft Teams online portal are synced.

A team comprises its members, its channels (where team members share messages and other resources), and its privacy and permissions settings.

Related Topics

• Teams Templates
• Groups

Syncing Teams and Groups on Large Microsoft Tenants in the Best Practice Guide

Add and Update MS Teams

This procedure adds, edits, or deletes Microsoft Teams, teams and team members, in VOSS Automate.

Pre-requisites:

• When configuring VOSS Automate for Microsoft, you will need to assign the following permissions to the API registration in the MS Entra admin portal to allow MS Teams objects to successfully sync in to VOSS Automate, and to allow you to manage these objects in VOSS Automate:
  • TeamMember.Read.All,
  • TeamMember.ReadWrite.All,
  • TeamMember.Read.Group

To add and update MS teams:

1. In the VOSS Automate Admin Portal, go to (default menus) Subscriber Management > Teams.

2. View existing teams in the list view.

   Note

   • The number of Teams in the list view matches the number of Teams in the Microsoft Portal.
   • The Teams list view displays synced in data for MS Teams. Clicking on a Team to view its details triggers a live update from the Microsoft Entra ID portal to fetch additional details for the Team, including its members and channels. This is to ensure efficient and fast data syncing for Teams and Groups from Microsoft Entra ID. Data syncs for Teams and Groups are handled in the same way in the Automate GUI. Since Microsoft doesn't differentiate between Teams and Groups, both the Teams and Groups list view and details page point to the same model, device/msgraph/Group, with a filter applied to differentiate between these entities in the Automate GUI.

3. Choose an option:

   • Edit a team: To edit a MS team, click on the relevant team in the list view to open its management page, then update settings, and click Save.

     Note

     You can add or remove members, change member roles, update Team settings, and archive, unarchive, or delete a team, and move a team (Provider admin only). However, channel membership type is read-only in the Automate Admin Portal, and will need to be updated in the Microsoft Portal, if required.

     To archive or unarchive a Team, select the relevant team(s) in the list view, then click the relevant toolbar option (Archive Team or Unarchive Team). The Is Archived checkbox is read-only when a team is archived, and you can't add or update team members and channels.

     All changes are synced to the Microsoft Teams online portal.

   • Move a team: As a Provider admin, you can move one or more MS teams via the list view, or click on a team to open its configuration page, then move the team.

     Note

     When moving a team, team members remain at their existing location. Only the team is moved. However, let's say you moved a team to a site and you want to add additional members, then you can add new members that are at the site where the team now exists, even though the team still contains members that may be at a different location in the hierarchy.

   • Add a team: To add a MS team, click the Plus icon (+) to open the Teams page, then fill out team details:

     • Fill out a display name (mandatory) and (optionally) a description.

     • Choose a privacy policy, either public or private.

       Note

       The default is Public.

     • At Is Archived define whether the team may be archived.

     • At Teams Templates, choose a template, if you wish to create the team from a predefined, custom template.

     • At Members, click the Plus icon (+) to add team members (one or more), and define the member's role, either owner or member.

       Note

       At least one user must be assigned the team owner role.

     • At Channels, click the Plus icon (+) to add channels (one or more).

       Note

       The first channel (General), is added by default. All members you add to the team are added to this channel.

       VOSS Automate only supports adding channels with membership type Standard. In the Microsoft Teams online portal, you can add channels that have any of the following membership types: Private, Standard, or Shared

     • At Member Settings, select permissions that will apply to team members. For example, you can define whether to allow team members to add or update channels, to create private channels, to add or remove apps, or to delete channels.

     • At Guest Settings, define whether to allow guest team members to add, update, or delete channels.

     • At Messaging Settings, define permissions for messages, for example, choose whether to allow ordinary members to edit or delete messages, define whether team owners can delete messages, and whether to allow team or channel mentions.

     • At Fun Settings, define whether to allow Giphy, set a content rating for Giphy, and define whether to allow stickers and memes.

Groups

Full HTML Help

Overview

VOSS Automate allows you to view the details of Microsoft Teams Active Directory (AD) groups synced in from the Microsoft Teams cloud portal, so that you can choose these groups for use with Microsoft auto attendants and call queues.

On the Groups page, you can also add, update, and delete groups.

Related Topics

• Auto Attendants
• Call Queues
• Teams

Syncing Teams and Groups on Large Microsoft Tenants in the Best Practice Guide

View and Manage Groups

This procedure displays groups synced in from the Microsoft Teams cloud portal, and allows you to view a group's details, and to add, update, or delete a group.

1. In the VOSS Automate Admin Portal, go to (default menus) Subscriber Management > Groups to open the Groups list view.

2. View existing groups in the list.

   Note

   The number of groups in the list view matches the number of groups in the Microsoft Portal.

3. Do you want to ...

   • View details for an existing group? Click on a group in the list to view its details.

     Note

     • Group members don't display on a group's detail page.
     • Assigned licenses display the friendly name (SkuPartNumber) of the Assigned License in the SKU ID field.
     • The Is Team flag is enabled only when the entity you're viewing is a Microsoft Team.

   • Update a group? Click on a group in the list view to open it's details page. Update the group details, then save.

   • Delete a group? Select the relevant group in the list view, or click on the group to view its details, then click the toolbar Delete icon.

   • Add a group? Click the toolbar Plus (+) icon to create a new record. Then add group details - select the group type (Security or Microsoft 365), fill out a name and description, then save.

Model Details: device/msgraph/Group