Users Appear as Unattached or Unlicensed in the Voice for Teams Admin Portal

Updated: 07/23/2024

Symptom

One or more users listed in the Voice for Teams admin portal display one or both of the following issues:
  1. An orange warning triangle
    clipboard_e296e96d7561fcb6cbd5972cd11b6d0dc.png
     appears at the far right of a listed user's row. When hovering your mouse cursor over the triangle, a popup displays a License Status of Unlicensed.
  2. Instead of displaying the user's name in the User column at the far left, Unattached is displayed.
In both cases, the assigned Teams user will not be able to make or receive phone calls in Microsoft Teams.
clipboard_e8bb73107cacd8f00f8416b3cb1b1ac5b.png
In the Voice for Teams admin portal:
  • The User column is a listing of Microsoft Teams users imported from Teams during the sync process.
  • The SIP User column is the listing of users who have been assigned an activated Microsoft Teams license in the 8x8 Admin Console.
  • If a Teams user's name appears in the User column, then the listed user has been identified by the Voice for Teams service as having been assigned the correct Microsoft Teams licenses.

Applies To

  • 8x8 Voice for Microsoft Teams
  • Microsoft Teams

Cause

Unlicensed / PBX user licenses

When a Teams user's name appears in both the User and SIP User columns on the Users tab of the admin portal, and the License Status is Unlicensed, then it's likely that there are no Voice for Teams PBX user licenses available in the admin portal.
clipboard_eba7aa6cb4ba429118b2f82449790e18a.png

Unattached User

When the User column displays Unattached instead of the Teams user's name, but their name appears in the SIP User column, this indicates a problem with the Microsoft Teams user licensing.
  • Typically this means that the user has been assigned a Calling Plan license, or a Calling Plan license and a Phone System license, or that no Phone System license has been assigned.
  • Also note that standalone Teams phones (such as conference phones) are not supported by Voice for Teams, unless they are assigned proper Teams user licenses. In this case, they will also appear as Unattached.
clipboard_e31e011b60c9600e2b300ad257a585152.png
Three critical types of licenses are required per user for User sync to succeed between Microsoft Teams and 8x8:
  • A Microsoft Teams Phone System license per user (included with Microsoft E5 licensing)
  • An 8x8 MS Teams license enabled per user in 8x8 Admin Console user profiles
  • A PBX user license per user in the Users section of the 8x8 Voice for Teams admin portal

Resolution

Unlicensed / PBX User Licenses

  1. Compare the total number of licenses assigned in the Voice for Teams admin portal with the 8x8 Admin Console. The total maximum number of licenses in both locations should be the same. See the example below.
  2. If the maximum number of PBX user licenses in Voice for Teams admin portal > Users is less than the total number of Microsoft Teams licenses listed in the 8x8 Admin Console > Licenses, create case with 8x8 Support to have the issue corrected.
  3. Once this licensing issue is corrected, simply click Sync Now to run a full User sync in the Voice for Teams admin portal to correct this problem.
clipboard_e5c1107fdad663d32945cff002ec7fbcc.png
Example:
  • The 8x8 Admin Console displays a maximum of fifteen purchased Voice for Microsoft Teams user licenses.

    clipboard_e6b1d47cbd1bb205ad9fb3759292bcd4a.png
  • Voice for Teams admin portal displays a maximum of only ten PBX user licenses.

    clipboard_e9b65a26e489015889cdd25af6825fd25.png

Unattached User

When the User column displays Unattached instead of the Teams user's name, but their name appears in the SIP User column, this most often indicates a problem with the Microsoft Teams user licensing.
clipboard_e2fee5af6c5540f830c87706c972faac2.png
Standalone Teams phones (such as conference phones) are not supported by 8x8 Voice for Microsoft Teams, unless they are assigned proper Teams user licenses.
  1. Click the drop-down arrow next to Unattached to expand the specific Teams user's settings.
  2. In the Teams section, click the Select a User dropdown arrow.
    • If the user's name appears in the list, click to select them, then click Save.
    • If the user's name does not appear in the list, verify and correct any of the following in Teams user administration:
      • The Teams user's account must be active.
      • The Teams user cannot have a Calling Plan assigned to them.
      • The Teams user must have a Phone System license assigned to them.
  3. Click Sync Now in the Voice for Teams admin portal to run a full user sync. This should resolve the Unattached issue.

    clipboard_e68865140c1c7ba448e60727bdb4b7dc6.png