Skip to main content

 

Eptura Knowledge Center

Essential Reading for the Microsoft 365 integration

The Eptura Engage Microsoft 365 integration enables users to create and manage bookings through Microsoft Outlook while keeping calendars synchronized with Eptura Engage. Because the integration relies on Microsoft Exchange and Outlook behavior, certain interfaces, configurations, and booking scenarios can affect synchronization and are subject to defined limitations.

To ensure reliable operation, it is important to understand the unsupported Exchange features and incompatibilities with Eptura Engage.

Contents

Best practices


The Eptura Engage Microsoft 365 integration allows Microsoft Exchange rooms and equipment mailboxes to be associated with Eptura Engage meeting space resources so that bookings can be synchronized.

To ensure a successful integration, it is important to consider the best practices, behaviors, and limitations outlined below.

  1. Best practice for initial setup and room mapping
  2. Best practice for general administration
  3. Best practice for users

1. Best practice for initial setup and room mapping

1.1 Manage incompatible bookings/events before mapping rooms

Certain Eptura Engage bookings and Microsoft calendar events are not compatible with the integration and must be removed or rectified before mapping the associated Exchange rooms and Eptura Engage resources. 

Incompatible bookings and events are not synchronized.

Eptura Engage: The following booking types are not compatible with the integration and must be removed:

  • Bookings that have more than 450 instances (calculated by the number of recurrences multiplied by the number of resources)
  • Bookings that include more than 8 resources
  • Bookings created using the 'Specific' recurrence type
  • Linked room bookings

Microsoft Exchange: The following calendar events are not compatible with the integration and must be removed:

  • Events where the user's calendar is not subscribed (except single-day events in a single room, which are compatible regardless of whether the calendar is subscribed or not).
  • Events that have more than 450 instances
  • Events that include more than 8 rooms
  • Recurring events with no end date
  • All-day events are not supported by Eptura Engage
  • Events that are over 3 years in the future
  • Events that are past the advance booking period set for the Group in Eptura Engage
  • Events that are created before the notice period set for the Group in Eptura Engage
  • Events that are outside the business hours set for the Group in Eptura Engage
  • Events where the organizer does not have permission to book a resource from the Group in Eptura Engage
1.2 Allow Eptura Engage to manage conflict resolution for recurring bookings

This applies to Exchange rooms that are linked to Eptura Engage resources, either through Exchange Room Mapping or by adding the Exchange room mailbox directly to the resource's Equipment mailbox field. Learn more: Exchange room calendar integration options

When associating Eptura Engage resources with Exchange rooms or equipment mailboxes, the resolution of conflicts in recurring bookings is best managed automatically by Eptura Engage, which uses its well-established 'Smart healing' technology to manage the conflict. To do so, you must ensure that Microsoft Exchange prevents the Exchange room from accepting conflicts for single-day bookings, and that an entire recurring series is accepted even when there are conflicting instances.

To achieve this, set the following parameters using the Set-CalendarProcessing cmdlet in PowerShell:

AllowConflicts set to False.
This prevents the Exchange room from accepting conflicts for single-day bookings.

ConflictPercentageAllowed set to 100.

MaximumConflictInstances set to 450.

This allows the entire series to be accepted even when there are conflicting instances, while only declining the specific instances that have conflicts.

1.3 Match Exchange booking rules and permissions with Eptura Engage

This applies to Exchange rooms that are linked to Eptura Engage resources, either through Exchange Room Mapping or by adding the Exchange room mailbox directly to the resource's Equipment mailbox field. Learn more: Exchange room calendar integration options

The booking rules and permissions for the Exchange room must align with the booking rules and permissions set for the Eptura Engage resource it will be mapped with.

Set the following parameters using the Set-CalendarProcessing and Set-MailboxCalendarConfiguration cmdlets in PowerShell:

PowerShell command
Parameter
Eptura Engage setting
Set-CalendarProcessing    

BookingWindowInDays

Align with the Advance Booking Period setting.

Application Setup > Groups > [Country] > [Group] > Meeting spaces > Application Setup > Advance Booking Period

AllowConflicts

Set to FALSE

 

AutomateProcessing

Self-managed rooms: Set to AutoAccept

Managed rooms: (Optional) Can be set to AutoUpdate, however those bookings would then need to be approved in both Microsoft Exchange and Eptura Engage. Alternatively, set AutoAccept for Managed rooms and use  AddAdditionalResponse and AdditionalResponse parameters to inform the user via the invitation response, that the status of the request for a room is through the Eptura Engage resource only.

 

ConflictPercentageAllowed

Set to 100

 

MaximumConflictInstances

Set to 450

 

AllowRecurringMeetings

Align with the Maximum recurrence instances setting.

Advanced Setup > Global Setup > Meeting spaces > Maximum recurrence instances

