Microsoft Calendar Integration (up to Summer 2025)
If you are leveraging an Imagicle UCX on-prem or Cloud Suite version Winter 2026 or above, please ignore this KB article and go to the new Calendar Integration KB.
Imagicle UCX Console can display real-time Microsoft Calendar information into its "Colleagues" tab, including scheduled appointments for the current day. Calendar information can be retrieved from an on-prem Microsoft Exchange server, version 2007 SP1 and above, or from cloud-based Microsoft 365 service.
The connection to both an on-prem or cloud-based Microsoft email services leverage Office 365 "OAuth2" modern and secure authentication method (now both deprecated), supported starting from 2021.Spring.1 Imagicle release.
UCX Suite configurations
Imagicle UCX Suite can be interfaced either to an on-prem MS-Exchange server or to MS-Office 365. Configurations are provided for both email systems.
Please access to Imagicle web portal as administrator and go to UCX Console ⇒ Application Settings ⇒ Calendar Integration Settings.
Microsoft Exchange
Please populate the following fields:
Provider: Exchange
Version: From Exchange 2007 SP1 up to 2013 SP1 or newer
EWS URL: Customer's EWS access URL (see below sample)
Data refresh interval: Interval in seconds between each calendar refresh. Do not set this parameter below 60 seconds, to avoid being banned by Microsoft.
Office 365
Please populate the following fields:
Provider: Microsoft Office 365
Enable Basic Authentication: This flag enables basic EWS authentication, just using username and password. Imagicle UCX Console does not support this authentication type anymore, since 2023.Winter.1 release.
Enable Modern Authentication: This flag enabled EWS-based OAuth2 authentication (deprecated), where two parameters are required to access calendars:
Application (client) ID: This is the client ID retrieved from Azure App Registration
Directory (tenant) ID: This is the tenant ID retrieved from Azure App Registration
Data refresh interval: Interval in seconds between each calendar refresh. Do not set this parameter below 60 seconds, to avoid being banned by Microsoft.
You can keep both authentications enabled. In this case, a warning is displayed once configuration is saved.
To enable this feature on UCX Console client, please refer to our user's guides, available to download from here.
Troubleshooting
It might happen that the Microsoft account configured in Imagicle UCX Console to retrieve presence returns an error, due to the following possible reasons:
The Microsoft account has a policy which does not allows too frequent calendar refreshes.
Someone has changed the account password, so entered credentials are invalid.
Someone changes account credentials while Attendant Console is running.
In all above cases, the Microsoft account is locked within few seconds and you get the following error message on UCX Console:
More info about this problem are available in UCX Console logs, stored inside operator's PC workstation. This is the file to consult:
C:\Users\<user name>\Documents\Imagicle Blue's Attendant\Logs\ApplicationLogFile.txt