ESPHome & Shelly → ThermalTrace

ThermalTrace does not ship ESPHome or Shelly components. Use HTTPS push ingest from firmware you already run on the LAN.

Prerequisites

1. Dashboard → Devices → create a push device and copy the ingest URL
   (POST https://thermaltrace.dev/api/ingest/<device-key>).
2. Map sensor keys under Devices after the first POST arrives.

Typed payload reference: Ingest on thermaltrace.dev.

ESPHome (temperature + humidity)

Add to secrets.yaml:

thermaltrace_ingest_url: "https://thermaltrace.dev/api/ingest/YOUR_DEVICE_KEY"

Minimal garage.yaml sketch:

esphome:
  name: garage-probe

http_request:
  id: http_req
  verify_ssl: true
  timeout: 10s

sensor:
  - platform: dht
    pin: GPIO4
    model: DHT22
    temperature:
      id: garage_temp_c
    humidity:
      id: garage_rh
    update_interval: 60s

interval:
  - interval: 60s
    then:
      - http_request.post:
          url: !secret thermaltrace_ingest_url
          request_headers:
            Content-Type: application/json
          body: !lambda |-
            char buf[280];
            snprintf(buf, sizeof(buf),
              "{\"sensors\":["
              "{\"key\":\"garage_temp\",\"kind\":\"temperature\",\"value\":%.1f,\"unit\":\"F\"},"
              "{\"key\":\"garage_rh\",\"kind\":\"humidity\",\"value\":%.0f,\"unit\":\"%%\"}"
              "]}",
              id(garage_temp_c).state * 9.0f / 5.0f + 32.0f,
              id(garage_rh).state);
            return std::string(buf);

Map garage_temp and garage_rh in the dashboard after the first successful POST.

Shelly (door contact)

On Shelly Plus / Gen2, use an HTTP request action when the door input changes. POST:

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

Use false when the door closes. Map garage_door as a door sensor in Devices.

Alert rule: door open while cold

Dashboard → Alerts → Rules → add a rule with all of:

• Door open (or door open longer than N minutes)
• Temperature below threshold

Product walkthrough: Garage door + cold playbook.

Dual-run with Home Assistant

Keep ESPHome or Shelly on MQTT locally and mirror to ThermalTrace for hosted freeze SMS and history. See MQTT bridge or the HACS integration.