To offer you maximum flexibility, Ondilo provides an open API (Customer API) that allows you to connect your ICO smart water analyser to your home automation platforms. This guide explains how to make the most of this connectivity and set up your integrations step by step.
Before setting up any home automation, please ensure that your ICO is correctly configured and working properly on the official ICO mobile app.
Please note:
If you wish to carry out a custom integration or develop your own script, you can refer to our official technical documentation. Our API is based on the secure OAuth2 protocol and allows you to retrieve all the water data for your swimming pool or spa (pH, temperature, redox, salinity), as well as ICO data (battery level, RSSI signal).
🔗 View the official documentation: Ondilo Customer API v1
The Ondilo ICO integration is natively supported by Home Assistant. It automatically creates the device(s) and the associated entities (measurements)
4. In the search bar, type ‘Ondilo ICO’ and select it.
5. A window will appear asking you to enter your ICO mobile app credentials to confirm the pairing.
Useful link: Home Assistant Integration Documentation
The Home Assistant integration is very stable, but the platform’s architecture means there are a few points to bear in mind.
Jeedom communicates with ICO via a dedicated plugin developed for the platform, making it easy to connect your devices.
Useful link: Jeedom Plugin Community and Support Forum
Jeedom offers complete control, but its reliance on internal scheduled tasks can sometimes cause issues.
If you change the physical sensors on your ICO (for example, replacing the pH probe), Jeedom may retain the old command as a duplicate. Remember to go to the ICO device settings, under the ‘Commands’ tab, to delete the old, redundant entry.
The eedomus box comes with a dedicated ICO device built in, allowing you to monitor everything centrally in a matter of moments.
Customisation tip:
Once the device has been created, you can go to its settings to hide or disable any channels that do not apply to your pool (for example, the ‘Salt’ channel if you use chlorine or bromine for treatment).
🔗 Useful link: Official eedomus and ICO documentation
The eedomus box prioritises simplicity, but this means there is less flexibility in the event of a graphical glitch.
On eedomus, if the cloud authentication fails, the display may simply freeze without showing an explicit error message. The trick is to return to the eedomus web portal, open the ICO device settings, and click on ‘Re-link account’ to force the box to retrieve a new access token from Ondilo.
Connecting your ICO smart water analyser to your home automation system could be the key to transforming the maintenance of your swimming pool or spa into a seamless, centralised and automated experience. By combining the accuracy of Ondilo’s analyses with the scripting power of your control hub (Home Assistant, Jeedom or eedomus), you can provide your pool with bespoke protection whilst optimising your energy consumption.
Although ICO’s battery-powered operation requires data to be refreshed at regular intervals (Cloud Polling), the gateways and plugins we have developed ensure reliable historical tracking and give you complete peace of mind on a day-to-day basis.
The user forums for Home Assistant, Jeedom and eedomus are very active. There you’ll find plenty of enthusiasts sharing examples of their visual boards and their best filtering scenarios.