The MazeMap Resource Booking feature enables convenient space bookings in a hybrid work environment. This feature is customisable for booking various spaces such as rooms, workspaces and desks.
Customers have the option to import resource details from supported external calendars, such as Google or Office 365, or use MazeMap's built-in hybrid desks solution service. This service is particularly useful for adding desks that are not available in a standard calendar provider.
Setup
1) Sign Up and Consent
Before you can start using Office365 and MazeMap, you will need to sign up and provide consent for the collection and use of your data. This is necessary to ensure that we are able to provide you with the best possible service and to comply with relevant data protection regulations.
To sign up and provide your consent, please follow these steps:
Click the following link to sign up for Resource Booking with MazeMap: https://login.microsoftonline.com/common/adminconsent?client_id=edf3fbfc-b7f9-4c31-88f5-a7400bf5463f&redirect_uri=https%3A%2F%2Fuse.mazemap.com%2Foauthsuccess.html.
Review the terms of service and privacy statement for both Office365 and MazeMap, and provide your consent by clicking the Accept button.
Create a request with MazeMap Support with your Tenant ID.
MazeMap Support will be in contact.
For customers predating March 2024, see section Deprecated setup - Sign Up and Consent.
2) Booking options
Rooms needs to auto accept meeting requests.
3) What Data Access
Full access to user calendars - allowing MazeMap to create, read, update and delete events in user calendars. This is necessary to book a room with a user that is logged in.
Reading user’s basic profile (name, picture and username): This is used to provide a more personalized user experience. This information is only accessed for a signed-in user.
In more detail:
MazeMap retrieves free/busy availability information for a specified time period using https://docs.microsoft.com/en-us/graph/api/calendar-getschedule?view=graph-rest-1.0
Users’ calendar events for a specified time period are retrieved using https://docs.microsoft.com/en-us/graph/api/user-list-calendarview?view=graph-rest-1.0
Calendar events are created in the users’ calendars using https://docs.microsoft.com/en-us/graph/api/user-post-events?view=graph-rest-1.0
Here is a full list over all the Office365 API Calls*:
Getting availability (overview in map for specific point in time) + schedule for a single room for some time in the future (we use the timestamps, not the other information in the schedule items)
→ GET https://graph.microsoft.com/v1.0/users/{external_id}/calendar/getschedule
Booking a room anonymously (e.g. through kiosk)
→ POST https://graph.microsoft.com/v1.0/users/{external_id}/events
Booking a room with a user
→ POST https://graph.microsoft.com/v1.0/me/events
Cancel a reservation
→ DELETE https://graph.microsoft.com/v1.0/me/events
Get user reservations
→ GET https://graph.microsoft.com/v1.0/me/calendar/calendarView
Getting a token for MazeMap to authenticate with the external API for making future calls. Used in all flows.
→ POSThttps://login.microsoftonline.com/%7Bdomain%7D/oauth2/v2.0/token
User login. This endpoint is directly accessed from the client and starts an Oauth flow. The access token retrieved from this is used in following calls to MazeMap and MazeMap use the token on behalf of the user to authenticate when creating reservations.
→ GEThttps://login.microsoftonline.com/common/oauth2/v2.0/authorize
All access to these APIs are done using HTTPS.
The login flow is client side only. It does not go through MazeMap servers. The user gets prompted for a login flow from Office365 which returns an access token. This access token is stored locally in the browser (for 60 minutes) and used in calls to MazeMap when booking a room. The access token is forwarded directly to the Office365 APIs for booking a room (impersonation).
During this whole process, the only thing MazeMap stores is whether the room was booked successfully or if any errors occurred. End users only see if a room is available or not and for what time it is available, not what the room is booked for and not the meetings’ participants.
*This list includes the API Calls which are currently in use in the application. They do not need updates when we change some of the calls later, because the purpose will be the same and the rights we request from both the customer and each user are the same. In the future some things may change though because:
Microsoft makes changes
We want to optimise the flow (faster alternative API calls doing the same action)
New requirements/ new features
Auto unbooking with occupancy sensors
The optional auto unbooking feature allows resources to automatically be un-booked if sensors show that the resource is unused. This frees up the resource for other users. For example, cancelling a booking for a meeting room if a sensor in the room shown no one is present. This allows another user to book the room.
To be able to do cancellation without a signed-in user, write permission to all calendars is required.
To sign up and provide your consent, please follow these steps:
Click the following link to sign up for auto un-booking with MazeMap: https://login.microsoftonline.com/common/adminconsent?client_id=5de804c1-0453-4ffa-9000-df9f5623e222&redirect_uri=https%3A%2F%2Fuse.mazemap.com%2Foauthsuccess.html
Review the terms of service and privacy statement for both Office365 and MazeMap, and provide your consent by clicking the Accept button.
Deprecated setup - Sign Up and Consent
Before March 2024, these were the steps to sign up and consent.
To sign up and provide your consent, please follow these steps:
Click the following link https://login.microsoftonline.com/common/adminconsent?client_id=7282620c-73d8-46d2-8dc6-7e2602fd1003&redirect_uri=https%3A%2F%2Fadmin.mazemap.com%2Fbooking%2Foffice365%2Findex.html to sign up for Resource Booking with MazeMap.
Review the terms of service and privacy statement for both Office365 and MazeMap, and provide your consent for the by clicking the accept button
Create a request with MazeMap Support with your Tenant ID
MazeMap support will be in contact