How it works

The Microsoft Exchange Server integration uses Exchange Web Service (EWS) to view, create, and edit your organizations’ calendars according to users’ actions. The integration uses an Exchange account and it is authenticated to the EWS API with Basic Authentication. You can find more information about the EWS here.

Technically all bookings made from EG Worksense are created by the room’s Exchange account which is being booked. The room is the organizer and invites the user and possible other participants to the calendar booking.

Setup Exchange Server integration

Exchange Server 2013 and compatible versions are supported.

Exchange Server

For the integration you need to:

  1. Create a Service Account on your Exchange service

  2. Enable EWS for the Service Account

    PowerShell command:
    Set-CASMailbox -Identity [username] -EwsEnabled:$true

  3. Give an Author role for the Service Account to the resources' Calendars (meeting room calendars you want to book from EG Worksense) 

    Powershell command for adding Author role for a single account’s Calendar  folder:
    Add-MailboxFolderPermission -identity [mailbox-name]:\Calendar -User [username] -AccessRights Author

  4. Give an Author role for the Service Account to the resources' Deleted items folders

    Powershell command for adding Author role for a single account’s Deleted items folder:
    Add-MailboxFolderPermission -identity [mailbox-name]:\"Deleted items" -User [username] -AccessRights Author

  5. Disable multi factor authentication (MFA) for the Service Account

  6. Allow 3rd party applications from external networks to use EWS

EG Worksense

Once you have configured your Exchange Server, you can enable the integration in EG Worksense.

You must have an Administrator role in EG Worksense in order to enable Exchange integration.
  1. Log in to EG Worksense

  2. Click Administration

  3. Select Exchange Server On-Premises

  4. Click the toggle button next to Enable Exchange integration

  5. Enter your Exchange Server’s EWS URL

  6. Enter the Service Account’s username or UPN

  7. Enter the Service Account’s password

  8. Click Save