Receita de ponte MQTT

Mantenha o Mosquitto ou o MQTT do Home Assistant na sua rede local e espelhe as leituras no ProbeHarbor via HTTPS para alertas de congelamento e vazamento.

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

O ProbeHarbor não é um broker MQTT. Mantenha o Mosquitto, o ESPHome ou o MQTT do Home Assistant na sua rede local e espelhe os tópicos escolhidos via HTTPS, para que os SMS e e-mails de congelamento e vazamento da casa e o histórico fiquem na nuvem sem expor o broker.

Ponte rápida (curl)

Crie um dispositivo push em Dashboard → Devices, copie a chave de ingestão, mapeie as chaves JSON para combinar com o seu payload MQTT e então faça um 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}}'

A criação completa de dispositivos (push ou pull) está em Adicionar dispositivos push e pull. Formatos de payload e webhooks de alerta de saída: API de ingestão e webhooks de alerta.

rest_command do Home Assistant

Prefere entidades automáticas a partir de um link de compartilhamento? Use a integração oficial do HACS. Para espelhar apenas via 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

Importe mqtt-to-probeharbor.json, aponte os nós MQTT para o seu broker, defina PROBEHARBOR_INGEST_KEY e faça o deploy. Guia do produto: integração com Node-RED. Texto completo: documentação para desenvolvedores da ponte MQTT.

Relacionados

Perguntas frequentes

Tenho que abandonar o MQTT para usar o ProbeHarbor?
Não. Mantenha o Mosquitto/Home Assistant para as automações locais e faça POST HTTPS na ingestão para os alertas de congelamento/vazamento e o histórico do ProbeHarbor.

O que a ponte MQTT publica?
Ela converte os tópicos do broker em JSON de ingestão do ProbeHarbor (temperaturas, portas, vazamentos). Detalhes: probeharbor.dev/about/mqtt-bridge.

O TLS até o probeharbor.dev é obrigatório?
Sim, para a ingestão na nuvem. O MQTT local pode ficar na sua rede local; a ponte ou o dispositivo precisa fazer POST HTTPS para a sua URL de ingestão.