O alerta de congelamento que funciona mesmo com o Home Assistant fora do ar

O que ele acrescenta a uma instalação do Home Assistant

• Um alerta quando a casa fica em silêncio. Se as leituras pararem por um número definido de horas, o ProbeHarbor avisa você. Silêncio no inverno geralmente significa que a energia ou a internet caiu, e o aquecimento pode ter caído junto.
• Alertas que não dependem da sua rede. E-mail, push e apps de mensagens no plano gratuito; SMS no Pro. Os moradores da casa recebem os alertas sem precisar de acesso ao seu Home Assistant.
• Aviso antes de o frio chegar. Uma estimativa de tempo até o congelamento em todos os planos, avisos de congelamento pela previsão no Member e alertas do National Weather Service (EUA) no Pro.
• Nenhum hardware novo. Envie qualquer entidade de temperatura ou de vazamento do Home Assistant. Dois dispositivos são grátis.

Dois sentidos, use um ou os dois: envie entidades do Home Assistant para o ProbeHarbor e tenha alertas externos (o YAML é gerado com a sua chave em Dashboard → Devices quando você escolhe Home Assistant) e traga as sondas do ProbeHarbor para o Home Assistant como entidades com a integração HACS abaixo. Contexto: como configurar um alerta de congelamento no Home Assistant e o que acontece numa queda de energia.

Instalar pelo HACS

1. No Home Assistant: HACS → Integrations → ⋮ → Custom repositories
2. Adicione o repositório https://github.com/doodersrage/probeharbor-home-assistant (categoria: Integration)
3. Instale o ProbeHarbor e reinicie o Home Assistant
4. Settings → Devices & services → Add integration → ProbeHarbor
5. Crie um link de compartilhamento ao vivo em Dashboard → Share (o Free inclui um link ao vivo para a família; o Pro acrescenta histórico/métricas e links que nunca expiram) e cole o token de /share/YOUR_TOKEN

Passo a passo completo para desenvolvedores: guia do Home Assistant ↗ · As receitas manuais em YAML continuam funcionando se você preferir sensores REST ao HACS.

O que aparece no HA

• Sensores: temperatura, umidade, CO₂, pressão, PM2.5, VOC, nível, energia e sondas numéricas genéricas
• Sensores binários: estados de porta, alagamento/vazamento, movimento e energia
• Consulta periódica. Por padrão, o HACS consulta a cada 5 minutos (configurável de 60 a 3600 s). Isso basta para dashboards; para limites de congelamento e contatos molhados em que cada minuto conta, prefira a ingestão push nativa (ESP/Arduino → ProbeHarbor), para que os alertas disparem na leitura e não depois da próxima consulta do HA. Usar os dois em paralelo é normal: push para SMS de congelamento e vazamento, HACS para entidades locais.
• Serviços (webhook de entrada opcional + segredo em Dashboard → Share): thermaltrace.snooze, vacation, clear_snooze, clear_vacation, status
• Serviço de push (chave de ingestão opcional): thermaltrace.push com um dicionário JSON payload

Formatos JSON nativos (push e pull)

Além do caminho via link de compartilhamento do HACS, o ProbeHarbor detecta automaticamente o JSON que o seu HA talvez já emita, sem precisar de nenhum wrapper personalizado.

• Sensor REST do Home Assistant. Envie (POST) ou busque { "state": "65.3", "attributes": { "unit_of_measurement": "°F" } }; mapeie a chave de sonda state em Devices
• SenML (RFC 8428). Array JSON com unidades Cel / %RH; comum em gateways de IoT
• thermaltrace.push: sensors[] nativo a partir de automações (veja temperatura interna abaixo)
• Ponte MQTT: desembrulhe payloads MQTT da rede local via POST /api/ingest/mqtt

Exemplos ao vivo: HA REST · SenML · Guia de formatos de ingestão

Temperatura interna via Home Assistant

Tenha o contexto da casa ao lado das sondas em Overview e History. Dois caminhos: Nest OAuth no Pro (quando disponível) ou, como plano B, enviar qualquer entidade climate do HA: útil quando os cadastros de desenvolvedor da Ecobee estão fechados ou quando você usa outra marca de termostato.

Nest OAuth (Pro, preferido quando disponível)

No probeharbor.dev, residências Pro podem conectar o Nest em Dashboard → Temperature para ver temperatura interna, setpoint e modo do HVAC ao vivo ao lado das sondas do sótão/porão/oficina: os alertas de congelamento podem incluir esse contexto. O histórico guarda registros do termostato no mesmo cron de ~15 minutos dos outros coletores Pro.

• Comparação para usuários: ProbeHarbor vs Nest
• Operadores de instalações próprias que habilitam segredos OAuth: configuração de Nest & Ecobee para operadores

Plano B: envie a temperatura interna pelo Home Assistant

Os cadastros no programa de desenvolvedores da Ecobee costumam ficar fechados, então o Ecobee OAuth pode não estar disponível nem no Pro. Qualquer termostato que já esteja no HA (Ecobee, Nest via HA, climate.* genérico) ainda pode alimentar o ProbeHarbor: envie a temperatura interna com thermaltrace.push e depois escolha essa sonda como sua Indoor reference em Dashboard → Devices.

1. Exponha seu termostato no HA (por exemplo, climate.living_room).
2. A cada 15 minutos, chame thermaltrace.push com um sensor temperature (chave house_indoor).
3. No ProbeHarbor: Devices → Indoor reference: escolha esse 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

Também é útil para o Ecobee via HA quando o OAuth não está disponível: veja ProbeHarbor vs Ecobee. Notas detalhadas de payload (GitHub Pages): documentação para desenvolvedores ↗

Em paralelo com MQTT (o padrão mais comum)

O ProbeHarbor não é um broker MQTT. A maioria dos homelabbers mantém Mosquitto / ESPHome / HA MQTT na rede local e espelha tópicos selecionados por HTTPS quando quer alertas de congelamento e vazamento na nuvem, além de histórico.

• Receita de ponte MQTT → HTTPS POST /api/ingest/mqtt com a chave do seu dispositivo
• Fluxo do Node-RED para assinantes do Mosquitto
• ProbeHarbor vs MQTT auto-hospedado: quando alertas hospedados compensam mais do que manter sua própria infraestrutura

Alertas no Home Assistant

Os webhooks de saída do Pro disparam quando o ProbeHarbor envia um alerta de congelamento, vazamento ou de regra personalizada. Aponte a URL para o endpoint de webhook do seu HA ou importe o blueprint.

• Baixar o YAML do blueprint de webhook
• YAML de nomes de entidades para dispositivos push
• Guia do produto: Ingestão e webhooks
• Configure os tokens de saída e de entrada em Dashboard → Share

Verifique o X-Signature quando definir um segredo de assinatura de webhook no ProbeHarbor. O HA (ou qualquer receptor) deve rejeitar POSTs que falhem na verificação HMAC. O blueprint documenta o cabeçalho; detalhes no guia de ingestão e webhooks e nas perguntas frequentes abaixo.

Exemplo de automação

Silencie os alertas de congelamento e vazamento do ProbeHarbor enquanto uma porta fica aberta para manutenção:

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