ESPHome and Shelly recipes

Post temperature, humidity, and door contact readings from ESPHome or Shelly firmware to ThermalTrace push ingest without custom Arduino sketches.

Close-up of white Cat-5e Ethernet cables with RJ45 connectors
Probe JSON usually leaves the LAN over Ethernet or a nearby relay, not the public internet directly. Photo: DiscDepotDundee.co.uk. CC BY-SA 4.0

Many garages already run ESPHome or Shelly modules for lights, doors, and climate. You do not need a custom Arduino sketch to feed ThermalTrace. POST the same typed sensors[] JSON the ingest API accepts from any HTTPS client on your LAN.

Before you wire YAML

  1. Create a push device under Dashboard → Devices (one click) and copy the ingest URL.
  2. Send one test POST (curl or firmware): keys auto-import; rename later if you want.
  3. Keep Mosquitto local if you want: see MQTT bridge or the HACS integration for dual-run.

ESPHome pattern

Enable the http_request component, poll your DHT/BME probe on an interval, and POST a JSON body with temperature and humidity kinds. Store the ingest URL in secrets.yaml, never commit the device key.


        # secrets.yaml
thermaltrace_ingest_url: https://thermaltrace.dev/api/ingest/YOUR_DEVICE_KEY

# interval action (simplified)
# POST {"sensors":[
#   {"key":"garage_temp","kind":"temperature","value":42.1,"unit":"F"},
#   {"key":"garage_rh","kind":"humidity","value":38,"unit":"%"}
# ]}
      

Full YAML with lambda body: developer docs · payload reference in ingest and webhooks.

Shelly door contact

On Shelly Plus / Gen2, fire an HTTP POST when the garage door input toggles. Use kind: door with bool: true when open and false when closed. Map the key (for example garage_door) under Devices.


        {
  "sensors": [
    { "key": "garage_door", "kind": "door", "bool": true }
  ]
}
      

What to do with door + temp data

Combine a door sensor with freeze thresholds using Dashboard → Alerts → Rules. Walkthrough: garage door + cold playbook. Pair with the cold-snap playbook for household response steps.

FAQ

Do I need to stop using Home Assistant MQTT?
No. Many households dual-run: Mosquitto locally for automations, plus HTTPS push ingest for ThermalTrace freeze and leak SMS and history.

Which Shelly models work?
Any Shelly that can send an HTTP POST (Plus / Gen2 scripting or webhook actions). Map the door key under Dashboard → Devices after the first POST.