eHeat Envi - Smart 500w or 1000W space heaters - Version 0.0.1 Available

Share your Projects! Custom Integrations
1

Have just got this heater and it appears to be smart and able to link to Google Cloud or Alexa, but they don’t allow any other integration other than their own app.

Having run a HTTPS snoop it looks like its not going to be that difficult to undertake as its a simple API such as:

GET https://app-apis.enviliving.com/apis/v1/device/list
list of devices

GET https://app-apis.enviliving.com/apis/v1/device/[device id]
Gets the device details and they are using a bearer auth key which can be obtained.

PATCH https://app-apis.enviliving.com/apis/v1/device/update-temperature/[device id]
Updates the Temp

I searched around and couldn’t find anyone else who’s adapted this and I’ll keep my progress within this thread.

— EDIT —

“Working” Version of this item in below post:

Now at Version 0.0.3 which includes Room temp and HACS integration.

2

I tried viewing the API traffic via mitmproxy but cannot get the app to trust the mitmproxy ca cert. How did you accomplish that?

Also, do you have a sample flow for getting a bearer token?

3

mitmproxy wasn’t working for me either, I ended up doing it via frida and httptoolkit.

Only way I got the bearer token was via the app itself.

Ended up getting side tracked and hoping to get back to this next week.

4

Looks like an API call to:

https://app-apis.enviliving.com/apis/v1/auth/login

With JSON:

{
  "password": "<plain text>",
  "login_type": 1,
  "username": "<email>",
  "device_id": "1",
  "device_type": "homeassistant"
}

Looks like the device_id is needed, but can be anything, same with device_type. The device Id generated by my virtual phone was:
b7fc91a908301e24

Reponse back is:

{
  "status": "success",
  "statusCode": 200,
  "msgCode": 1004,
  "msg": "Logged in successfully",
  "data": {
    "token": "<token>"
  }
}

I ran through this using Bruno to make sure I could send simple info and get replies back and looks like

5

This is my very very hacky and early version 0.0.1

Pretty much built using AI.

Currently working:
Turn on / off
Report / Set Temp

Possibly Working:
Adding multiple devices
(I only have one so cant test)

Not Working:
Room Temp Grab
Absolutely everything else (including HACS integration).

6

Not doing releases or anything fancy yet on Github, however we are now at version 0.0.2:

Currently working:
Turn on / off
Report / Set Temp
Room Temp

Possibly Working:
Adding multiple devices
(I only have one so cant test)

Not Working:
Absolutely everything else (including HACS integration).

7

Bumped to versions 0.0.3

Currently working:
Turn on / off
Report / Set Temp
Room Temp
HACS Integration

Possibly Working:
Adding multiple devices
(I only have one so cant test)

Not Working:
Absolutely everything else

It’d be great to have someone test this via HACS with two different heaters so we can see what breaks (if anything!)

8

v0.0.4

Now when an update happens and the API returns an issue (unauth’ed) it’ll reissue a key. It should have done this from the start, but it didn’t!

9

V0.0.5 was updating some API renewal logic
V0.0.6 Fixed a few errors / warnings which wanted me to update to the latest supported climate entity style.

10

V0.0.7 Continuing to Fix HA erros and warnings. Disabled compatibility mode (its fully compliant with the 2025.1 required changes).
V0.0.8 More API tweaks.

I’ve now had multiple API token renewals over the past 12 hours and everything looks to be working well.

11

This is super cool, thanks so much for putting it together and sharing the repo!

Newbie question: How do I go about testing this / adding the integration to HA?

12

Awesome integration. However as stated buggy. While login seems to work, reporting and sending updates (turning on / off) doesn’t.

13

Yep, I didn’t get full time to get this running fully. Currently it looks like every few days they change up the codes etc.

I’ll get back to it at some point.

14

Almost be worth while to see if one can ESPHome the device, since from network config it seems to be using a ESP32 controller.

15

Just ordered the heater. Any specific instructions to integrate with HA for a newbee?

16

Figured out how to get it into HA. Now just waiting for the heater. Any update on whether the integration is still working?

Thanks for your hard work!

17

@latic Thanks for the work on this.

I just added a second heater to my install and seems to work fine. Actually had to delete/reinstall my first heater and that went off smoothly as well.

One observation is that the status/History is always “Heat” unless turned off or “unavailable”. Mine does seem to go “Unavailable” (usually cycling back pretty quickly) on a pretty frequent basis.

18

To be honest I’ve really wanted to work on this more, but have been short on time.

The main thing that needs work on is the updating, it doesn’t update on a regular basis and its funky. I was hoping that Envi would take it over but they didn’t :frowning:

1 Like
19

Bummer that they didn’t pick it up. Mine is definitely cycling unavailable / available every minute or so. I don’t remember it doing that with only 1 unit.

20

I never tested with two, I bet what is happening is that its being successful with one, but because the other is not successful its getting the API key again and then going back and forward.

1 Like