How to enable calendar integration on your ClickShare device via XMS Cloud

Article number: [1967] - Legacy code: [12253]

Applicable to

The calendar capability allows you (as a ClickShare admin or IT admin) to display your room calendar on the monitor connected to ClickShare devices.

Prerequisites:

To enable calendar integration, the XMS Cloud must be connected to your Microsoft Azure Account. This connection allows the discovery of rooms and sharing of their credentials with CX devices. Approvals from your Organization’s Office365 admins are required. 

Known limitations:
  • The new rooms added in Office365 may take up to 24 hours to be visible in XMS even if you do a manual rediscover.
  • Both XMS tenant and Office365 tenant need to be unique and cannot be linked to another one.

How to set up this capability (ClickShare/IT admin only)?

    Note: For further details, you can consult to the relevant topics in the XMS Cloud User Guide (how-to, see KB 9362). For detailed security recommendations on the deployment of the calendar integration, see XMS Cloud Security Whitepaper (how-to, see KB 9362).

    Note: Depending on the functionality (e.g. notification feature) enabled on your XMS Cloud, some images and information in the procedure below may vary slightly.

    1. In the XMS Cloud, go to the Microsoft Calendar page and click Connect Azure Account.

      kb1967_cal_int_01.png

      You will be redirected to Microsoft Azure account.

      kb1967_cal_int_02.png 

    2. Post Redirection and logging in, you will see the approval screen for 'Clickshare Meeting Room Discovery'. Read the message and click Accept.

       

    3. After acceptance, you will be redirected back to XMS Cloud. This process should finish in 10-30 minutes but sometimes it may take longer.

      Click Check Status to check the Connection status between XMS Calendar application and Azure Calendar account.

      kb1967_cal_int_04.png

      Click Revoke Integration to terminate the Calendar Integration process. The following message dialog appears to proceed cancellation process.

      kb1967_cal_int_05.png

      Following notification message can be seen upon the partial completion/integration of the calendar integration process. This message will only appear if on your XMS Cloud you have enabled the notification feature and subscribe to Cloud Category services.

      kb1967_cal_int_19.png

    4. After the connection is established, the Continue Integration button will be shown. Using this button, the user will be redirected to an Azure account where the Azure Office365 account admin must have to give Barco permission to discover the Azure Calendar meeting rooms.

      kb1967_cal_int_06.png

      Post Redirection and logging in, you will see the approval screen. Read the message and click Accept.

       

    5. Your connection with Microsoft Calendar is now active. Click the Manage Calendar button to link Base Unit to your calendar meeting room. You will be redirected to the Microsoft Calendar page where you can manage your rooms with Base Units.

      kb1967_cal_int_08.png

      Following notification message can be seen that the calendar integration process is successful. This message will only appear if on your XMS Cloud you have enabled the notification feature and subscribe to Cloud Category services.

      kb1967_cal_int_07.png 

    6. Link Base Unit to your calendar meeting room:

      1. Click the + Link Baseunit button next to the Calendar meeting room name where you want to link the Base Unit.

        kb1967_cal_int_09.png 

      2. Select your Base Unit from the list and click Link Now.

        kb1967_cal_int_10.png 

      3. Base Unit has been linked, and your calendar is set up now.

        kb1967_cal_int_11.png

    Click REMOVE FROM XMS to delete (or disconnect) your calendar integration with Office365.

    kb1967_cal_int_12.png

    Normally, the user does not need to do anything for expiring credentials, as XMS auto-renews them. For this XMS runs a periodic check every midnight for the ClickShare Calendar Sync application credentials, if expiring within the next 7 days. The renew credentials will be valid for next six months if renewed.
    If the user desires to renew their credentials at the moment, they can click Renew credentials.

    kb1967_cal_int_13.png

    Click Rediscover Rooms to sync with Microsoft AD account room emails and sync those rooms with XMS Calendar.

    kb1967_cal_int_14.png


    Troubleshooting

    • Revoked service principle

      If you have accidentally revoked the Barco-multi-tenant Calendar AD app’s service principle through the Azure portal, a warning sign will be visible on the Rediscover Rooms button and on the Microsoft Calendar page.

      kb1967_cal_int_15.png

      Follow the onscreen instructions to resolve the issue, this will help you to reintegrate the whole calendar again and allow you to start the calendar integration.

      kb1967_cal_int_16.png

    • Disabled User Sign-In

      If you have accidentally disabled user sign-in in the Barco-multi-tenant Calendar AD app’s service principle through the Azure portal, a warning sign will be visible on the Rediscover Rooms button and on the Microsoft Calendar page.

      kb1967_cal_int_17.png

      Follow the onscreen instructions to resolve the issue.

      kb1967_cal_int_18.png

    • Hidden Meeting Rooms

      Meeting rooms hidden in the Microsoft Exchange Admin Center (EAC) are not visible in the XMS Cloud Calendar. To resolve, disable the Hide from global address lists (GAL) option in EAC (how-to, see KB15437).

    Properties

    Last updated Jun 26, 2025