La alerta de heladas que sigue funcionando cuando Home Assistant está caído

Lo que aporta a una instalación de Home Assistant

• Una alerta cuando la casa se queda en silencio. Si las lecturas se detienen durante un número de horas que tú defines, ProbeHarbor te avisa. En invierno, el silencio suele significar que se cortó la luz o internet, y puede que la calefacción también.
• Alertas que no dependen de tu red. Correo, notificaciones push y apps de chat en el plan gratuito; SMS en Pro. Los miembros del hogar las reciben sin acceso a tu Home Assistant.
• Aviso antes de que llegue el frío. Una estimación del tiempo hasta la congelación en todos los planes, avisos de heladas según el pronóstico en Member y alertas del National Weather Service (EE. UU.) en Pro.
• Sin hardware nuevo. Envía cualquier entidad de temperatura o de fugas desde Home Assistant. Dos dispositivos son gratis.

Dos direcciones, usa una o ambas: envía entidades de Home Assistant a ProbeHarbor para recibir alertas externas (el YAML se genera con tu clave en Dashboard → Devices cuando eliges Home Assistant), e importa las sondas de ProbeHarbor en Home Assistant como entidades con la integración HACS de abajo. Contexto: cómo configurar una alerta de heladas en Home Assistant y qué pasa durante un corte de luz.

Instalar con HACS

1. En Home Assistant: HACS → Integrations → ⋮ → Custom repositories
2. Añade el repositorio https://github.com/doodersrage/probeharbor-home-assistant (categoría: Integration)
3. Instala ProbeHarbor y reinicia Home Assistant
4. Settings → Devices & services → Add integration → ProbeHarbor
5. Crea un enlace para compartir en vivo en Dashboard → Share (Free incluye un enlace familiar en vivo; Pro añade historial/métricas y enlaces sin caducidad) y pega el token de /share/YOUR_TOKEN

Guía ampliada para desarrolladores: guía de Home Assistant ↗ · Las recetas YAML manuales siguen funcionando si prefieres sensores REST en lugar de HACS.

Lo que aparece en HA

• Sensores: temperatura, humedad, CO₂, presión, PM2.5, COV, nivel, energía y sondas numéricas genéricas
• Sensores binarios: estados de puerta, inundación/fuga, movimiento y alimentación
• Sondeo. HACS consulta cada 5 minutos por defecto (configurable entre 60 y 3600 s). Es suficiente para dashboards; para umbrales de helada y contactos de humedad críticos, mejor usa la ingesta push nativa (ESP/Arduino → ProbeHarbor) para que las alertas salten con la lectura y no tras la siguiente consulta de HA. Usar ambos a la vez es lo habitual: push para los SMS de heladas y fugas, HACS para las entidades locales.
• Servicios (webhook entrante opcional + secreto desde Dashboard → Share): thermaltrace.snooze, vacation, clear_snooze, clear_vacation, status
• Servicio push (clave de ingesta opcional): thermaltrace.push con un diccionario JSON payload

Formatos JSON nativos (push y pull)

Además de la vía HACS con enlace para compartir, ProbeHarbor detecta automáticamente el JSON que tu instalación de HA quizá ya emite, sin envoltorios personalizados.

• Sensor REST de Home Assistant. Envía o consulta { "state": "65.3", "attributes": { "unit_of_measurement": "°F" } }; asigna la clave de sonda state en Devices
• SenML (RFC 8428). Array JSON con unidades Cel / %RH; habitual en pasarelas IoT
• thermaltrace.push: sensors[] nativos desde automatizaciones (consulta la temperatura interior más abajo)
• Puente MQTT: desempaqueta payloads MQTT de la red local con POST /api/ingest/mqtt

Ejemplos en vivo: HA REST · SenML · Guía de formatos de ingesta

Temperatura interior a través de Home Assistant

Para comparar la casa con las sondas en Overview y History. Dos vías: Nest OAuth en Pro (cuando está disponible), o enviar cualquier entidad climate de HA como plan B: útil cuando el registro de desarrolladores de Ecobee está cerrado o usas otra marca de termostato.

Nest OAuth (Pro, preferible cuando está disponible)

En probeharbor.dev, los hogares Pro pueden conectar Nest desde Dashboard → Temperature para ver la temperatura interior en vivo, la consigna y el modo de climatización junto a las sondas del ático, el sótano técnico o el taller: las alertas de heladas pueden incluir ese contexto. El historial guarda instantáneas del termostato con el mismo cron de ~15 minutos que los demás recolectores Pro.

• Comparativa para usuarios: ProbeHarbor vs Nest
• Operadores autoalojados que activan secretos OAuth: configuración de Nest y Ecobee para operadores

Plan B: envía el aire interior desde Home Assistant

El registro del programa de desarrolladores de Ecobee suele estar cerrado, así que Ecobee OAuth puede no estar disponible ni siquiera en Pro. Cualquier termostato que ya esté en HA (Ecobee, Nest vía HA, climate.* genérico) puede alimentar ProbeHarbor: envía el aire interior con thermaltrace.push y luego elige esa sonda como tu Indoor reference en Dashboard → Devices.

1. Expón tu termostato en HA (p. ej. climate.living_room).
2. Cada 15 minutos, llama a thermaltrace.push con un sensor temperature (clave house_indoor).
3. En ProbeHarbor: Devices → Indoor reference: elige ese sensor.

automation:
  - alias: Push house temp to ProbeHarbor
    trigger:
      - platform: time_pattern
        minutes: "/15"
    action:
      - service: thermaltrace.push
        data:
          sensors:
            - key: house_indoor
              kind: temperature
              value: "{{ state_attr('climate.living_room', 'current_temperature') }}"
              unit: F

También es útil para Ecobee vía HA cuando OAuth no está disponible: consulta ProbeHarbor vs Ecobee. Notas ampliadas sobre el payload (GitHub Pages): documentación para desarrolladores ↗

Uso conjunto con MQTT (lo habitual)

ProbeHarbor no es un broker MQTT. La mayoría de los aficionados al homelab mantienen Mosquitto / ESPHome / HA MQTT en la red local y replican ciertos topics por HTTPS cuando quieren alertas de heladas y fugas en la nube e historial.

• Receta de puente MQTT → HTTPS POST /api/ingest/mqtt con tu clave de dispositivo
• Flujo de Node-RED para suscriptores de Mosquitto
• ProbeHarbor vs MQTT autoalojado, cuándo las alertas alojadas superan a mantener tu propia infraestructura

Alertas en Home Assistant

Los webhooks salientes de Pro se disparan cuando ProbeHarbor envía una alerta de helada, de fuga o de una regla personalizada. Apunta la URL a tu endpoint de webhook de HA o importa el blueprint.

• Descargar el YAML del blueprint de webhook
• YAML de nombres de entidades para dispositivos push
• Guía del producto: Ingesta y webhooks
• Configura los tokens salientes y entrantes en Dashboard → Share

Verifica X-Signature cuando definas un secreto de firma de webhook en ProbeHarbor. HA (o cualquier receptor) debe rechazar los POST que no superen la comprobación HMAC. El blueprint documenta la cabecera; más detalles en la guía de ingesta y webhooks y en las preguntas frecuentes de abajo.

Automatización de ejemplo

Pospón las alertas de heladas y fugas de ProbeHarbor mientras una puerta está abierta por mantenimiento:

automation:
  - alias: Snooze ProbeHarbor while door open
    trigger:
      - platform: state
        entity_id: cover.garage_door
        to: "open"
    action:
      - service: thermaltrace.snooze
        data:
          hours: 4