Home Assistant en webhookbezorging

Een veilige ontvanger voorbereiden

Maak een Home Assistant-webhooktrigger die POST accepteert en gebruik een unieke, geheime webhook-ID. JSON-waarden zijn beschikbaar via trigger.json. Raadpleeg de officiële handleiding voor internettoegang. Gebruik inkomende meldingen niet om sloten of andere veiligheidsgevoelige acties te bedienen.

• Home Assistant: webhooktriggers en beveiliging

Bereikbaarheid is belangrijk

Kies in Dashpatch Home Assistant als kanaal en voer de volledige publieke HTTPS-webhook-URL in. Privé-LAN, localhost, link-local en onveilige bestemmingen worden geweigerd. Omleidingen worden niet gevolgd; gebruik de uiteindelijke ontvangende URL.

Een installatie die alleen binnen je thuisnetwerk bereikbaar is, kan deze verzoeken niet rechtstreeks ontvangen. Gebruik een bewust beveiligd publiek webhookendpoint; stel niet je hele installatie open alleen om notificaties te koppelen. Dashpatch voegt geen eigen autorisatieheaders of requesthandtekeningen toe. De geheime URL regelt toegang.

Het JSON-bericht lezen

Dashpatch verstuurt application/json met event, alert en call. Dit verkorte voorbeeld toont de veldnamen; echte meldingen bevatten ook region, localities en cap_codes. Behandel berichttekst als onvertrouwde gegevens, niet als opdrachten of HTML.

{
  "event": "dashpatch_alert",
  "alert": { "id": 42, "name": "Lokale brandweer", "notification_channel": "home_assistant" },
  "call": {
    "id": 123,
    "url": "https://dashpatch.example/message/123",
    "message": "Voorbeeldmelding",
    "flex_message": "Voorbeeld ruwe melding",
    "service": "brandweer",
    "priority": 1,
    "location": "Voorbeeldplaats",
    "created_at": "2026-10-26T12:00:00+00:00"
  }
}

Huidige grenzen en fouten

Home Assistant is het huidige JSON-webhookkanaal; er is geen aparte generieke editor voor eigen headers of payloadsjablonen. Een eigen ontvanger moet dit bestaande contract accepteren en door de controles voor publieke bestemmingen komen.

Stuur snel een succesvolle 2xx-respons terug. Een verzoek heeft een time-out van 12 seconden; een fout schakelt de notificatieregel momenteel uit. Controleer ontvangerlogs en regelstatus, herstel de oorzaak en activeer opnieuw. Laat de ontvanger dubbele gebeurtenissen verdragen, bijvoorbeeld met alert.id plus call.id.