Integration Guide
Step-by-step instructions for setting up the Microsoft Places integration with Haltian IoT
Alpha — This integration is under active development and available for limited testing. Features are incomplete and may change significantly. Not recommended for production use.
Microsoft Places is a workplace intelligence platform within Microsoft 365. This integration pushes real-time occupancy data from Haltian IoT sensors into the Microsoft Graph API (Places resource), where it surfaces as sensor-verified room and desk availability in Teams and Outlook.

End-to-end architecture: Haltian IoT sensors to Microsoft Places
The integration connects Haltian’s physical sensor infrastructure to Microsoft’s workplace intelligence platform. Occupancy data can originate from two sources:
Sensors form a Wirepas mesh network — each device routes data through neighbouring devices to the Haltian IoT Gateway, which forwards it to the cloud. IoT Studio’s map view shows the live mesh topology for the entire installation:

IoT Studio: sensor mesh topology on a floor map
| Component | Role |
|---|---|
| Haltian sensors | Detect physical occupancy (presence, people count, desk usage, entry/exit) |
| Haltian IoT Gateway | Aggregates sensor data and forwards to the cloud |
| Haltian Cloud Backend | Receives, stores, and normalizes sensor measurements |
| Device Groups | Virtual devices that aggregate measurements from multiple physical sensors within a space |
| Occupancy Engine | Consumes raw sensor events from device groups, applies algorithms to calculate occupancy metrics, and produces unified occupancy state |
| Microsoft Graph API | Receives occupancy updates for rooms, desks, and zones via the Places resource in Microsoft Graph |
| Microsoft Places | Surfaces occupancy data in Teams, Outlook, and workplace analytics |
Sensors are grouped into device groups in IoT Studio — one group per room or zone. Each device group maps to a Microsoft 365 room resource:

IoT Studio: a device group representing a single meeting room
IoT Studio shows the live occupancy status computed by the Occupancy Engine before it is pushed to Microsoft:

IoT Studio: real-time occupancy status for a device group
Haltian maps physical sensors (or device groups) to Microsoft Places resources:
| Source | Microsoft Places Resource | Use Case |
|---|---|---|
| Single PIR / Radar sensor | Meeting room mailbox | Small room availability |
| Device group (multiple sensors) | Meeting room mailbox | Large room / multi-zone occupancy |
| Single desk sensor | Bookable workspace | Desk occupancy status |
| Device group (entry/exit sensors) | Floor section | Zone/floor utilization analytics |
Step-by-step instructions for setting up the Microsoft Places integration with Haltian IoT
Which Haltian sensors work with Microsoft Places and how they map to rooms, desks, and zones