New Thermostat Temperature Threshold Monitoring

This week, we’re excited to announce new thermostat temperature range monitoring functionality. Our new temperature thresholds enable you to set a temperature range and receive event notifications whenever the current temperature reported by a thermostat crosses outside of the range. This can be handy for detecting malfunctioning HVAC systems or thermostat misuse, such as running the A/C too low.

To start, set upper and lower temperature thresholds for your thermostat. Then, if the thermostat reports a temperature outside this range, Seam emits a thermostat.temperature_threshold_exceeded event. Seam also adds a warning to the affected device.

Setting the Threshold

First, set the threshold range in Celsius or Fahrenheit using the new setTemperatureThreshold function with the desired upper and lower limit parameters.

JavaScript
1await seam.thermostats.setTemperatureThreshold({
2  device_id: "2d488679-6f07-4810-aed2-e726872c1dd5",
3  lower_limit_celsius: 4,
4  upper_limit_celsius: 30
5});

Monitoring for Events

Next, monitor for incoming webhooks with the thermostat.temperature_threshold_exceeded event. This event includes the device_id of the affected thermostat, as well as the configured threshold values and the reported temperature that exceeded this threshold range.

JSON
1{
2  "event_id": "1d045cba-af1b-44a6-a167-af0c82c0bf74",
3  "device_id": "2d488679-6f07-4810-aed2-e726872c1dd5",
4  "event_description": "Current temperature (3.5°C) has exceeded the lower limit of 4°C.",
5  "event_type": "thermostat.temperature_threshold_exceeded",
6  "workspace_id": "0664b610-ec46b-4366-ad29-78491f7832bc",
7  "created_at": "2024-10-23T21:28:05.894Z",
8  "occurred_at": "2024-10-23T21:28:02.212Z",
9  "temperature_celsius": 3.5
10  "temperature_fahrenheit": 38.3
11  "lower_limit_celsius": 4
12  "lower_limit_fahrenheit": 39.2
13  "upper_limit_celsius": 30
14  "upper_limit_fahrenheit": 86
15  "connected_account_id": "f2249ed5-621d-4cf2-a2ed-5935e3b9a4cd",
16}

For more details on this functionality, check out our updated docs.

2024.10.25 Changelog

New

device.added event: We’ve introduced a device.added event to indicate when a new device is added to Seam or when a device is re-added to Seam after having been removed. This event pairs with device.removed, and we encourage you to use device.added instead of device.connected to confirm the addition of devices to Seam.

device.connected and device.disconnected are intended for monitoring online and offline status changes. That is, this pair of events specifically addresses a device’s internet connection status.

The new device.added event is especially useful for devices that are always considered offline, such as devices that support offline access codes.
New method property for thermostat.manually_adjusted event: We added a new method property for the thermostat.manually_adjusted event. This property indicates whether the thermostat adjustment was caused by the Seam API (seam) or by a person making a change at the thermostat (manual). While API-triggered events provide information on the usage of your app, manual events inform you about guest behavior.

Changed

Improved Google Nest name display: We now display more descriptive Google Nest device names, which makes it easier to distinguish between multiple Nest devices, especially in the Seam Console.
Seam thermostat actions for Ecobee: When you issue an “imperative” thermostat action, such as /thermostats/heat, we now override the thermostat’s native scheduling for Ecobee devices. We’re adding this functionality for Honeywell thermostats next.

Fixes

Unmanaged code deletion: We fixed an edge-case where deleting unmanaged codes could lock devices into a state in which no other codes could be added or removed.

New Thermostat Temperature Threshold Monitoring