Skip to content

Connect Microsoft 365 account with Yeastar Workplace

This topic describes how to connect your Microsoft 365 account with Yeastar Workplace as the first step of integration.

Prerequisites

The Microsoft 365 account to be connected must meet the following requirements:

  • Admin role: Global Administrator
  • Microsoft 365 license: Business or Enterprise

    Note

    • To check and assign admin roles on Microsoft 365, see this topic.
    • To assign Microsoft 365 licenses to users, see this topic.
    Why is a Global Administrator account required?

    To sync room calendars, a domain-level Azure AD App will be installed to your Microsoft 365 account, which requires the authorization of a Global Administrator account. If you'd like to understand more about why a Global Administrator is needed, and how to keep your Microsoft 365 account secure, see this topic.

Procedure

  1. Log in to Yeastar Workplace management portal.
  2. Go to Integration, click Connect beside the Microsoft icon.
    In the pop-up window, log in with a global administrator account.
  3. Yeastar Workplace will ask for permissions to access calendar information in order to sync events. Click Accept to complete the connection.

Trouble shooting

If the following page is displayed after clicking Accept, it indicates that your Microsoft 365 account doesn't meet the requirements for integration.


Now your Microsoft 365 account is connected with Yeastar Workplace.
On this page, you can view the permissions that Yeastar Workplace obtained from Microsoft 365.

Why does it ask for full access to all mailboxes?

Yeastar Workplace uses an authentication method called OAuth to securely install the app onto your Microsoft 365 account. OAuth is a way for apps to request very specific rights for your account. For Microsoft 365/EWS, Microsoft requires that all OAuth apps request mailbox permission for EWS API's. Once installed, Yeastar Workplace only interacts with your calendars.

What to do next

Once your Microsoft 365 account is connected with Yeastar Workplace, you can add rooms from Microsoft 365 and allocate devices.


Last update: September 21, 2022
Created: December 16, 2021

Author: Cody