Recettes ESPHome et Shelly

Envoyez température, humidité et contact de porte depuis un firmware ESPHome ou Shelly vers l’ingestion push de ProbeHarbor, sans sketch Arduino sur mesure.

Gros plan de câbles Ethernet Cat-5e blancs avec connecteurs RJ45
Le JSON des sondes quitte généralement le LAN par Ethernet ou via un relais proche, pas directement par Internet. Photo : DiscDepotDundee.co.uk. CC BY-SA 4.0

Beaucoup de garages utilisent déjà des modules ESPHome ou Shelly pour l’éclairage, les portes et le climat. Pas besoin d’un sketch Arduino sur mesure pour alimenter ProbeHarbor : envoyez en POST le même JSON typé sensors[] que l’API d’ingestion accepte, depuis n’importe quel client HTTPS de votre réseau local.

Avant d’écrire le YAML

  1. Créez un appareil push dans Dashboard → Devices (un clic) et copiez l’URL d’ingestion.
  2. Envoyez un POST de test (curl ou firmware) : les clés sont importées automatiquement ; renommez-les ensuite si vous le souhaitez.
  3. Gardez Mosquitto en local si vous voulez : voir le pont MQTT ou l’intégration HACS pour faire tourner les deux en parallèle.

Modèle ESPHome

Activez le composant http_request, interrogez votre sonde DHT/BME à intervalle régulier et envoyez en POST un corps JSON avec les types temperature et humidity. Stockez l’URL d’ingestion dans secrets.yaml et ne commitez jamais la clé de l’appareil.


        # 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 complet avec corps en lambda : documentation développeur · référence du format dans ingestion et webhooks.

Contact de porte Shelly

Sur un Shelly Plus / Gen2, déclenchez un POST HTTP quand l’entrée de la porte de garage change d’état. Utilisez kind: door avec bool: true quand elle est ouverte et false quand elle est fermée. Associez la clé (par exemple garage_door) dans Devices.


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

Que faire des données porte + température

Combinez un capteur de porte et les seuils de gel avec Dashboard → Alerts → Rules. Pas à pas : guide porte de garage + froid. Associez-le au guide d’intervention en cas de vague de froid pour les étapes de réaction du foyer.

FAQ

Dois-je arrêter d’utiliser MQTT avec Home Assistant ?
Non. Beaucoup de foyers utilisent les deux : Mosquitto en local pour les automatisations, et l’ingestion push en HTTPS pour les SMS de gel et de fuite et l’historique de ProbeHarbor.

Quels modèles Shelly fonctionnent ?
Tout Shelly capable d’envoyer un HTTP POST (scripts Plus / Gen2 ou actions webhook). Associez la clé de porte dans Dashboard → Devices après le premier POST.