Configuring calendar services
To enable VCA's room calendar to display meeting schedules and support one-tap joining, system administrators need to perform some prerequisite configurations in their calendar service.
Configure Microsoft 365 Calendar Service
Prerequisites
- You need Microsoft 365 Global Administrator or Exchange Administrator permissions.
- Ensure your Microsoft 365 tenant has a verified custom domain for your organization.
- Using the Microsoft Graph API for integration is recommended, as it is Microsoft's modern authentication and API access method, superior to the traditional Exchange Web Services (EWS).
Configuration Steps
Create a Dedicated Service Account in Microsoft 365
We recommend creating a dedicated service account for VCA to access all room resource calendars, rather than using a personal administrator account.
- Log in to the Microsoft 365 admin center ().
- Navigate to Users > Active users > Add a user to create a new dedicated service account (e.g.,
[email protected]). - Assign a valid Microsoft 365 license to this account, which must include the Exchange Online service plan (e.g., Microsoft 365 Business Basic or higher).
- Record the username and password for this account. This account will be used to log in and grant permissions when authorizing through a browser in VCA Host.
Create or Associate Room Resource Mailboxes
Create a dedicated resource mailbox for each room that needs to be integrated with VCA.
- In the Microsoft 365 admin center, navigate to Resources > Rooms & equipment.
- Click "+ Add resource" to create a new room resource mailbox (e.g.,
[email protected]). - Configure the room's properties, such as Name (Boardroom), Capacity, Location, etc.
- For security purposes, password login is typically not required for room resource mailboxes.
After completing the steps above, you can go to the "" settings in VCA Host and use the service account to authorize via browser to integrate Microsoft 365 Calendar.
Configure Google Workspace Calendar Service
Prerequisites
- You need Google Workspace Super Administrator permissions.
- Your organization must have Calendar service configured and in use within Google Workspace.
Configuration Steps
Google Workspace integration is typically achieved by creating a service account and granting it domain-wide access to calendar resources.
Create a Google Cloud Project and Service Account
- Log in to the Google Cloud Console () using your Google Workspace administrator account.
- Create a new Google Cloud project (e.g., "VCA Calendar Integration") or select an existing one.
- In the project, navigate to IAM & Admin > Service Accounts.
- Click "+ CREATE SERVICE ACCOUNT".
- Name the service account (e.g.,
vca-calendar-service); a Service account ID will be generated automatically. - Click "CREATE AND CONTINUE". You can skip granting roles to this service account for now. Click "CONTINUE", then click "DONE".
Enable Domain-Wide Delegation for the Service Account
- In the list of service accounts, click on the one you just created to go to its details page.
- Switch to the "Advanced settings" or "Show domain-wide delegation" section.
- Check the box for "Enable Google Workspace Domain-wide Delegation".
- A Unique ID (Client ID) will be displayed. Copy and save this Client ID, as it is needed in the next step.
- Click "SAVE".
After completing these steps, the VCA system can use the configured service account to access your Google Workspace room calendars. When you select "Google Calendar" in the VCA Host's "" settings, VCA will guide you through the standard OAuth flow using an administrator account with permissions.
Configure Exchange Server (On-Premises) Calendar Service
Prerequisites
- You need Exchange Server administrator permissions.
- Your Exchange Server must be accessible over the network by the VCA Host. This typically requires an Exchange Web Services (EWS) endpoint.
- You need to know your Exchange Server's EWS URL (e.g.,
https://mail.yourcompany.com/EWS/Exchange.asmx). - You need a dedicated service account with its credentials (username and password).
Configuration Steps
Step 1: Create or Designate a Dedicated Service Account
We strongly recommend creating a dedicated Active Directory user account to act as VCA's service account, rather than using a personal administrator account.
- In your Active Directory Users and Computers, create a new user account (e.g.,
vca-service). - Set a strong password for the account and configure it to never expire, according to your security policy.
- Ensure the account has an enabled mailbox in Exchange.
Create or Confirm Room Resource Mailboxes
Create a dedicated room resource mailbox in Exchange for each room to be integrated with VCA.
- Log in to the Exchange Admin Center (EAC).
- Navigate to recipients > resources.
- Click the "+" icon and select "Room mailbox" to create a new room resource (e.g.,
boardroom, with the email address[email protected]). - Configure the room's properties, such as name, alias, capacity, etc.