Overview

Maptician supports multiple data sources for generating Presence status. Depending on your environment and infrastructure, you can use one or more of the sources below. Each source has different setup requirements, data points, and limitations. 

Microsoft Azure Active Directory Log-Based Presence Tracking

Maptician can integrate with the Microsoft Graph API to access Azure Active Directory and Office 365 activity logs. These logs provide information on user sign-ins and authentication with Microsoft applications and services. Once configured, Maptician retrieves Microsoft Interactive Sign-in Logs every 5 minutes, enabling real-time presence data. 

For more information, refer to: Microsoft IP-Based Presence Overview . 

Key Details

• Sign-in data from Office 365 web applications (OWA, SharePoint, Teams, Word, etc.), Windows login, and interactive SSO sessions are used for Presence.
• Data points used: IP address, date, and user principal name.

Limitations

• If a user does not use a device that connects to a Microsoft service while at the office, they will not appear as present.
• If a user's computer or device is powered on and left in the office (not in sleep or hibernate mode), it may authenticate with Microsoft in the background and create a false positive, showing the user as present when they are not.
• If a user accesses an office computer remotely via a remote desktop connection, VPN, or similar tool, and that computer accesses a Microsoft service, Maptician may show the user as present in the office even though they are physically outside of it.
• If your network routes all outbound web traffic through a proxy or VPN rather than directly to the public internet, authentication events will display the proxy's IP address instead of the office's IP address. This becomes a problem if multiple locations share the same proxy, or if the proxy does not produce a consistent public IP address or range.

Maptician App IP Address-Based Presence Tracking

Maptician can use the IP addresses of users accessing its desktop and mobile web apps to track presence. This is an integration-free option that requires no third-party connection. 

Maptician Public API

The Maptician Public API can receive and process presence data from a wide variety of sources. This is not a native integration with any specific data source, but a flexible method for sending presence data from any compatible system into Maptician. 

Examples of supported data sources include:

• Badge access systems
• Citrix logs
• Local network traffic
• Internal IPs from Active Directory (Windows login)

For a full list of available presence endpoints, see the Presence API Endpoints section below. 

Access Control Systems

Maptician has three native integrations with badge access systems: 

• Brivo Access Control System - See the Brivo Integration Guide for details. 
• OpenPath Access Control System - See the OpenPath Setup Guide for details. 
• LenelS2 NetBox - See the LenelS2 NetBox: Integration Overview and Network Requirements article for details. 

For other badge access systems with a publicly accessible API, Maptician can generally integrate with them to retrieve the necessary data. Note that non-native integrations require additional development and testing time. 

Citrix Virtual Desktop Infrastructure

Maptician supports integration with both on-premises and cloud Citrix Virtual Desktop Infrastructure (VDI). For more information, refer to the Citrix On-Prem & Cloud Overview article. 

Presence API Endpoints

The following API endpoints are available for sending, updating, and retrieving presence data in Maptician. These endpoints accept data from any compatible source and follow the specifications in the the Maptician API documentation. All requests require an HTTPS POST (or GET where noted) with data formatted as JSON in the request body. 

Set Presence Status

Use these endpoints to set or clear presence for a single occupant in real time.

• Set Occupant Presence Status (API reference) - Sets the real-time presence status of a single occupant. Intended as the receiving endpoint for access control systems, network monitors, or other real-time presence sources. Presence is set immediately and ends at the earlier of a new status update, end of day, or the configured end of workday. 
• Clear Occupant Presence Status (API reference) - Clears (checks out) a single occupant's current presence status immediately. 
• Mark Present and Reserve Owned Seat (API reference) - Marks a user as present and automatically reserves their owned or restricted reservable seat for the day, if available. Intended for use with hotel seating strategies. 

Set Presence in Bulk

Use these endpoints to create or update presence entries for one or more occupants in a single request.

• Set Multiple Occupant Presence States (API reference) - Creates or updates presence states for multiple occupants in a single request. Supports at-location, remote, and other presence states. 
• Set Multiple Maptician Presence Entries (date only) (API reference) - Creates presence entries using a start date only, with no time component. The entry spans the entire indicated date. 
• Set Multiple Maptician Presence Entries (start time only) (API reference) - Creates presence entries with a start date and time but no exit time. End time defaults to end of day or the configured end-of-day time. 
• Set Multiple Maptician Presence Entries (start and end times) (API reference) - Creates time-bounded presence entries with both a start and end time. Intended for entrance and exit controlled systems or detailed presence tracking. 
• Set Multiple "On Leave" Presence Entries (API reference) - Creates time-bounded on-leave presence entries for one or more occupants. Both start and end times are required. 

Submit IP Access Events

Use these endpoints to send IP address-based presence data from sources such as Citrix logs, network traffic, or Active Directory.

• Submit IP Access Event (API reference) - Submits a single IP access event for one occupant accessing a system or network from a public IP address. 
• Submit Multiple IP Access Events (API reference) - Submits an array of IP access events representing multiple occupants accessing a system or network from public IP addresses. 

Retrieve Presence Status

Use these endpoints to retrieve current presence status for occupants in your environment.

• Get Single Occupant Presence Status (API reference) - Retrieves the current presence status for a specific occupant identified by userID or email address. 
• Get All Occupants Presence Status (API reference) - Retrieves the current presence status for all occupants in the environment. Can be filtered by office location and supports querying presence at a specific point in time.