8x8 Presence Sync with Microsoft Teams

Updated: 07/31/2024

Overview

Presence is part of a user's profile, and indicates their current availability and status to other users. By default, anyone in your organization using a specific application can see if other users are available online.
The 8x8 Presence Sync enables the integration of Microsoft Teams Presence into your 8x8 applications, as well as the presence status of 8x8 users who are on active calls into the Teams environment. You can now see if specific users or stakeholders in your organization are available online or engaged in another call or conference. Presence is updated in real time on the mobile, desktop and web application versions.
The 8x8 Presence Sync aggregation service polls your service directories for Presence changes every 10 seconds and then publishes the collected aggregated updates to the stream.
Important Notes:
  • The fully-installed Presence Sync integration is a two-way process from Microsoft to your 8x8 applications, and 8x8 applications to Microsoft Teams.
  • Teams users who are assigned to 8x8 Call Queues and/or Ring Groups must set their status to Do not disturb (DND) in Microsoft Teams when they are not available to take calls, to insure that such calls are not routed to them. This is the only scenario in which call distribution may be affected by the Presence Sync app.
  • In order to sync and integrate Presence between Microsoft Teams and your 8x8 apps, you must have an 8x8 Unified Communications (UC) user (the user can be licensed or unlicensed within 8x8) with the email matching that of Microsoft user whose Presence is synced. (Your 8x8 email address must match your Microsoft username.)
  • Presence status from Teams to 8x8 will work with Unified Communications (UC) users whether or not those Teams users have been assigned an 8x8 X Series license in 8x8 Admin Console. Presence will be polled and displayed to users in the 8x8 directories within Work, Contact Center Agent Workspace, and Frontdesk.
  • The presence status of 8x8 application users shown in Microsoft Teams will only be displayed as either offline or On a Call. This is due to Microsoft API limitations.
  • There is no dependency on or requirement for 8x8 Voice for Microsoft Teams to be used/in place.

Example Usage

Use of Presence with 8x8 Voice for Microsoft Teams is optional. However, it's recommended in the following usage scenarios:
  • Hybrid environments: Some users are using Microsoft Teams, and others use 8x8 Work.
  • 8x8 Contact Center: Microsoft Teams Presence as part of Expert Connect.
  • 8x8 Work for Desktop: Frontdesk, or Work Operator implementations.
  • Without Voice for Teams offering:
    • Each user is running both Microsoft Teams (for collaboration and conferencing) and 8x8 Work for Desktop.
    • A mixed environment exists with Microsoft Teams users (non-8x8) and 8x8 Contact Center users. Contact Center users will see presence status of Teams users.
Notes: As stated above, Teams user presence can appear in 8x8 Work applications even if they are not configured as 8x8 Voice for Teams users. In this scenario, the following applies:
  • Teams users must also have an 8x8 user profile created in 8x8 Admin Console, with the same user name applied in both 8x8 and in the Microsoft service. The Teams user does not require an assigned 8x8 X Series license for their presence status to appear in 8x8 Work apps.
  • The presence status of new Microsoft Teams users can take up to 24 hours to appear correctly in 8x8 applications, even when they are correctly configured on both sides. This is an effect of 8x8's back end contact directory sync process.

Prerequisites

In order to use the Presence integration with Microsoft Teams, you must have administrator level access for the following:
  • Microsoft Azure Active Directory (AD) with Microsoft Office 365 Global admin access
  • 8x8 Admin Console
Note: A Microsoft user license or a Phone System license is not required for the Presence sync. An 8x8 X Series license is also not required, as stated above.

Procedure

Follow the installation process shown below, in this order:
  1. Install the Teams to 8x8 Presence Sync (one-way sync)
  2. Install the 8x8 to Teams Presence Sync (two-way sync)
NOTE: If you already have the 8x8 Presence Sync integration installed, skip the first step and proceed directly to Install the 8x8 to Teams Presence Sync.

Install the Teams to 8x8 Presence Sync

  1. Create Sync User
  2. Install the Presence Sync Integration

Create Sync User

To enable 8x8 Presence Sync integration, you must first create a separate Sync user account in Microsoft Azure Active Directory. The Sync user you create is strictly associated with the Presence Sync process to facilitate Presence integration into your 8x8 apps.
  1. Log in to the Microsoft Azure AD admin center.
  2. Create a new user to sync and integrate Microsoft Teams Presence into your 8x8 apps:
    1. Select Users from the left menu.
    2. Click + New User.
clipboard_e3d70e8bafedd69843b5cf3421de4b6bd.png
  1. Select Create user, complete the information in the blank Identity and Password fields.
    • 8x8 recommends using 8x8.status@<customer-domain> as the user name for ease of identification.
    • In the Password field, you can either auto-generate or create your own user password.
    • The remaining New User field details (such as Settings, Job info, etc) are not required.
  2. Click Create.
  3. Make a note of the username and password that you have created. You'll need them in the next section.
clipboard_e862075cf5bcf783df07faa302245124d.png
 

