Stap-voor-stap: Webhook in Home Assistant instellen

Wat is een webhook?

Een webhook is een manier om realtime informatie van MeldingsMonitor naar Home Assistant te sturen. Simpel gezegd: wanneer er een P2000 melding binnenkomt die aan jouw voorwaarden voldoet, stuurt MeldingsMonitor automatisch alle relevante gegevens naar een speciaal eindpunt (URL) in jouw Home Assistant. Home Assistant kan vervolgens direct reageren op deze informatie door jouw apparaten en diensten aan te sturen.

Stap-voor-stap: Webhook in Home Assistant instellen

Stap 1: Webhook automatisering aanmaken in Home Assistant

1. Open Home Assistant en log in met je account.

2. Ga naar Instellingen (tandwielpictogram onderin).

3. Kies voor Automatiseringen & Scenes.

4. Klik op '+ Een automatisering aanmaken':

   • Geef je automatisering een duidelijke naam, bijvoorbeeld "P2000 Melding Ontvangen".
   • Bij "Beschrijving" kun je optioneel extra informatie toevoegen.

5. Selecteer de trigger:

   • Klik op '+ Trigger toevoegen'.
   • Kies als trigger type: Webhook.
   • Je krijgt nu een unieke webhook-ID toegewezen, bijvoorbeeld "p2000_trigger_123abc".
   • Noteer deze webhook-ID, je hebt deze later nodig in MeldingsMonitor.

6. Stel een eenvoudige actie in om te testen:

   • Klik op '+ Actie toevoegen'.
   • Kies bijvoorbeeld voor 'Notificatie versturen aan apparaat' of 'Service aanroepen'.
   • Voor een testnotificatie, selecteer 'Notificatie' en kies je telefoon of tablet.
   • Vul bij bericht iets in zoals "P2000 melding ontvangen!".

7. Sla de automatisering op door rechtsonder op 'Opslaan' te klikken.

Stap 2: Bepaal de volledige webhook URL

De URL die je in MeldingsMonitor gaat gebruiken volgt dit patroon:

https://[jouw-home-assistant-url]/api/webhook/[webhook-id]

Voorbeeld:

• Als je Home Assistant draait op mijn-homeassistant.duckdns.org
• En je webhook-ID is p2000_trigger_123abc
• Dan is je volledige webhook URL: https://mijn-homeassistant.duckdns.org/api/webhook/p2000_trigger_123abc

Belangrijk! Voor een werkende webhook moet je Home Assistant bereikbaar zijn vanaf het internet. Je kunt dit regelen via:

• Nabu Casa Cloud (betaalde dienst, eenvoudigste optie)
• Port forwarding op je router (gratis, maar vereist netwerkconfiguratie)
• Reverse proxy zoals Nginx of Cloudflare Tunnel (geavanceerd)

Als je Nabu Casa gebruikt, zal je URL eindigen op ui.nabu.casa.

Stap-voor-stap: Webhook koppelen in MeldingsMonitor

Stap 1: Automatisering aanmaken in MeldingsMonitor

1. Log in op MeldingsMonitor en ga naar Automatiseringen.
2. Klik op 'Nieuwe Automatisering'.
3. Geef je automatisering een naam, bijvoorbeeld "Brandweer naar Home Assistant".
4. Voeg eventueel een beschrijving toe.

Stap 2: Stel voorwaarden in

1. Klik op 'Voorwaarde toevoegen'.
2. Kies de gewenste voorwaarden, bijvoorbeeld:
   • Capcode: Selecteer specifieke capcode van jouw brandweerkorps.

Stap 3: Webhook actie configureren

1. Klik op 'Actie toevoegen'.
2. Kies bij 'Actie type' voor 'Webhook'.
3. Vul de volgende gegevens in:
   • URL: Plak hier de volledige webhook URL die je in Stap 2 hebt gemaakt.
   • Test: Middels de test button kan je een test naar de Webhook sturen.

Stap 4: Activeren en testen

1. Zet de schakelaar 'Actief' aan.
2. Klik op 'Opslaan' om je automatisering op te slaan.
3. Gebruik de 'Test' knop om een testbericht naar je webhook te sturen.
4. Controleer in Home Assistant of je testnotificatie is ontvangen.