EnforceSchedulingHorizon

Set to TRUE

 

MaximumDurationInMinutes

Align with the Maximum booking duration setting.

Application Setup > Groups > [Country] > [Group] > Meeting spaces > Application Setup > Maximum booking duration

MinimumDurationInMinutes

Set to 0

 

ScheduleOnlyDuringWorkHours

Set to FALSE if Booking hours are set from 00:00 to 23:59; otherwise set to TRUE

See Set-MailboxCalendarConfiguration below to configure the work hours of the calendar.

Application Setup > Groups > [Country] > [Group] > Meeting spaces > Application Setup > Booking hours

Set-MailboxCalendarConfiguration

If business hours are set for the group, use Set-MailboxCalendarConfiguration to set the following parameters in line with that period.

WorkingHoursEndTimeand WorkingHoursStartTime

Align with the Booking hours set for the group.

Application Setup > Groups > [Country] > [Group] > Meeting spaces > Application Setup > Booking hours

WorkingHoursTimeZone

Align with the time zone set for the location.

Application Setup > Locations > [Country] > [Location] > Time Zone

1.4 User accounts

The user's primary email address in Microsoft Exchange must exactly match their email address in Eptura Engage. If two users exist in Eptura Engage with the same email address, the Single Sign-On (SSO) user will be preferred.

For the best experience, all users who have booked meetings in Exchange rooms must be added as active users in Eptura Engage before the rooms and resources are mapped. This helps ensure that the integration can successfully subscribe to users' Exchange calendars, providing a full two-way synchronization between Exchange and Eptura Engage.

1.5 Exchange room mailboxes
  • The Exchange room User Principal Name (UPN) and primary email address must match.
  • An Exchange room mailbox must only be associated with one Eptura Engage resource. This includes if it is mapped to an Eptura Engage resource or just added as an Equipment mailbox in the resource settings. 
  • The name of the Exchange room mailbox and the Eptura Engage resource must be the same or similar, so that users can easily associate the two when booking the room from either Exchange or Engage workflows.
  • The attributes of the Exchange room, for example, location and capacity, must match the Eptura Engage resource, to provide a better experience for users. Learn more at Microsoft: https://learn.microsoft.com/en-us/ex...urce-mailboxes
  • Exchange rooms must be visible in the Global Address List (GAL) for them to appear on the Exchange room mapping page in Eptura Engage. If you want to hide Exchange rooms from the GAL, for example - when you want rooms to be booked using Eptura Engage only, then you can hide them after mapping the room.

Note that currently, Exchange rooms mapped to Eptura Engage resources are no longer visible on the Mapped tab of the Exchange room mapping page when they are hidden from the GAL; however, they are still mapped and will synchronize as usual.