Install the Presence Sync Integration

Complete the following procedure to install the 8x8 Presence Sync integration with Microsoft Teams:
  1. Using your 8x8 Admin Console credentials, log in to the 8x8 Teams Presence Integration page at:
clipboard_ee06e6d3842d0d0d797e199f220bc092e.png
  1. Click Login on the 8x8 Teams Presence Integration page.
clipboard_e30fa845b621af474b281d95e407b0b0d.png
  1. At the Microsoft Pick an account login prompt, log in using the new 8x8 Status Microsoft user credentials that you just created in the steps above.
    • Do not log in at this point using your Microsoft administrator account.
clipboard_e638fafc961db27874ebab8fd61476faf.png
  
clipboard_edd863c0aba3ec2344d6d2b359f6c990c.png
Note: If Microsoft prompts you to update your new 8x8 Status user's password, simply make the requested change and continue with the login process.
clipboard_e06fe6bf892a6c05ea38b0c2386df623f.png
  1. When the Permissions requested prompt appears, click Accept to confirm access permissions to the specified areas of your Sync profile.
clipboard_e4f8f452f7f2ccd667100b579cd949fdc.png
The Logged in Account page displays the options to Verify or Disable the Presence integration.
  1. Click Verify Presence integration.
clipboard_ea7324aea36f0c7520a919079bb9837d0.png
  • Initially Presence is not yet synced, so you will see the following message displayed in the information field:
  • Admin Consent Needed
    In Azure Active Directory admin center, go to Enterprise applications > 8x8 Presence > Permissions and click on Grant admin consent to <Company domain>. button.
clipboard_e9e7347c53a0a65470335148f31e5e055.png
  1. Return to your logged-in Microsoft Azure Portal in order to grant access permissions to the Sync user you have created.
    • Be sure to select your Microsoft Azure administrator credentials, not the 8x8 Status user.
clipboard_ed13a1c3af1206f6579112d8a9489db8e.png
  1. In the Microsoft Azure admin center, navigate to Enterprise applications > 8x8 Presence > Permissions.
  2. Click Grant admin consent for <Company domain> to grant admin access to the Sync user.
clipboard_e24cbca1bcc7fa0c9495ef7d42e69c959.png
  1. When you are again prompted to log in, select your Microsoft Azure Administrator login credentials.
    • Do not log in using the 8x8 Status user you created earlier. The purpose of this step is for an administrator to authenticate the 8x8 Presence application for use on the service.
clipboard_ebaa5689607cd07e2117bb941627be06a.png
  1. In the Permissions Requested popup window, click Accept to confirm access permissions to the specified areas of your Sync profile.
    • Note: You must accept the permission request for the Presence Sync integration to work.
 
clipboard_eac3cd897fd469e18f9b29e2a6b179ea7.png
  1. Now return to the Logged in Account window as shown in the next step, below.
    • If you've closed the Logged in Account window and need to log in again, follow the login process outlined in steps 1, 2, and 3 of this section, above. Then return here to follow the final steps, below.
  2. Now click the Permission granted. Try again button below the Admin Consent Needed banner.
clipboard_e9e7347c53a0a65470335148f31e5e055.png
  • If you are prompted to log in again, select the 8x8 Status user ID (not your Microsoft Azure administrator ID).
clipboard_e0176ca9aae305fbe0787dc02754adbac.png
  1. Click Verify Presence integration.
The Logged in Account page should now display Integration verified, and the process is now complete.
clipboard_e7ee27afd22e04559c43c132e42be40ce.png
Note: If required, you can disable the 8x8 Presence integration by clicking Disable 8x8 Presence integration.

Install the 8x8 to Teams Presence Sync

Once you've installed the Teams to 8x8 Presence Sync using the process above, proceed with the instructions below to install the 8x8 to Teams Presence Sync.
  1. Using your 8x8 Admin Console credentials, log in to the 8x8 Teams Presence Integration page at:
clipboard_ee06e6d3842d0d0d797e199f220bc092e.png
  1. Click Login on the 8x8 Teams Presence Integration page.
clipboard_e30fa845b621af474b281d95e407b0b0d.png
  1. At the Microsoft Pick an account login prompt, log in using the new 8x8 Status Microsoft user credentials that you just created in the steps above.
    • Do not log in at this point using your Microsoft administrator account.
clipboard_e638fafc961db27874ebab8fd61476faf.png
  
clipboard_edd863c0aba3ec2344d6d2b359f6c990c.png
  1. Click Export 8x8 Presence state to Teams.
  1. When you are again prompted to log in, select or enter your Microsoft Azure Administrator login credentials.
    • Do not log in using the 8x8 Status user you created earlier. The purpose of this step is for an administrator to authenticate a new 8x8 Write Presence application for use on the service.
clipboard_ebaa5689607cd07e2117bb941627be06a.png
  1. In the Permissions Requested popup window, click Accept to confirm access permissions to the specified areas of your Sync profile.
    • Note: You must accept the permission request for the 8x8 Write Presence app integration to work.
