Microsoft Exchange Integration for Workspace Insights

  • Published on Oct 31, 2025
  • 3 minute(s) read
  • s
  • s
 Prev Next
Note

If your organization uses TMS Exchange Extension (TMSXE) for integration with Exchange, it is likely that the following configuration steps have already been completed. In most cases, WXP Collaboration can utilize the TMSXE user account and distribution list to automatically ingest the room list and calendar data. If you have TMSXE in place, consult with your WXP Collaboration sales engineer before proceeding with the steps in this section.

Prerequisites

  • Customer access to an Exchange Administrator

Technical Requirements

  • Exchange 2013 or 2016

Exchange Config Step 1 - Create a Service Account for Exchange Web Services (EWS)

Integration with Microsoft Exchange requires your Exchange Administrator to set up a service account for EWS, used to query scheduled meeting data.

  • Create an Exchange Service Account with a mailbox enabled for the account (mailbox is required) and document its email address and password.

  • Configure application impersonation on the Exchange Service Account.

  • Make sure the Exchange Service Account is allowed to use EWS by setting the 'EwsEnabled' setting on the mailbox if required.

  • If your organization has configured an 'EwsApplicationAccessPolicy' to 'EnforceAllowList', then please add VyoptaRooms* as an allowed 'user agent string' in Exchange.

Note

You must ensure the asterisk/wildcard is added to the end of the user agent string when adding using the Set-CASMailbox command.

Set-CASMailbox -Identity svcVyoptaAnalytics -EwsApplicationAccessPolicy EnforceAllowList -EwsAllowList "VyoptaRooms*".
Note

If you are running a hybrid environment with Exchange 2013 or above be sure to create the service account in the appropriate environment.

Exchange Config Step 2 - Create a Room Distribution List in Exchange

WXP Collaboration Workspace Insights utilizes an Exchange distribution list to identify which room resources are queried for scheduled meeting data.

  • Create a new room distribution list and document its email address, i.e., VyoptaRoomsDL@company.com

  • Add all rooms applicable for scheduled meeting data collection to the newly created distribution list.

Note

Depending on your environment, you may not be able to set up a new room distribution list for use with WXP Collaboration Workspace Insights. For these environments, you can instead provide a CSV file that maps the individual ExchangeResourceID to a specific room name. You will be responsible for updating and maintaining this file over time if any room changes are made or required.

Exchange Config Step 3 - Add Exchange to the WXP Collaboration Data Collector

To start collecting Exchange data, you will need to add the Exchange Collector to your current data collector by performing the following:

  1. Log in to your WXP Collaboration account (requires Admin privileges).

  2. From the Product Selection menu, select Admin Portal.
    image.png

  3. Go to Infrastructure > New Infrastructure.

  4. In the list of available infrastructure, select Exchange. (Your view may contain a different set of options.)

  5. Select the proper Calendar option and fill in the required fields:

image.png

Add Exchange User Agent String to the Source System (if required)

If your Exchange/O365 environment has configured an 'EwsApplicationAccessPolicy' to 'EnforceAllowList', then you will need to set a configurable parameter by performing the following:

  1. Find the Exchange Infrastructure you just added and select the edit icon.

  2. Expand the box titled Additional Settings.
    image.png

  3. Add the following in the User Agent field where the userAgent string equals the string provided to or by your Exchange Administrator:

van.exchg.userAgent=VyoptaRooms;
  1. Click Save to apply your changes.
  2. In the Admin Portal, go to the infrastructure section and locate your Exchange system.
  3. Toggle the system off and wait for 1 minute, then toggle it back on.

Add Exchange Distribution List

If you configured an Exchange Distribution List as per above, you will need to manually add it by performing the following:

  1. Find the Exchange Infrastructure you just added and select the edit icon.

  2. Expand the box titled Room Distribution Lists.
    image.png

  3. Add the following to the Room Lists field where the address equals the name of the distribution list you configured above:

ExchgRoomsSync.poll.roomListAddress=VyoptaRoomsDL@company.com
  1. Click Save to apply your changes.
  2. In the Admin Portal, go to the infrastructure section and locate your Exchange system.
  3. Toggle the system off and wait for 1 minute, then toggle it back on.
Related articles