Aqvify

The Aqvify integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows users to integrate their Aqvify water well and tank sensors using the official public API.

Use case

  • Monitor the water level in a water well and trigger automations based on these sensor values.

Configuration

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

Manual configuration steps

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

Supported functionality

The Aqvify integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] supports the following entities:

Sensors

There is currently support for sensors measuring the well water level from different perspectives. Please refer to Aqvify’s documentation for the exact interpretation of the values.

Automation example

Get started with this automation example:

Send a notification when the water level in the well is below a limit

Example YAML configuration
AutomationAutomations in Home Assistant allow you to automatically respond to things that happen in and around your home. [Learn more]
alias: "Notify when water level is below 15 meters from ground surface"
triggers:
  - trigger: numeric_state
    entity_id: sensor.water_level
    below: -15.0
actions:
  - action: notify.send_message
    target:
      entity_id: notify.my_phone
    data:
      message: "Low water level in well."

Data updates

The integration will poll the API for data every 60 seconds. This polling interval is designed to work within the rate limits of Aqvify APIs while providing timely updates.

Troubleshooting

Can’t set up the device

To resolve this issue, try the following steps:

  1. Make sure your Home Assistant is connected to the internet.
  2. Make sure that you have entered the correct API key.
  3. Make sure the app of the manufacturer can see the device.

The installation went smooth but I can’t see my devices

Make sure the devices are visible and controllable via the manufacturer’s app. If they are not, check the device’s power and network connection and refer to manufacturer’s documentation.

Removing the integration

This integration follows standard integration removal.

To remove an integration instance from Home Assistant

  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 dots menu. Then, select Delete.