Back to top

    2. Best practice for general administration

    2.1 Unmapping and remapping Exchange rooms to Eptura Engage resources

    Unmapping and remapping Exchange rooms with Eptura Engage resources might cause calendars to become out of sync. Contact Support if you need to unmap and remap an Exchange room with an Eptura Engage resource, even if you are remapping the same room and resource.

    2.2 Do not update the email address of an existing mapped room

    Updating the email address of an Exchange room that is already mapped to an Eptura Engage resource is not supported. Contact Support for further advice if you need to change the email address of a mapped room.

    2.3 Communicate room mapping to users

    If some of your Exchange rooms are not mapped (the Exchange equipment mailbox might be added to the Eptura Engage resource settings, or a room might not be associated with Eptura at all) then we recommend keeping users informed so they understand which rooms can be booked using Eptura Engage apps and which cannot be directly invited from a Microsoft calendar event.

    2.4 Hide Exchange equipment mailboxes added to Resource settings (not mapped)

    Mapping Exchange rooms to Eptura Engage resources is the preferred and recommended configuration for the Eptura Engage Microsoft 365 integration, however, if you have added Exchange equipment mailboxes to the Eptura Engage resource settings instead, then we recommend hiding these rooms from the Global Address List (GAL) to help prevent users from inviting the Exchange room manually.

    2.5 Third-party devices connected to Exchange

    If using third-party room screen devices connected to Microsoft Exchange, to start, check-in, end, and extend bookings, you must ensure that automatic meeting progression is disabled for the meeting space. Meeting progression is set in Group admin. Learn more: Configure a group for meeting spaces

    meeting progression.png

    Back to top

    3. Best practice for users

    3.1 Deleting an invited Exchange room from an event

    When deleting an invited Exchange room from a Microsoft calendar event, users must ensure that the Exchange room mailbox is removed from both the attendees list and the location field in the event.

    3.2 Do not extend or delete bookings in progress

    Bookings that are in progress in Eptura Engage cannot be deleted or have their start time changed; they can only be shortened. Therefore, if an Outlook event is extended or deleted, it might cause the bookings to become out of sync.

    3.3 Do not edit or decline events directly from an Exchange room calendar

    Users (including admins and delegates) must not edit or decline any calendar invites directly from the Exchange room calendar. 

    Back to top

    Exchange room calendar integration options


    Eptura Engage offers two methods for connecting your meeting space resources with Microsoft Exchange calendars. Both options are explained below to help you determine which approach is best for your organization.

    Option 1: Link to the Exchange room/equipment mailbox

    This method creates a one-way link between the Microsoft Exchange mailbox and the Eptura Engage resource.

    Method: The Eptura Engage meeting space resource is configured with the email address of the corresponding Exchange room or equipment mailbox, in the Eptura Engage Resource Admin settings. 

    How It works

    When you link an Exchange room or equipment mailbox to an Eptura Engage meeting space resource:

      • Booking from Eptura Engage with 'Add to Outlook' selected: The event is created on the user's Outlook calendar and the Exchange room/equipment mailbox is invited.
      • Booking from Eptura Engage without selecting 'Add to Outlook': The booking is created in Eptura Engage only - no associated event is created in Exchange.
      • Booking in Exchange room (either invited or directly created): The event is created in Exchange only - Eptura Engage has no visibility of this booking.
      Key benefit 
      • Supports both room mailboxes and equipment mailboxes.
      Key considerations
      • No automatic synchronization.
      • No accurate real-time availability checking against the Exchange calendar.
      • Calendars might show different availability if users book through different channels.
      • Double-bookings are possible if the Exchange mailbox is not hidden from the Global Address List (GAL).
      Best practice

      To prevent double-bookings, we recommend hiding linked Exchange mailboxes from the Global Address List (GAL). This discourages users from booking the Exchange room directly through Microsoft Outlook's room finder tool.

      When to use this option
      • When you want users to manage room bookings primarily through Eptura Engage.
      • When you don't require the Exchange calendar to reflect all Eptura Engage bookings.
      • When using Exchange equipment mailboxes rather than Exchange room mailboxes.
      • If you prefer a lighter integration without full calendar synchronization.

      In summary: Link to the Exchange room/equipment mailbox from Resource admin if you want Eptura Engage to be your primary booking platform and don't need Microsoft Exchange to capture every booking. This is also your only option if you're working with Exchange equipment mailboxes.

      Learn more: Configure meeting space resources

      Option 2: Exchange Room Mapping (full synchronization)

      This method provides true two-way synchronization between the Eptura Engage meeting space and the Exchange room calendar.

      Method: The Exchange room mailbox is mapped with the corresponding Eptura Engage meeting space resource, using the Exchange room mapping module in Eptura Engage.

      How It works

      When you map an Eptura Engage meeting space resource with an Exchange room:

      • Booking from Eptura Engage with 'Add to Outlook' selected: The event is created on the user's Outlook calendar with the Exchange room invited, and both the Eptura Engage and Exchange calendars stay in sync.
      • Booking from Eptura Engage without selecting 'Add to Outlook': Eptura Engage creates an event directly in the Exchange room calendar to maintain synchronization.
      • Booking directly in Exchange (invited from user calendar event): The booking is automatically created in Eptura Engage - no manual intervention required.
      • Booking directly in Exchange (directly created in room calendar): The booking is automatically created in Eptura Engage - no manual intervention required.
      Key benefits
      • Full two-way synchronization between Eptura Engage and Exchange.
      • Real-time availability checking across both systems.
      • Calendars remain consistent regardless of where bookings originate.
      • Exchange room mailboxes do not need to be hidden from the Global Address List (GAL).
      Key consideration
      • Supports Exchange room mailboxes only (not equipment mailboxes).
      When to use this option 
      • To enable a full two-way synchronization between Eptura Engage resources and Exchange room mailboxes.
      • To automatically create Eptura meeting space bookings when associated Exchange rooms are invited to events.
      • When you don't want to hide Exchange rooms from the GAL.

      In summary: Use Exchange room mapping if you need complete visibility of room bookings across both platforms, want to eliminate double-booking risks, and need users to book rooms natively from Microsoft Outlook, Microsoft Teams, or Eptura Engage.

      Learn more: Exchange room mapping

      Compare options 1 and 2

      Compare options 1 and 2 side-by-side

      Feature
      Option 1: Linked via Resource Admin
      Option 2: Mapped via Exchange room mapping
      Synchronization One-way (Eptura Engage to Microsoft Exchange) Two-way
      Availability checking Eptura Engage only Both systems
      Exchange only bookings visible in Eptura Engage No Yes
      Supports equipment mailboxes Yes No
      Calendars always in sync No Yes
      Requires hiding rooms from GAL Recommended Not required