Receta de puente MQTT

Mantén Mosquitto o el MQTT de Home Assistant en tu LAN y replica las lecturas a ProbeHarbor por HTTPS para alertas de helada y fugas e historial.

Primer plano de cables Ethernet Cat-5e blancos con conectores RJ45
El JSON de las sondas suele salir de la LAN por Ethernet o por un relay cercano, no directamente a internet. Foto: DiscDepotDundee.co.uk. CC BY-SA 4.0

ProbeHarbor no es un broker MQTT. Mantén Mosquitto, ESPHome o el MQTT de Home Assistant en tu red local y replica los topics que elijas por HTTPS, para que los SMS y correos de congelación y fugas del hogar y el historial vivan en la nube sin exponer el broker.

Puente rápido (curl)

Crea un dispositivo push en Dashboard → Devices, copia la clave de ingesta, asigna las claves JSON para que coincidan con tu payload MQTT y luego haz un POST:

curl -X POST "https://probeharbor.dev/api/ingest/mqtt" \
  -H "Content-Type: application/json" \
  -H "X-Ingest-Key: YOUR_DEVICE_KEY" \
  -d '{"topic":"home/garage/temp","message":{"temp1":42.5,"humidity":38}}'

La creación completa de dispositivos (push o pull) se explica en Añadir dispositivos push y pull. Formatos de payload y webhooks de alertas salientes: API de ingesta y webhooks de alertas.

rest_command de Home Assistant

¿Prefieres entidades automáticas a partir de un enlace compartido? Usa la integración oficial de HACS. Para replicar solo MQTT:

# configuration.yaml
rest_command:
  probeharbor_ingest:
    url: "https://probeharbor.dev/api/ingest/mqtt"
    method: POST
    headers:
      Content-Type: application/json
      X-Ingest-Key: !secret probeharbor_ingest_key
    payload: >
      {"topic":"{{ trigger.topic }}","payload":{{ trigger.payload }}}
automation:
  - alias: ProbeHarbor MQTT bridge
    trigger:
      - platform: mqtt
        topic: home/garage/temp
    action:
      - service: rest_command.probeharbor_ingest

Node-RED

Importa mqtt-to-probeharbor.json, apunta los nodos MQTT a tu broker, define PROBEHARBOR_INGEST_KEY y despliega. Guía del producto: integración con Node-RED. Explicación ampliada: documentación para desarrolladores del puente MQTT.

Relacionado

Preguntas frecuentes

¿Tengo que abandonar MQTT para usar ProbeHarbor?
No. Mantén Mosquitto/Home Assistant para las automatizaciones locales y envía la ingesta por POST HTTPS para las alertas de congelación/fugas y el historial de ProbeHarbor.

¿Qué publica el puente MQTT?
Convierte los topics del broker en JSON de ingesta de ProbeHarbor (temperaturas, puertas, fugas). Detalles: probeharbor.dev/about/mqtt-bridge.

¿Se requiere TLS hacia probeharbor.dev?
Sí para la ingesta en la nube. MQTT puede quedarse en tu red local; el puente o el dispositivo debe hacer POST HTTPS a tu URL de ingesta.