clipboard_e3cfa39e1259c2dae37de962e6430d9fb.png
  1. Once the above steps are completed, you'll be returned to the Presence Integration's Logged in Account page as confirmation of install completion.
  2. Click Verify Presence integration.
The Logged in Account page should now display Integration verified, and the process is now complete. You can now test the two way sync to confirm that it is active and working properly.
Important: The presence status of 8x8 application users shown in Microsoft Teams will only be displayed as either offline or On a Call. This is due to Microsoft API limitations.

Install the Enhanced Presence Sync

Once you've installed the Teams to 8x8 Presence Sync and the 8x8 to Teams Presence Sync, using the process above, proceed with the instructions below to install the Teams Enhanced Presence Sync.
  1. Using your 8x8 Admin Console credentials, log in to the 8x8 Teams Presence Integration page at:
    • https://cloud8.8x8.com/vos-teams
      clipboard_ee06e6d3842d0d0d797e199f220bc092e.png
  2. Click Login on the 8x8 Teams Presence Integration page.
    clipboard_e30fa845b621af474b281d95e407b0b0d.png
  3. At the Microsoft Pick an account login prompt, log in using the new 8x8 Status Microsoft user credentials that you just created in the steps above.
    • Do not log in at this point using your Microsoft administrator account.
      clipboard_e638fafc961db27874ebab8fd61476faf.png

      clipboard_edd863c0aba3ec2344d6d2b359f6c990c.png
  4. Click Import MS Teams Contacts into 8x8.
    Teams1KB.png

Install the Teams Chat Integration

Once you've installed the Teams Enhanced Presence Sync using the process above, proceed with the instructions below to install the Teams Chat Integration.
  1. Using your 8x8 Admin Console credentials, log in to the 8x8 Teams Presence Integration page at:
    • https://cloud8.8x8.com/vos-teams
      clipboard_ee06e6d3842d0d0d797e199f220bc092e.png
  2. Click Login on the 8x8 Teams Presence Integration page.
    clipboard_e30fa845b621af474b281d95e407b0b0d.png
  3. At the Microsoft Pick an account login prompt, log in using the new 8x8 Status Microsoft user credentials that you just created in the steps above.
    • Do not log in at this point using your Microsoft administrator account.
      clipboard_e638fafc961db27874ebab8fd61476faf.png

      clipboard_edd863c0aba3ec2344d6d2b359f6c990c.png
  4. Click Enable Chat.
    Teams3KB.png
  5. When you are again prompted to log in, select or enter your Microsoft Azure Administrator login credentials.
    • Do not log in using the 8x8 Status user you created earlier. The purpose of this step is for an administrator to authenticate a new 8x8 Teams chat application for use on the service.
      clipboard_ebaa5689607cd07e2117bb941627be06a.png
  6. In the Permissions Requested popup window, click Accept to confirm access permissions to the specified areas of your Sync profile.
    • Note: You must accept the permission request for the 8x8 Teams chat app integration to work.
      Presence Chat1.png
  7. Once the above steps are completed, you'll be returned to the Presence Integration's Logged in Account page as confirmation of install completion.

Presence Status Mapping

Presence Status Mapping from Microsoft Teams

The following table describes the Presence mapping from Microsoft Teams.
Microsoft Teams Status 8x8 Presence
Available.png
  Available
Available.png
  Available
Available-OOO.png
  Available, Out of Office
Available-OOO.png
  Available
Note: The Out of Office notification displays when automatic replies are configured. If the app is in use during a set Out of Office period, a dual presence may be shown (Out of Office, Available).  
Busy.png
  Busy
Busy.png
  Busy
Busy.png
  On a call
Busy.png
  onCall
Busy.png
  In a meeting
Busy.png
  onCall
OnCall-OOO.png
  On a call, out of office
OnCall-OOO.png
  onCall
DND.png
  Do not disturb
DND.png
  doNotDisturb
DND.png
  Presenting
DND.png
  doNotDisturb
DND.png
  Focusing. Focus happens when the users schedule focus time in MyAnalytics/Insights in their calendars.
DND.png
  doNotDisturb
Away.png
  Away
Away.png
  away
Away.png
  Be right back
Away.png
  away
Offline.png
  Offline. When users aren't logged in on any of their devices for a few minutes, they appear offline.
Offline.png
  offline
StatusUnknown.png
  Status unknown
StatusUnknown.png
  offline
OOO.png
  Out of Office. Out of Office is used when an automatic reply is set. (Available in Outlook only.)
OOO.png
  offline

Presence Status Mapping from 8x8

The following table describes the Presence mapping from 8x8 apps to Microsoft Teams.
8x8 Presence
Microsoft Teams Status
Available.png
  Available
No sync
Busy.png
  Busy
No sync
Busy.png
  onCall
Busy.png
  On a call
DND.png
  doNotDisturb
No sync
Away.png
  away
No sync
Offline.png
  offline 
No sync