Receitas para ESPHome e Shelly

Envie temperatura, umidade e sensor de porta do firmware ESPHome ou Shelly para a ingestão push do ProbeHarbor sem sketches Arduino personalizados.

Close de cabos Ethernet Cat-5e brancos com conectores RJ45
O JSON das sondas normalmente sai da rede local por Ethernet ou por um relay próximo, não direto pela internet pública. Foto: DiscDepotDundee.co.uk. CC BY-SA 4.0

Muitas garagens já usam módulos ESPHome ou Shelly para luzes, portas e climatização. Você não precisa de um sketch personalizado de Arduino para alimentar o ProbeHarbor. Faça POST do mesmo JSON tipado sensors[] que a API de ingestão aceita, a partir de qualquer cliente HTTPS na sua rede local.

Antes de escrever o YAML

  1. Crie um dispositivo push em Dashboard → Devices (um clique) e copie a URL de ingestão.
  2. Envie um POST de teste (curl ou firmware): as chaves são importadas automaticamente; renomeie depois, se quiser.
  3. Mantenha o Mosquitto local se preferir: veja a ponte MQTT ou a integração HACS para rodar os dois em paralelo.

Padrão no ESPHome

Ative o componente http_request, leia a sua sonda DHT/BME em um intervalo e faça POST de um corpo JSON com os tipos temperature e humidity. Guarde a URL de ingestão em secrets.yaml e nunca faça commit da chave do dispositivo.


        # 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 com o corpo em lambda: documentação para desenvolvedores · referência do payload em ingestão e webhooks.

Contato de porta Shelly

No Shelly Plus / Gen2, dispare um HTTP POST quando a entrada da porta da garagem mudar de estado. Use kind: door com bool: true quando aberta e false quando fechada. Mapeie a chave (por exemplo, garage_door) em Devices.


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

O que fazer com os dados de porta + temperatura

Combine um sensor de porta com os limites de congelamento em Dashboard → Alerts → Rules. Passo a passo: roteiro de porta da garagem + frio. Combine com o roteiro para ondas de frio para ter as etapas de resposta da casa.

Perguntas frequentes

Preciso parar de usar o MQTT do Home Assistant?
Não. Muitas casas usam os dois: o Mosquitto localmente para automações, mais a ingestão push via HTTPS para o SMS de congelamento e vazamento e o histórico do ProbeHarbor.

Quais modelos Shelly funcionam?
Qualquer Shelly capaz de enviar um HTTP POST (Plus / Gen2 com scripts ou ações de webhook). Mapeie a chave da porta em Dashboard → Devices depois do primeiro POST.