How to integrate Home Assistant with Cielo Smart Thermostat?

The Cielo Home integration lets you control your Cielo Smart Thermostat directly from Home Assistant using the cloud-based Cielo Connect API. Once set up, you can change modes, adjust temperature settings, and manage your device alongside the rest of your smart home.

• Build powerful climate automations tailored to your lifestyle.
• Integrate with the smart home devices you already use, such as lights, locks, and more.
• Create routines that keep your home comfortable while helping reduce unnecessary energy use.

Before You Begin

Before integrating the Cielo Smart Thermostat with Home Assistant, ensure that:

• Your device is registered and active in the Cielo Home app.
• Your Home Assistant server has active internet access.

Understanding API Key Rules

Cielo enforces the following security restrictions to protect your account and prevent unauthorized access. Read these carefully before generating a key.

1. Each API key can be used only once.
2. A new API key cannot be generated until the current one is revoked.
3. You may generate a maximum of 3 keys per month.
4. Once a new API key is generated, wait 60 seconds for it to be displayed on the screen.
5. Revoking an API key will disconnect Home Assistant immediately or within about a minute.

Obtaining an API key

• Visit the Cielo Web Portal.
• Open the Menu by selecting the hamburger menu icon at the top left.
• Select Home Assistant from the sidebar.
• The API key will be displayed. Copy the API key from the dialog.

Configuration

To add the Cielo Home hub to your Home Assistant instance, use this My button:

Manual Configuration

If the above My button doesn’t work, you can also perform the following steps manually:

Browse to your Home Assistant instance.

1. Go to Settings > Devices & Services.
2. In the bottom right corner, select +Add Integration button.
3. From the list, select Cielo Home.
4. Follow the instructions on screen to complete the setup.

If authentication succeeds, Home Assistant will automatically create the climate entities for your Cielo Smart Thermostat. 

Supported Functionality

Each supported device exposes at least one climate entity.

Climates

The climate platform integrates a compatible Cielo Smart Thermostat into Home Assistant, enabling control through the Home Assistant user interface.

• HVAC modes: Cool, Auto, Heat, Off 
• Temperature control: Set the temperature setpoint. 
• Presets: Home, Away, Sleep & Wake (where supported and defined)

Actions

This integration does not provide any custom service actions. All controls are performed using the standard Home Assistant climate services. 

Troubleshooting

This integration relies on an active internet connection and access to the Cielo Home API. Here are a few things to check before raising an issue:

• "This key is already used" message 

Your current API key has already been assigned to a Home Assistant instance. Revoke the existing key first, then generate a new one.

• Integration not appearing in Home Assistant 

Ensure your Home Assistant server has active internet access. The Cielo integration requires a cloud connection to function.

• Device not showing after setup 

Wait a few minutes after completing the integration; device sync can take up to 2–3 minutes. If the device still doesn't appear, try removing and re-adding the integration.

• Home Assistant disconnected unexpectedly 

This typically means the API key was revoked, either manually or because a new key was generated. Obtain a fresh API key and reconnect.

If devices still fail to load after these steps, please contact Cielo Tech Support.

Removing the Integration

To remove an integration instance from Home Assistant, follow these steps:

1. Go to Settings > Devices & Services and select the integration card.
2. From the list of devices, select the integration instance you want to remove.
3. Next to the entry, select the three dotsmenu. Then, select Delete.