Butlr Developer Docs
  • Welcome
  • What is Butlr
  • Spatial Metrics
  • Getting Started
    • Authentication
    • Making your first query
    • Mint Client Credentials
  • Changelog
  • Asset Management
    • GraphQL API Overview
      • Sites
      • Buildings
      • Floors
      • Rooms
      • Zones
      • Hives
      • Sensors
      • Asset Tags
    • GraphQL API Introsepction
  • Historical Occupancy
    • Reporting API Overview
      • Floor Occupancy
      • Room Occupancy
      • Zone Occupancy
      • Query Occupancy by Tag
      • Traffic
      • Presence Time
      • Statistic Overview
    • FAQs
  • Real-time occupancy
    • Webhooks Overview
      • Area Detections
      • Entryway Traffic
      • Floor Occupancy
      • Room Occupancy
      • Zone Occupancy
      • Motion Detection
      • No Motion Detection
    • Manage Webhooks
      • Create Webhooks
      • Update Webhooks
      • Delete Webhooks
      • List Webhooks
  • LINKS
    • Butlr Postman Collection
    • Butlr Website
    • Status
    • Support
    • Log In
Powered by GitBook
On this page
  • Butlr Webhooks
  • Benefits
  • Available Webhooks
  • 1. Detections
  • 2. Traffic
  • 3. Floor Occupancy
  • 4. Room Occupancy
  • 5. Zone Occupancy
  • 6. Motion Detection
  • 7. No Motion Detection
  1. Real-time occupancy

Webhooks Overview

Butlr's webhooks deliver real-time data on key events, including occupancy and traffic data. Subscribing ensures automatic updates, timely insights, and structured data for informed decision-making.

PreviousFAQsNextArea Detections

Last updated 2 months ago

Users can subscribe only once to each event type (Detections, Traffic, Floor Occupancy, Room Occupancy, Zone Occupancy, Motion / No Motion detected).

Event ordering is not guaranteed. Prioritizing speed, we deliver events as received. Use event timestamps for ordering and implement idempotent processing to handle potential out-of-order or duplicate events.

Butlr Webhooks

Butlr webhooks provide real-time updates on a variety of events, including , , , , , , and detected. By subscribing to these webhooks, users gain automatic access to timely and accurate information without the need for manual checks or data requests.

Our webhooks deliver structured, easy-to-process data, enabling real-time notifications that support informed decision-making. This empowers users to react swiftly to changes, optimize physical spaces, and improve operational efficiency. With Butlr webhooks, you can confidently make data-driven decisions, maximizing the value of your real estate portfolio.

Benefits

  • Receive real-time updates on events and changes.

  • Eliminate manual checks and data requests.

  • Streamline data processing and stay updated.

  • React quickly to changes and make data-driven decisions.

Available Webhooks

1.

  • Event Type: DETECTIONS

  • Description: Receive coordinates (x, y) of detected people within a monitored area.

  • Payload Example:

{
  "id": "event_xxx",
  "type": "DETECTIONS",
  "timestamp": 1727735832000,
  "version": "v1.0.0",
  "metadata": { ... },
  "data": {
    "local": [ [0.5625, 0.125], [0.75, 0.5625] ], // 2 detections
    "world": [ [85.694195, 27.829299], [87.439295, 28.577199]] // 2 detections
  }
}
  • Event Type: TRAFFIC

  • Description: Receive updates on people entering or exiting a monitored area.

  • Payload Example:

{
  "id": "event_xxx",
  "type": "TRAFFIC",
  "timestamp": 1727735832000,
  "version": "v1.0.0",
  "metadata": { ... },
  "data": {
    "in": 0,
    "out": 1
  }
}
  • Event Type: FLOOR_OCCUPANCY

  • Payload Example:

{
  "id": "event_xxx",
  "type": "FLOOR_OCCUPANCY",
  "timestamp": 1727735832000,
  "version": "v1.0.0",
  "metadata": { ... },
  "data": 25
}
  • Event Type: ROOM_OCCUPANCY

  • Payload Example:

{
  "id": "event_xxx",
  "type": "ROOM_OCCUPANCY",
  "timestamp": 1727735832000,
  "version": "v1.0.0",
  "metadata": { ... },
  "data": 4
}
  • Event Type: ZONE_OCCUPANCY

  • Payload Example:

{
  "id": "event_xxx",
  "type": "ZONE_OCCUPANCY",
  "timestamp": 1727735832000,
  "version": "v1.0.0",
  "metadata": { ... },
  "data": 1
}

Available only with Heatic 2+ sensors.

  • Event Type: PIR_MOTION

  • Description: Event sent when motion is captured by the Heatic 2+ sensor, indicating activity detected in a room.

  • Payload Example:

{
  "id": "event_xxx",
  "type": "PIR_MOTION",
  "timestamp": 1727735832000,
  "version": "v1.0.0",
  "metadata": { ... },
}

Available only with Heatic 2+ sensors.

  • Event Type: PIR_NO_MOTION

  • Description: Event sent when the Heatic 2+ sensor detects no motion, indicating no activity has occurred in a room.

  • Payload Example:

{
  "id": "event_xxx",
  "type": "PIR_NO_MOTION",
  "timestamp": 1727735832000,
  "version": "v1.0.0",
  "metadata": { ... },
}

2.

3.

Description: Receive updates on the number of occupants detected by the on a specific floor.

4.

Description: Receive updates on the number of occupants detected by the in a specific room.

5.

Description: Receive updates on the number of occupants detected by the in a specific zone.

6. Detection

7. Detection

Detections
Traffic
Floor Occupancy
Room Occupancy
Zone Occupancy
Motion
No Motion
Detections
Traffic
Floor Occupancy
Room Occupancy
Zone Occupancy
Motion
No Motion
presence sensor
presence sensor
presence sensor