Home Assistant custom integration for Hisense cloud-connected smart devices. Only Air conditioners (AC) are supported. If you want support for more device types, pull requests are welcome.
- Home Assistant 2025.6 or newer (for older cores, see releases).
- A Hisense account that can sign in to the official mobile app (same username and password).
- The AC must already be paired in the app and belong to a home.
- Open HACS in Home Assistant.
- Go to Integrations → menu (⋮) → Custom repositories.
- Add repository
https://github.com/manymuch/HisenseHA, category Integration. - On the Hisense Smart Devices card, click Download.
- Restart Home Assistant when prompted.
-
Download a release archive from Releases, extract it, and copy the contents into your Home Assistant configuration directory:
config/custom_components/hisense/ -
Restart Home Assistant.
- Go to Settings → Devices & services → Add integration.
- Search for Hisense Smart Devices (or Hisense) and select it.
- Enter your Hisense app username and password (wrong credentials will show an authentication error).
- Choose the home that contains your AC.
- Select one or more devices, then finish the wizard.
This integration talks to the Hisense cloud. Device state in the UI updates mainly after you act on an entity (for example changing temperature, power, or mode); it does not continuously poll full device state on a fixed interval in the background.
Each device exposes two Diagnostic buttons (names follow your UI language; in English they are Refresh token and Force refresh):
- Refresh token: Exchanges the refresh token with Hisense servers for a new access token. Tokens usually last months and are renewed automatically. This control is mainly for developer debugging; do not press it unless for you know exactly what to do.
- Force refresh: Requests the current state once from the Hisense cloud. Each press causes a real cloud request. Do not automate it as “poll every few seconds or minutes,” or you may hit rate limits or get the API endpoint blocked entirely.
If you need real-time status update, we recommend pairing the same Hisense device with Mi Home as well, then in Home Assistant use Xiaomi Miot or Xiaomi Home to observe Mi Home state changes, and an automation that triggers this integration’s Force refresh button for the matching device when the Xiaomi entity changes, to sync Hisense entities indirectly.
