Recetas para ESPHome y Shelly

Muchos garajes ya usan módulos ESPHome o Shelly para luces, puertas y climatización. No necesitas un sketch de Arduino personalizado para enviar datos a ProbeHarbor: haz un POST con el mismo JSON tipado sensors[] que acepta la API de ingesta desde cualquier cliente HTTPS de tu red local.

Antes de escribir el YAML

1. Crea un dispositivo push en Dashboard → Devices (un clic) y copia la URL de ingesta.
2. Envía un POST de prueba (con curl o desde el firmware): las claves se importan solas; cámbiales el nombre después si quieres.
3. Si quieres, mantén Mosquitto en local: consulta el puente MQTT o la integración HACS para usar ambos en paralelo.

Patrón con ESPHome

Activa el componente http_request, sondea tu sonda DHT/BME a intervalos y haz un POST con un cuerpo JSON de tipos temperature y humidity. Guarda la URL de ingesta en secrets.yaml y nunca subas la clave del dispositivo al repositorio.

        # secrets.yaml
probeharbor_ingest_url: https://probeharbor.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":"%"}
# ]}
      

YAML completo con cuerpo lambda: documentación para desarrolladores · referencia del payload en ingesta y webhooks.

Contacto de puerta con Shelly

En Shelly Plus / Gen2, lanza un HTTP POST cuando cambie la entrada de la puerta del garaje. Usa kind: door con bool: true cuando esté abierta y false cuando esté cerrada. Asigna la clave (por ejemplo garage_door) en Devices.

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

Qué hacer con los datos de puerta y temperatura

Combina un sensor de puerta con los umbrales de congelación en Dashboard → Alerts → Rules. Guía paso a paso: manual de puerta del garaje y frío. Combínalo con el manual para olas de frío para los pasos de respuesta del hogar.

Preguntas frecuentes

¿Tengo que dejar de usar MQTT de Home Assistant?
No. Muchos hogares usan ambos: Mosquitto en local para las automatizaciones, más la ingesta push por HTTPS para los SMS de congelación y fugas y el historial de ProbeHarbor.

¿Qué modelos de Shelly funcionan?
Cualquier Shelly que pueda enviar un HTTP POST (scripts de Plus / Gen2 o acciones de webhook). Asigna la clave de la puerta en Dashboard → Devices después del primer POST.