> ## Documentation Index
> Fetch the complete documentation index at: https://www.seam.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cielo Thermostats

> Guide for using Cielo smart thermostats and Breez air conditioner controllers with Seam. Review supported devices, features, restrictions, and setup instructions for your integration.

> [!NOTE]
>
> The Cielo integration is in beta. To enable it for your workspaces, contact [Seam support](mailto:support@seam.co).

## Overview

Cielo makes smart controllers for heating and cooling systems. The Cielo Breez range adds remote control to mini-split, window, and portable air conditioners and heat pumps, using the same infrared signals as the unit's own remote control. The Cielo Smart Thermostat replaces a wall thermostat for central heating and cooling.

Seam represents each Cielo device that heats or cools as a thermostat. You can set the device to heat, cool, or off, set heat-cool mode on a Cielo Smart Thermostat, and read the room temperature and humidity.

***

## Supported Devices

This integration supports Cielo devices that control heating or cooling: the Cielo Breez air conditioner controllers and the Cielo Smart Thermostat. Seam reports a Breez controller as a **Cielo Breez** device and a Smart Thermostat as a **Cielo Thermostat** device. Both have the `cielo_thermostat` device type.

A Cielo device that controls a fan-only unit has no heating or cooling mode, so it doesn't appear in Seam.

***

## Supported Features

We support the following features:

* [Configuring current thermostat settings](https://www.seam.co/docs/capability-guides/thermostats/configure-current-climate-settings.md): heat, cool, and off, plus heat-cool on Cielo Smart Thermostats
* [Creating and managing climate presets](https://www.seam.co/docs/capability-guides/thermostats/creating-and-managing-climate-presets.md)
* [Creating and managing thermostat schedules](https://www.seam.co/docs/capability-guides/thermostats/creating-and-managing-thermostat-schedules.md)
* Reading the room temperature and relative humidity

Each device reports the modes that it supports. To check, [get the device](https://www.seam.co/docs/capability-guides/thermostats/retrieving-thermostats.md) and look at the `can_hvac_heat`, `can_hvac_cool`, and `can_hvac_heat_cool` capability flags. For more information, see [Thermostat Capabilities](https://www.seam.co/docs/capability-guides/thermostats.md#thermostat-capabilities).

***

## Brand-Specific Restrictions

Note the following Cielo-specific restrictions:

### API Keys

Your users connect Cielo to Seam with an API key that they create at [home.cielowigle.com](https://home.cielowigle.com). Cielo lets each key connect to only one app, and a Cielo account can create only a few keys in a 30-day period. If a key was already used anywhere else, including an earlier attempt to connect it to Seam, the user must create a new key. For details, see the [Cielo Setup Guide](https://www.seam.co/docs/device-and-system-integration-guides/cielo-thermostats/cielo-setup-guide.md).

### Heat-Cool Mode

Only the Cielo Smart Thermostat supports `heat_cool` mode through Seam, with separate heating and cooling set points. A Breez controller's automatic mode uses a single target temperature, so Seam doesn't offer `heat_cool` for Breez devices, and `can_hvac_heat_cool` isn't set.

If someone sets a Breez device to automatic mode in the Cielo app, Seam reports `hvac_mode_setting` as `heat_cool` with the heating and cooling set points both equal to that target temperature.

### Settings on Breez Devices Are Sent, Not Confirmed

A Breez controller sends one-way infrared signals to the air conditioner. The air conditioner doesn't report back, so the `current_climate_setting` that Seam reports for a Breez device is the last setting sent, not a reading from the unit. For commands to arrive, the Breez controller needs a clear line of sight to the air conditioner's infrared receiver.

### Set Points

Each Cielo device accepts a fixed list of set points for each mode, usually whole degrees in the unit that the device is set to. Seam converts your Celsius or Fahrenheit set point and rounds it to the nearest value that the device accepts. Seam rejects a set point outside the device's range with a `heating_set_point_out_of_range` or `cooling_set_point_out_of_range` error. Seam reports the range on the device as `min_heating_set_point_celsius`, `max_heating_set_point_celsius`, `min_cooling_set_point_celsius`, and `max_cooling_set_point_celsius` (or `_fahrenheit`).

### Cielo Presets and Fan Modes

Seam doesn't expose the presets that users create in the Cielo app. When Seam changes a set point, the device leaves any active Cielo preset, as it does when someone changes the set point in the Cielo app. To save and schedule settings, use [Seam climate presets](https://www.seam.co/docs/capability-guides/thermostats/creating-and-managing-climate-presets.md).

Seam doesn't support setting the fan mode on Cielo devices. Seam also doesn't represent a Breez device's dry and fan-only modes. If someone selects one of these modes in the Cielo app, Seam continues to report the last heat, cool, or off setting.

### Weekly Programs

Seam doesn't support [thermostat weekly programs](https://www.seam.co/docs/capability-guides/thermostats/creating-and-managing-thermostat-programs.md) on Cielo devices. Use [thermostat schedules](https://www.seam.co/docs/capability-guides/thermostats/creating-and-managing-thermostat-schedules.md) instead.

### Offline Devices

When Cielo reports that a device is offline, Seam marks the device offline and rejects commands to it until it reconnects.

### Update Frequency

Cielo doesn't send webhooks, so Seam reads each Cielo account every 5 minutes. A change made in the Cielo app or on the device can take that long to appear in Seam.

***

## Device Provider Key

Seam identifies these devices with the `cielo` device provider key. To show only Cielo in a [Connect Webview](https://www.seam.co/docs/core-concepts/connect-webviews.md), include `cielo` in the `accepted_providers` list. For more information, see [Customize the Brands to Display in Your Connect Webviews](https://www.seam.co/docs/core-concepts/connect-webviews/customizing-connect-webviews.md#customize-the-brands-to-display-in-your-connect-webviews).

***

## Setup Instructions

For step-by-step instructions on connecting Cielo devices to Seam, including how to create a Cielo API key and troubleshoot the connection, see the [Cielo Setup Guide](https://www.seam.co/docs/device-and-system-integration-guides/cielo-thermostats/cielo-setup-guide.md).

***

## Where to Order

> [card] [Cielo - Smart AC Controllers and Thermostats](https://cielowigle.com/)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.