Question 1

Wat zijn automatiseringen?

Accepted Answer

## Wat zijn automatiseringen?

Automatiseringen zijn regels die je instelt om automatisch actie te ondernemen wanneer een specifieke P2000-melding binnenkomt. Je kunt hiermee webhooks triggeren, waardoor je koppelingen kunt maken met externe systemen.

### Hoe werkt het?

Een automatisering bestaat uit:

1. **Trigger** — De voorwaarde waarop de automatisering reageert (bijv. een specifieke capcode, discipline of trefwoord in de meldingtekst)
2. **Actie** — Wat er moet gebeuren wanneer de trigger afgaat (bijv. een webhook aanroepen)

### Voorbeeld

Stel, je wilt een notificatie ontvangen wanneer jouw kazerne wordt gealarmeerd:

1. Maak een nieuwe automatisering aan
2. Stel als trigger de capcode(s) van jouw kazerne in
3. Koppel als actie een webhook URL (bijv. naar je domotica-systeem of notificatieservice)
4. Wanneer er een melding binnenkomt met die capcode, wordt automatisch je webhook aangeroepen

### Limieten

Het aantal automatiseringen dat je kunt aanmaken hangt af van je abonnement:

| Plan | Max. automatiseringen |
|------|----------------------|
| Gratis | 0 |
| Basis | 5 |
| Plus | 5 |
| Expert | 10 |

Question 2

Wat zijn kazerneschermen?

Accepted Answer

## Kazerneschermen

Kazerneschermen zijn configureerbare informatiedisplays die je kunt weergeven op een TV of monitor in je kazerne. Ze tonen realtime informatie zoals P2000-meldingen, het dienstrooster, agenda-items en mededelingen.

### Wat tonen kazerneschermen?

Afhankelijk van je configuratie kunnen kazerneschermen het volgende tonen:

- **Live P2000-meldingen** — Recente meldingen voor jouw capcodes
- **Dienstrooster** — Wie is er vandaag dienst
- **Agenda** — Aankomende oefeningen en evenementen
- **Mededelingen** — Belangrijke berichten voor het team
- **Weer** — Actueel weer op de locatie

### Hoe werkt het?

1. Je configureert een kazernescherm in MeldingsMonitor
2. Elk scherm krijgt een unieke **toegangssleutel** (URL)
3. Open deze URL in een browser op je TV/monitor
4. Het scherm toont automatisch de geconfigureerde informatie
5. De informatie wordt realtime bijgewerkt

### Vereisten

- Een **Plus** of **Expert** abonnement
- Een TV of monitor met internettoegang
- Een apparaat om de browser te draaien (bijv. Raspberry Pi, Fire TV Stick, Chromecast)

### Aantal schermen

| Plan | Max. kazerneschermen |
|------|---------------------|
| Plus | 1 |
| Expert | 3 |

Question 3

Een post aanmaken en beheren

Accepted Answer

## Post aanmaken en beheren

Een "post" in MeldingsMonitor vertegenwoordigt je fysieke kazerne of hulpverleningspost.

### Post aanmaken

1. Ga naar **Kazernemanagement** → **Posten** in de zijbalk
2. Klik op **Post aanmaken**
3. Vul de gegevens in:
   - **Naam** — De naam van je kazerne (bijv. "Post Centrum")
   - **Locatie** — Het adres van de kazerne
   - **Beschrijving** — Optionele beschrijving

### Post beheren

Na het aanmaken kun je je post beheren via de volgende secties:

- **Algemeen** — Basisgegevens wijzigen
- **Postleden** — Leden toevoegen en beheren
- **Dienstrooster** — Diensten plannen
- **Agenda** — Oefeningen en evenementen
- **Mededelingen** — Berichten voor het team

### Limieten

| Plan | Max. posten |
|------|------------|
| Plus | 1 |
| Expert | 3 |

Question 4

Statistieken bekijken

Accepted Answer

## Statistieken

De statistiekenpagina biedt inzichten in meldingspatronen en trends.

### Beschikbare statistieken

- **Meldingen per dag/week/maand** — Hoeveel meldingen er in een bepaalde periode zijn
- **Verdeling per discipline** — Verhouding brandweer/ambulance/politie
- **Piekuren** — Op welke tijdstippen de meeste meldingen binnenkomen
- **Locatie-analyse** — In welke gebieden de meeste meldingen zijn

### Hoe gebruik je het?

1. Ga naar **Statistieken** in de zijbalk
2. Selecteer de gewenste periode en filters
3. Bekijk de grafieken en overzichten

### Tips

- Gebruik statistieken om oefenthema's te bepalen op basis van veelvoorkomende meldingen
- Vergelijk periodes om trends te ontdekken
- De statistieken zijn gebaseerd op alle P2000-meldingen in het systeem

Question 5

Philips Hue koppeling

Accepted Answer

## Philips Hue Koppeling

Met de Philips Hue koppeling kun je je slimme lampen laten reageren op P2000-meldingen. Denk aan rode lampen die aangaan bij een brandmelding, of blauwe lampen bij een ambulancemelding.

### Hoe werkt het?

De koppeling werkt via een automatisering met een webhook die communiceert met je Hue Bridge. Je hebt hiervoor een domotica-tussenlaag nodig (bijv. Home Assistant, Homey of IFTTT).

### Optie 1: Via Home Assistant

Zie het artikel **"Koppeling met Home Assistant"** voor de complete configuratie. In Home Assistant maak je een automation die:

1. Luistert naar de webhook van MeldingsMonitor
2. De Hue lampen aanstuurt via de Hue-integratie

### Optie 2: Via de Hue API direct

Als je de Hue Bridge direct wilt aansturen, heb je een tussenstap nodig:

1. **Hue Bridge API-key** — Genereer een API-key via je Hue Bridge
2. **Lokaal script** — Maak een klein script dat de webhook ontvangt en de Hue API aanroept
3. **Port forwarding** — Stel port forwarding in op je router (of gebruik een tunnel zoals ngrok)

### Voorbeeld: Hue laten knipperen bij een melding

```bash
# Voorbeeld: Hue lamp rood laten knipperen
curl -X PUT "http:///api//lights/1/state" \
  -d '{"on":true, "bri":254, "hue":0, "sat":254, "alert":"lselect"}'
```

### Voorbeeld scenario's

- **Brandmelding** → Lampen rood knipperen
- **Ambulance** → Lampen blauw knipperen
- **Alle meldingen** → Lampen kort wit flitsen

### Tips

- Gebruik de `alert` parameter (`lselect` = 15 seconden knipperen) voor tijdelijke notificaties
- Maak een apart Hue-profiel voor alarmering, zodat je de standaard verlichting niet verstoort
- Test eerst met één lamp voordat je een hele groep instelt

Question 6

Profiel en instellingen wijzigen

Accepted Answer

## Profiel en instellingen

### Profiel bewerken

1. Klik op je naam/avatar onderin de zijbalk
2. Klik op **Instellingen**
3. Hier kun je wijzigen:
   - **Naam** — Je weergavenaam
   - **E-mailadres** — Je inloggegevens
   - **Wachtwoord** — Wijzig je wachtwoord

### Donkere modus

MeldingsMonitor ondersteunt een donkere modus:

1. Klik op het zon/maan-icoon in de navigatiebalk
2. De donkere modus wordt direct toegepast
3. Je voorkeur wordt automatisch opgeslagen

### Account verwijderen

Als je je account wilt verwijderen:

1. Ga naar **Instellingen** → **Profiel**
2. Scroll naar beneden naar "Account verwijderen"
3. Bevestig de verwijdering

> **Let op:** Bij het verwijderen van je account worden al je gegevens permanent verwijderd, inclusief automatiseringen, opgeslagen meldingen en kazerne-instellingen.

Question 7

Wat is de MeldingsMonitor API?

Accepted Answer

## Wat is de MeldingsMonitor API?

De MeldingsMonitor API is een RESTful interface waarmee je programmatisch toegang krijgt tot P2000-meldingen, capcodes en voertuigen. De API is ontworpen voor ontwikkelaars die MeldingsMonitor-data willen integreren in eigen applicaties, dashboards of systemen.

### Wat kun je met de API?

- **Meldingen ophalen** — Haal P2000-meldingen op, filter op datum, discipline, stad, capcode en meer
- **Capcodes doorzoeken** — Zoek en bekijk capcodes met hun gekoppelde discipline en locatie
- **Voertuigen opvragen** — Haal voertuigdata op, filter op type of zoek op roepnaam
- **Webhooks instellen** — Ontvang automatisch notificaties bij nieuwe meldingen of wijzigingen via webhooks

### Wie kan de API gebruiken?

De API is beschikbaar voor gebruikers met een **Developer** of **Developer Pro** abonnement. Elk plan heeft eigen limieten voor het aantal requests, historische data en webhook-endpoints.

### Hoe begin ik?

1. Upgrade naar een Developer-abonnement via de abonnementenpagina
2. Ga naar **Instellingen** → **API** om een API-token aan te maken
3. Gebruik het token om requests te doen naar `https://meldingsmonitor.test/api/v1/`
4. Bekijk de [API-documentatie](/api/docs) voor alle endpoints en voorbeelden

### API-versioning

De API gebruikt versienummering in de URL (`/api/v1/`). Dit garandeert dat bestaande integraties blijven werken, zelfs als we nieuwe versies uitbrengen.

Question 8

Wat zijn capcodes?

Accepted Answer

## Wat zijn capcodes?

Capcodes (ook wel pagercode of capcode genoemd) zijn unieke identificatienummers die worden gebruikt in het P2000-alarmeringssysteem. Elke hulpverleningseenheid (brandweerwagen, ambulance, etc.) heeft een eigen capcode.

### Hoe werken capcodes?

Wanneer de meldkamer een eenheid alarmeert, wordt er een bericht gestuurd naar de bijbehorende capcode. Het P2000-systeem zendt dit bericht uit via zendmasten, waarna de pieper of het ontvangapparaat van de eenheid afgaat.

### Capcodes in MeldingsMonitor

In MeldingsMonitor kun je capcodes:

- **Bekijken** — Zoek naar capcodes en bekijk de gekoppelde eenheid
- **Volgen** — Gebruik capcodes in automatiseringen om notificaties te ontvangen
- **Voorstellen** — Ontbreekt er een capcode? Stel hem voor via het voorstelformulier

### Capcode structuur

Een capcode bestaat uit 7 cijfers, bijvoorbeeld `0120901`. De eerste cijfers geven vaak de veiligheidsregio en discipline aan.

### Capcodes bekijken

1. Ga naar **Capcodes** in de zijbalk
2. Gebruik de zoekbalk om te zoeken op capcode of eenheidsnaam
3. Klik op een capcode voor gedetailleerde informatie

Question 9

Een supportticket aanmaken

Accepted Answer

## Supportticket aanmaken

Heb je een vraag of probleem? Maak een supportticket aan en ons team helpt je zo snel mogelijk.

### Hoe maak ik een ticket aan?

1. Klik op **Contact** in de zijbalk
2. Vul het formulier in:
   - **Onderwerp** — Een korte omschrijving van je vraag/probleem
   - **Categorie** — Selecteer het juiste onderwerp
   - **Bericht** — Beschrijf je vraag of probleem zo duidelijk mogelijk
3. Klik op **Versturen**

### Mijn tickets bekijken

1. Klik op **Mijn tickets** in de zijbalk
2. Je ziet een overzicht van al je tickets
3. Klik op een ticket om de details en reacties te bekijken
4. Je kunt reageren op een ticket om aanvullende informatie te geven

### Reactietijden

- **Basis, Plus en Expert** abonnementen hebben recht op e-mail ondersteuning
- We streven ernaar om binnen 24 uur te reageren op werkdagen
- Urgente problemen worden met voorrang behandeld

### Tips voor een goed ticket

- Beschrijf het probleem zo specifiek mogelijk
- Vermeld welk abonnement je hebt
- Voeg eventueel screenshots toe
- Geef aan welke stappen je al hebt geprobeerd

### Reageren via e-mail

Wanneer we reageren op je ticket, ontvang je een e-mailnotificatie. Je kunt direct op deze e-mail antwoorden — je reactie wordt automatisch aan het ticket toegevoegd.

Question 10

Het live dashboard gebruiken

Accepted Answer

## Het Live Dashboard

Het live dashboard is de hoofdpagina van MeldingsMonitor. Hier zie je alle binnenkomende P2000-meldingen in realtime.

### Meldingen bekijken

Elke melding toont de volgende informatie:

- **Tijdstip** — Wanneer de melding is uitgezonden
- **Discipline** — Brandweer, ambulance, politie, etc.
- **Meldingtekst** — De originele P2000-meldingtekst
- **Locatie** — Gemeente en eventueel straatnaam
- **Eenheden** — Welke voertuigen/eenheden zijn gealarmeerd

### Filteren en zoeken

Bovenaan het dashboard vind je een zoekbalk waarmee je kunt filteren op:

- Meldingtekst
- Locatie
- Capcode
- Discipline

### Verversingssnelheid

De snelheid waarmee nieuwe meldingen verschijnen hangt af van je abonnement:

- **Gratis**: elke 5 seconden
- **Basis en hoger**: elke 1 seconde

### Melding opslaan

Klik op een melding om de details te bekijken. Vanuit het detailscherm kun je een melding opslaan voor later. Opgeslagen meldingen vind je terug onder **Mijn meldingen**.

Question 11

Wat is MeldingsMonitor?

Accepted Answer

## Wat is MeldingsMonitor?

MeldingsMonitor is een realtime P2000-monitoringsplatform voor hulpdiensten in Nederland. Het systeem ontvangt en toont meldingen van de brandweer, ambulance, politie en andere hulpdiensten direct wanneer ze worden uitgezonden via het P2000-netwerk.

### Wat kun je met MeldingsMonitor?

- **Live meldingen volgen** — Bekijk realtime alle P2000-meldingen op een overzichtelijk dashboard of op de kaart.
- **Capcodes beheren** — Koppel capcodes aan eenheden en locaties voor beter inzicht.
- **Automatiseringen instellen** — Ontvang notificaties via webhooks wanneer bepaalde meldingen binnenkomen.
- **Kazerneschermen** — Stel informatiedisplays samen voor op de kazerne.
- **Kazernemanagement** — Beheer je post, postleden, dienstrooster, agenda en mededelingen.
- **Statistieken** — Analyseer meldingspatronen en trends.

### Voor wie is het?

MeldingsMonitor is geschikt voor:

- Brandweerkazernes en vrijwillige brandweerkorpsen
- Ambulancediensten
- Particuliere hulpverleningsorganisaties
- P2000-enthousiastelingen

### Hoe begin ik?

1. Maak een gratis account aan via de registratiepagina
2. Verken de live meldingen op het dashboard
3. Voeg capcodes toe die relevant zijn voor jouw eenheid
4. Stel eventueel automatiseringen in voor notificaties
5. Bekijk de abonnementspagina voor uitgebreidere mogelijkheden

Question 12

Account aanmaken en inloggen

Accepted Answer

## Account aanmaken

Je kunt op twee manieren een account aanmaken:

### 1. Via e-mail registratie

1. Klik op **Account aanmaken** in de zijbalk
2. Vul je naam, e-mailadres en wachtwoord in
3. Bevestig je e-mailadres via de verificatiemail
4. Je account is nu actief

### 2. Via sociale login

Je kunt ook inloggen met je bestaande account van:

- **Google** — Klik op "Inloggen met Google"
- **GitHub** — Klik op "Inloggen met GitHub"

Bij sociale login wordt automatisch een account voor je aangemaakt als je er nog geen hebt.

### Inloggen

1. Klik op **Inloggen** in de zijbalk
2. Vul je e-mailadres en wachtwoord in, of gebruik sociale login
3. Je wordt doorgestuurd naar het dashboard

### Wachtwoord vergeten?

1. Klik op "Wachtwoord vergeten?" op het inlogscherm
2. Vul je e-mailadres in
3. Je ontvangt een e-mail met een link om je wachtwoord te resetten
4. Stel een nieuw wachtwoord in via de link

Question 13

Abonnement beheren en opzeggen

Accepted Answer

## Abonnement beheren

### Huidig abonnement bekijken

1. Ga naar **Mijn abonnement** in de zijbalk
2. Je ziet hier je huidige plan en de volgende factuurdatum

### Upgraden

1. Ga naar **Mijn abonnement**
2. Klik op **Upgraden** bij het gewenste plan
3. Voltooi de betaling
4. Je nieuwe functies zijn direct beschikbaar

### Downgraden of opzeggen

1. Ga naar **Mijn abonnement**
2. Klik op **Billing portal** om naar het Stripe klantportaal te gaan
3. Hier kun je:
   - Je abonnement downgraden
   - Je abonnement opzeggen
   - Je betaalmethode wijzigen

### Facturen

1. Ga naar **Mijn abonnement** → **Facturen**
2. Download je facturen als PDF

### Veelgestelde vragen over abonnementen

**Wat gebeurt er als ik opzeg?**
Je abonnement blijft actief tot het einde van de huidige factuurperiode. Daarna wordt je account automatisch teruggezertet naar het gratis plan.

**Kan ik weer upgraden na opzegging?**
Ja, je kunt op elk moment weer upgraden naar een betaald plan.

**Wat gebeurt er met mijn automatiseringen als ik downgrade?**
Bestaande automatiseringen worden gepauzeerd als je het maximum van je nieuwe plan overschrijdt. Je kunt ze niet bewerken totdat je binnen het limiet bent.

Question 14

API-tokens aanmaken en beheren

Accepted Answer

## API-tokens aanmaken en beheren

API-tokens worden gebruikt om je te authenticeren bij de MeldingsMonitor API. Elk token geeft toegang tot de API namens jouw account.

### Token aanmaken

1. Ga naar **Instellingen** → **API** (of klik op **API** in de zijbalk)
2. Klik op **Token aanmaken**
3. Geef het token een herkenbare naam (bijv. "Mijn Dashboard" of "Home Assistant")
4. Het token wordt eenmalig getoond — **kopieer het direct en sla het veilig op**

> **Let op:** Het token wordt slechts één keer getoond. Als je het kwijtraakt, moet je een nieuw token aanmaken.

### Token gebruiken

Stuur je token mee als `Authorization` header bij elk API-request:

```
Authorization: Bearer jouw-api-token-hier
```

### Voorbeeld met cURL

```bash
curl -H "Authorization: Bearer jouw-api-token" \
     https://meldingsmonitor.test/api/v1/incidents
```

### Token intrekken

Als een token gecompromitteerd is of niet meer nodig is:

1. Ga naar **Instellingen** → **API**
2. Klik op **Intrekken** naast het betreffende token
3. Het token is direct ongeldig

### Limieten

- Je kunt maximaal **5 tokens** per account aanmaken
- Elk token heeft dezelfde rechten en limieten als je abonnement
- Tokens verlopen niet automatisch, maar kunnen handmatig worden ingetrokken

### Veiligheid

- Deel je tokens **nooit** openbaar (bijv. in GitHub repositories)
- Gebruik per integratie een apart token, zodat je ze individueel kunt intrekken
- Roteer tokens periodiek voor extra veiligheid

Question 15

Postleden beheren

Accepted Answer

## Postleden beheren

Onder **Postleden** kun je de leden van je kazerne beheren.

### Lid toevoegen

1. Ga naar je post → **Postleden**
2. Klik op **Lid toevoegen**
3. Vul de gegevens in:
   - **Naam** — Naam van het lid
   - **Functie** — Selecteer de functie (bijv. Bevelvoerder, Manschap, Chauffeur)
   - **Contact** — Optioneel telefoonnummer of e-mailadres

### Functies

Functies zijn de rollen die leden kunnen vervullen:

- Bevelvoerder
- Manschap
- Chauffeur
- OvD (Officier van Dienst)
- Ploegchef
- Aangepaste functies

### Lid bewerken of verwijderen

Klik op een lid in de lijst om de gegevens te bewerken of het lid te verwijderen.

Question 16

Veelgestelde vragen

Accepted Answer

## Veelgestelde vragen

### Is MeldingsMonitor gratis?

Ja, de basisfunctionaliteit is gratis. Voor geavanceerde functies zoals automatiseringen, kazerneschermen en snellere verversing heb je een betaald abonnement nodig.

### Hoe actueel zijn de meldingen?

Meldingen worden vrijwel direct getoond nadat ze zijn uitgezonden via het P2000-netwerk. De verversingssnelheid van je dashboard hangt af van je abonnement (1 of 5 seconden).

### Werkt MeldingsMonitor ook op mobiel?

Ja, de website is volledig responsief en werkt goed op smartphones en tablets.

### Kan ik MeldingsMonitor gebruiken voor meerdere kazernes?

Ja, met het Expert-abonnement kun je tot 3 posten aanmaken en beheren.

### Zijn mijn gegevens veilig?

Ja. We gebruiken versleutelde verbindingen (HTTPS), veilige betalingsverwerking via Stripe, en slaan geen gevoelige betalingsgegevens op.

### Hoe annuleer ik mijn abonnement?

Ga naar **Mijn abonnement** en klik op de Stripe billing portal. Daar kun je je abonnement opzeggen.

### Kan ik een factuur ontvangen?

Ja, facturen zijn beschikbaar via **Mijn abonnement** → **Facturen**. Deze worden automatisch gegenereerd door Stripe.

### Ik krijg geen webhooks binnen, wat nu?

Controleer:
1. Is je webhook-URL correct en bereikbaar via het internet?
2. Ondersteunt je server HTTPS?
3. Retourneert je server een HTTP 200 response?
4. Is je automatisering actief (niet gepauzeerd)?

Als het probleem aanhoudt, maak dan een supportticket aan.

### Kan ik bijdragen aan de capcode-database?

Ja! Als je een capcode mist of onjuiste informatie ziet, kun je een voorstel indienen. Ga naar de capcode-pagina en klik op "Voorstel indienen". Ons team beoordeelt elk voorstel.

### Hoe kan ik de API gebruiken?

Je hebt een **Developer** of **Developer Pro** abonnement nodig. Ga naar **Instellingen** → **API** om een API-token aan te maken. Bekijk de volledige documentatie op [/api/docs](/api/docs).

### Wat zijn API-webhooks?

Met webhooks ontvang je automatisch een HTTP POST-request wanneer er een nieuwe melding binnenkomt of wanneer er wijzigingen zijn bij voertuigen of capcodes. Dit is ideaal om eigen systemen real-time te koppelen aan MeldingsMonitor.

### Wat zijn de API rate limits?

De limieten hangen af van je plan. Het Developer-plan biedt 30 requests/minuut en 5.000/dag. Het Developer Pro-plan biedt 60 requests/minuut en 25.000/dag. Bekijk de volledige limieten in de API-documentatie.

### Kan ik de API gebruiken voor commerciële doeleinden?

Ja, mits je je houdt aan de [API-voorwaarden](/api/voorwaarden). Het is niet toegestaan om de volledige database te kopiëren of een concurrerende dienst op te zetten. Raadpleeg de voorwaarden voor alle details.

### Waar vind ik de API-documentatie?

De volledige API-documentatie is beschikbaar op [/api/docs](/api/docs). Hier vind je alle endpoints, filters, voorbeelden en informatie over webhooks en authenticatie.

### Hoe kan ik contact opnemen?

- Via een supportticket (aangeraden voor de snelste hulp)
- Via de contactpagina op de website

Question 17

Kazernescherm instellen

Accepted Answer

## Kazernescherm instellen

### Stap 1: Ga naar Kazerneschermen

1. Klik op **Kazernemanagement** in de zijbalk
2. Klik op **Kazerneschermen**
3. Klik op **Scherm aanmaken**

### Stap 2: Configureer het scherm

- **Naam** — Geef het scherm een herkenbare naam (bijv. "Wacht TV" of "Instructieruimte")
- **Post** — Koppel het scherm aan een post (optioneel, voor dienstrooster en agenda)
- **Capcodes** — Selecteer welke capcodes worden weergegeven
- **Layout** — Kies de indeling van het scherm

### Stap 3: Activeer het scherm

Na het opslaan ontvang je een unieke **toegangslink**. Deze link open je in een browser op het apparaat dat op de TV/monitor is aangesloten.

### Het scherm weergeven

**Optie 1: Raspberry Pi (aanbevolen)**

Een Raspberry Pi is ideaal als dedicated schermapparaat:

1. Installeer Raspberry Pi OS Lite
2. Installeer Chromium browser
3. Stel de Pi in om bij het opstarten automatisch de scherm-URL te openen in kioskmodus

**Optie 2: Fire TV Stick**

1. Installeer de Silk Browser op je Fire TV Stick
2. Open de scherm-URL
3. Schakel over naar volledig scherm

**Optie 3: Directe browser**

Open de scherm-URL in een willekeurige browser op volledig scherm (F11).

### Tips

- Het scherm vereist geen inloggegevens — de toegangslink is voldoende
- Deel de toegangslink niet openbaar
- Het scherm werkt het beste in Chrome of Chromium
- Zet de monitor aan/uit met een slim stopcontact voor energiebesparing

Question 18

Koppeling met Home Assistant

Accepted Answer

## Koppeling met Home Assistant

Home Assistant is een populair open-source domotica-platform. Met de webhook-functie van MeldingsMonitor kun je P2000-meldingen ontvangen in Home Assistant en daar allerlei acties aan koppelen.

### Stap 1: Webhook-trigger instellen in Home Assistant

Maak een nieuwe automation in Home Assistant met een webhook-trigger:

```yaml
automation:
  - alias: "P2000 Melding Ontvangen"
    trigger:
      - platform: webhook
        webhook_id: "meldingsmonitor-p2000"
        allowed_methods:
          - POST
        local_only: false
    action:
      - service: notify.mobile_app_jouw_telefoon
        data:
          title: "P2000 Melding"
          message: "{{ trigger.json.message }}"
          data:
            priority: high
```

### Stap 2: Webhook URL verkrijgen

Je webhook URL wordt:

```
https://jouw-home-assistant.duckdns.org/api/webhook/meldingsmonitor-p2000
```

> **Belangrijk:** Je Home Assistant moet bereikbaar zijn via het internet. Gebruik hiervoor Nabu Casa, DuckDNS, of een andere oplossing.

### Stap 3: Automatisering instellen in MeldingsMonitor

1. Ga naar **Automatiseringen** in MeldingsMonitor
2. Maak een nieuwe automatisering aan
3. Stel je triggers in (capcodes, discipline, trefwoorden)
4. Plak de webhook URL van Home Assistant
5. Sla op

### Geavanceerde voorbeelden

#### Hue-lampen aansturen bij melding

```yaml
automation:
  - alias: "P2000 Hue Alarm"
    trigger:
      - platform: webhook
        webhook_id: "meldingsmonitor-p2000"
    condition:
      - condition: template
        value_template: "{{ trigger.json.discipline == 'brandweer' }}"
    action:
      - service: light.turn_on
        target:
          entity_id: light.woonkamer
        data:
          color_name: red
          brightness: 255
          flash: long
      - delay: "00:00:30"
      - service: light.turn_off
        target:
          entity_id: light.woonkamer
```

#### Tekst-to-speech bij melding

```yaml
action:
  - service: tts.google_translate_say
    target:
      entity_id: media_player.woonkamer_speaker
    data:
      message: "Nieuwe P2000 melding: {{ trigger.json.message }}"
```

### Beschikbare data in templates

In Home Assistant kun je de volgende velden gebruiken in templates:

- `trigger.json.incident_id` — Melding ID
- `trigger.json.message` — Meldingtekst
- `trigger.json.capcodes` — Lijst van capcodes
- `trigger.json.discipline` — Discipline
- `trigger.json.location` — Locatie
- `trigger.json.created_at` — Tijdstip

Question 19

Automatisering aanmaken

Accepted Answer

## Automatisering aanmaken

### Stap 1: Ga naar Automatiseringen

Klik op **Automatiseringen** in de zijbalk en klik vervolgens op **Automatisering aanmaken**.

### Stap 2: Configureer de trigger

Stel in wanneer de automatisering moet afgaan:

- **Capcodes** — Selecteer een of meer capcodes waarvoor je een notificatie wilt ontvangen
- **Trefwoorden** — Filter op trefwoorden in de meldingtekst (optioneel)
- **Discipline** — Filter op discipline (brandweer, ambulance, etc.)

### Stap 3: Configureer de actie

Stel de webhook-URL in waarnaar de melding moet worden gestuurd:

- **Webhook URL** — De URL die wordt aangeroepen wanneer de trigger afgaat
- **HTTP-methode** — Standaard POST

### Stap 4: Opslaan

Klik op **Opslaan** om de automatisering te activeren. De automatisering is direct actief.

### Webhook payload

Wanneer een automatisering triggert, wordt er een POST-request gestuurd naar je webhook URL met de volgende JSON-payload:

```json
{
  "incident_id": 12345,
  "message": "P 1 BRT-01 Brandmelding industrie Hoofdstraat 1 Gemeente",
  "capcodes": ["0120901", "0120902"],
  "discipline": "brandweer",
  "location": "Hoofdstraat 1, Gemeente",
  "created_at": "2026-02-13T10:30:00Z"
}
```

### Automatisering testen

Na het opslaan kun je de automatisering testen. Je ontvangt dan een testmelding op je webhook URL om te controleren of alles correct werkt.

Question 20

Voertuigen en eenheden

Accepted Answer

## Voertuigen en Eenheden

In MeldingsMonitor kun je alle geregistreerde hulpverleningsvoertuigen bekijken.

### Voertuigen doorzoeken

1. Ga naar **Voertuigen** in de zijbalk
2. Zoek op roepnaam (call sign), bijv. "AB 13-1"
3. Klik op een voertuig voor detailinformatie

### Informatie per voertuig

Voor elk voertuig kun je het volgende zien:

- **Roepnaam** — De unieke aanduiding (call sign)
- **Type** — Het soort voertuig (tankautospuit, ambulance, etc.)
- **Kazerne** — De thuiskazerne van het voertuig
- **Capcode(s)** — De gekoppelde capcodes
- **Laatste meldingen** — Recente meldingen waarbij dit voertuig betrokken was

Question 21

De live kaart gebruiken

Accepted Answer

## De Live Kaart

De live kaart toont alle actieve P2000-meldingen op een interactieve kaart van Nederland.

### Navigatie

- **Zoomen** — Gebruik het scrollwiel of de +/- knoppen
- **Verplaatsen** — Klik en sleep de kaart
- **Melding bekijken** — Klik op een marker voor details

### Markeringen

Elke melding wordt getoond met een marker op de kaart:

- De kleur geeft de discipline aan (rood = brandweer, geel = ambulance, blauw = politie)
- Klik op een marker om de meldingsdetails te zien

### De kaart is beschikbaar voor iedereen

De live kaart is een publiek beschikbare functie. Je hebt geen account nodig om de kaart te gebruiken.

Question 22

Koppeling met Homey

Accepted Answer

## Koppeling met Homey

Homey van Athom is een populaire domotica-hub in Nederland. Je kunt MeldingsMonitor webhooks koppelen aan Homey om slimme acties uit te voeren bij P2000-meldingen.

### Via de Webhooks-app

1. Installeer de **Webhooks** app uit de Homey App Store
2. Maak een nieuwe webhook-trigger aan in de app
3. Kopieer de webhook URL die de app genereert

### Stap voor stap

#### 1. Homey Webhooks app instellen

- Open de Homey app op je telefoon
- Ga naar **Apps** → zoek naar **Webhooks**
- Installeer de app en open de instellingen
- Maak een nieuwe webhook aan en kopieer de URL

#### 2. MeldingsMonitor automatisering

- Ga naar **Automatiseringen** in MeldingsMonitor
- Maak een nieuwe automatisering met je gewenste triggers
- Plak de Homey webhook URL als actie-URL
- Sla de automatisering op

#### 3. Homey Flow maken

Maak een Flow in Homey:

- **Als** → Webhook ontvangen (Webhooks app)
- **Dan** → Kies je actie, bijvoorbeeld:
  - Hue lamp rood knipperen
  - Sonos spreker: melding voorlezen
  - Pushbericht naar je telefoon
  - Sirene activeren

### Voorbeeld Flow

```
ALS: Webhook ontvangen van "meldingsmonitor"
DAN: Zeg op Sonos "Nieuwe P2000 melding ontvangen"
EN: Zet Hue lamp Woonkamer op rood
EN: Wacht 30 seconden
DAN: Zet Hue lamp Woonkamer terug naar normaal
```

### Tips

- De Homey Pro heeft betere webhook-ondersteuning dan de Homey (standaard)
- Gebruik de Advanced Flow editor voor complexe scenario's
- Test je Flow met een testmelding vanuit MeldingsMonitor

Question 23

Dienstrooster instellen

Accepted Answer

## Dienstrooster instellen

Met het dienstrooster kun je inzichtelijk maken wie er op welk moment dienst heeft.

### Rooster aanmaken

1. Ga naar je post → **Dienstrooster**
2. Configureer de diensten en wijs leden toe

### Rotatiesysteem

Het dienstrooster ondersteunt automatische rotatie:

- **Ploegen** — Verdeel leden in ploegen
- **Rotatieslots** — Stel de rotatie in (bijv. wekelijks, tweewekelijks)
- **Overrides** — Handmatig aanpassen voor uitzonderingen (bijv. ziekte, verlof)

### Weergave

Het dienstrooster wordt automatisch getoond op:

- De kazernescherm display (als deze gekoppeld is aan je post)
- De dienstroosterpagina in het kazernemanagement

### Tips

- Stel ploegen samen met een goede mix van functies
- Gebruik overrides voor incidentele wijzigingen
- Het rooster wordt automatisch doorgerekend op basis van je rotatie-instellingen

Question 24

Webhook-URL instellen

Accepted Answer

## Webhook-URL instellen

Een webhook is een manier om automatisch data te versturen naar een extern systeem wanneer er een gebeurtenis plaatsvindt.

### Wat is een webhook?

Een webhook is simpelweg een URL (webadres) dat je opgeeft. Wanneer jouw automatisering triggert, stuurt MeldingsMonitor een HTTP POST-request met de meldingsdata naar die URL.

### Vereisten voor je webhook-URL

- De URL moet **publiek bereikbaar** zijn via het internet
- De URL moet een **HTTPS** verbinding ondersteunen (aanbevolen)
- Je server moet een **HTTP 200** response terugsturen om succesvolle ontvangst te bevestigen

### Webhook payload

De webhook stuurt een JSON-body met de volgende velden:

| Veld | Type | Beschrijving |
|------|------|-------------|
| `incident_id` | integer | Uniek ID van de melding |
| `message` | string | Volledige meldingtekst |
| `capcodes` | array | Lijst van gealarmeerde capcodes |
| `discipline` | string | Discipline (brandweer, ambulance, etc.) |
| `location` | string | Locatie van de melding |
| `created_at` | string | Tijdstip van de melding (ISO 8601) |

### Headers

Elke webhook-aanroep bevat de volgende headers:

```
Content-Type: application/json
User-Agent: MeldingsMonitor-Webhook/1.0
```

### Foutafhandeling

Als je webhook-URL niet bereikbaar is of een fout teruggeeft, probeert MeldingsMonitor het verzoek opnieuw. Na meerdere mislukte pogingen wordt de automatisering tijdelijk gepauzeerd.

Question 25

Mijn meldingen en opgeslagen meldingen

Accepted Answer

## Mijn Meldingen

Met de functie "Mijn meldingen" kun je belangrijke meldingen opslaan voor later.

### Melding opslaan

1. Klik op een melding in het live dashboard
2. In het detailvenster, klik op de **Opslaan** knop
3. De melding wordt toegevoegd aan je opgeslagen meldingen

### Opgeslagen meldingen bekijken

1. Ga naar **Mijn meldingen** in de zijbalk
2. Hier vind je een overzicht van al je opgeslagen meldingen
3. Klik op een melding om de details te bekijken

### Melding verwijderen

Je kunt een opgeslagen melding verwijderen door op de verwijder-knop te klikken in het overzicht.

> **Let op:** Je hebt een account nodig om meldingen op te slaan. Deze functie is beschikbaar voor alle ingelogde gebruikers.

Question 26

API-webhooks instellen

Accepted Answer

## API-webhooks instellen

Met API-webhooks ontvang je automatisch een HTTP POST-request wanneer er nieuwe meldingen binnenkomen of wanneer voertuigen of capcodes worden gewijzigd.

### Beschikbare events

| Event | Beschrijving |
|-------|-------------|
| `incident.created` | Nieuwe P2000-melding ontvangen |
| `incident.updated` | Bestaande melding bijgewerkt |
| `vehicle.updated` | Voertuiggegevens gewijzigd |
| `capcode.updated` | Capcodegegevens gewijzigd |

### Webhook aanmaken via de website

1. Ga naar **Instellingen** → **API**
2. Scroll naar het **Webhooks** gedeelte
3. Klik op **Webhook toevoegen**
4. Vul de URL in waarnaar de notificaties moeten worden gestuurd
5. Selecteer de events waarvoor je notificaties wilt ontvangen
6. Klik op **Opslaan**
7. Noteer het **webhook-secret** dat wordt getoond — dit heb je nodig om de handtekening te verifiëren

### Webhook aanmaken via de API

Je kunt webhooks ook programmatisch beheren via de API:

```bash
curl -X POST https://meldingsmonitor.test/api/v1/webhooks \
  -H "Authorization: Bearer jouw-api-token" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://jouw-server.nl/webhook",
    "events": ["incident.created", "incident.updated"]
  }'
```

### Webhook payload

Bij elk event ontvang je een JSON-payload:

```json
{
  "event": "incident.created",
  "data": {
    "id": 12345,
    "occurred_at": "2026-02-13T10:30:00+00:00",
    "message": "P 1 BRT-01 Brandmelding industrie Hoofdstraat 1 Gemeente",
    "priority": "1",
    "city": "Amsterdam",
    "latitude": 52.3676,
    "longitude": 4.9041
  },
  "timestamp": "2026-02-13T10:30:05+00:00"
}
```

### Handtekening verifiëren

Elke webhook bevat een `X-Webhook-Signature` header met een HMAC-SHA256 handtekening. Verifieer deze met je webhook-secret:

```php
$signature = hash_hmac('sha256', $requestBody, $webhookSecret);
$isValid = hash_equals($signature, $receivedSignature);
```

### Foutafhandeling en retries

- Als je server een niet-2xx statuscode teruggeeft, wordt het verzoek opnieuw geprobeerd
- Retries gebeuren met exponentiële backoff (10s, 30s, 60s)
- Na 10 mislukte pogingen wordt de webhook automatisch gedeactiveerd
- Je kunt een gedeactiveerde webhook weer activeren via de instellingen

### Limieten

Het aantal webhook-endpoints dat je kunt aanmaken hangt af van je abonnement:

| Plan | Max. webhook-endpoints |
|------|----------------------|
| Developer | 3 |
| Developer Pro | 10 |

Question 27

Abonnementen en prijzen

Accepted Answer

## Abonnementen

MeldingsMonitor biedt verschillende abonnementen die passen bij jouw behoefte:

### Gratis

- Toegang tot het live meldingen dashboard
- Live kaart met meldingen
- Capcodes bekijken
- Verversingssnelheid: 5 seconden

### Basis (€5,00/mnd)

- Alles van Gratis, plus:
- Verversingssnelheid: 1 seconde
- 5 automatiseringen instellen
- E-mail ondersteuning

### Plus (€7,50/mnd)

- Alles van Basis, plus:
- 1 Kazernescherm configureren
- 1 Post/kazerne aanmaken en beheren

### Expert (€10,00/mnd)

- Alles van Plus, plus:
- 10 automatiseringen
- 3 Kazerneschermen
- 3 Posten/kazernes

### Developer (€25,00/mnd)

- 5 automatiseringen
- **Volledige API-toegang**
- 30 requests/minuut, 5.000 requests/dag
- 30 dagen historische data
- 3 webhook-endpoints
- Ideaal voor eigen integraties en dashboards

### Developer Pro (€50,00/mnd)

- 10 automatiseringen
- **Volledige API-toegang**
- 60 requests/minuut, 25.000 requests/dag
- 90 dagen historische data
- 10 webhook-endpoints
- Voor professioneel gebruik en hoge volumes

### Hoe wijzig ik mijn abonnement?

1. Ga naar **Mijn abonnement** in de zijbalk
2. Bekijk de beschikbare plannen
3. Klik op **Upgraden** bij het gewenste plan
4. Voltooi de betaling via Stripe
5. Je nieuwe abonnement is direct actief

### Betaling

We werken met Stripe voor veilige betalingsverwerking. Je kunt betalen met:

- iDEAL
- Creditcard (Visa, Mastercard, American Express)
- Bancontact

Facturen zijn beschikbaar via de factuurpagina in je account.

Question 28

Koppeling met IFTTT

Accepted Answer

## Koppeling met IFTTT

IFTTT (If This Then That) is een populaire automatiseringsservice waarmee je duizenden apps en apparaten met elkaar kunt verbinden. Door MeldingsMonitor te koppelen via webhooks, kun je P2000-meldingen gebruiken als trigger voor IFTTT-acties.

### Stap 1: IFTTT Webhooks inschakelen

1. Ga naar [ifttt.com](https://ifttt.com) en log in
2. Zoek naar de **Webhooks** service
3. Klik op **Connect**
4. Ga naar **Webhooks Settings** en noteer je **webhook key**

### Stap 2: Je webhook URL samenstellen

Je IFTTT webhook URL ziet er als volgt uit:

```
https://maker.ifttt.com/trigger/{event_name}/json/with/key/{your_key}
```

Vervang:
- `{event_name}` door een naam naar keuze, bijv. `p2000_melding`
- `{your_key}` door je IFTTT webhook key

### Stap 3: Applet maken in IFTTT

1. Maak een nieuwe Applet (**Create**)
2. **If This**: kies **Webhooks** → **Receive a web request with a JSON payload**
3. Event name: `p2000_melding`
4. **Then That**: kies je gewenste actie, bijvoorbeeld:
   - **Notifications** — Pushbericht op je telefoon
   - **Philips Hue** — Lampen aansturen
   - **Google Sheets** — Meldingen loggen in een spreadsheet
   - **Email** — E-mail versturen
   - **Telegram** — Bericht in een Telegram groep

### Stap 4: Koppel in MeldingsMonitor

1. Ga naar **Automatiseringen** in MeldingsMonitor
2. Maak een nieuwe automatisering
3. Plak je IFTTT webhook URL
4. Sla op

### Populaire IFTTT-acties

| Actie | Beschrijving |
|-------|-------------|
| Pushbericht | Ontvang een notificatie op je telefoon |
| Philips Hue | Lampen laten knipperen bij een melding |
| Google Sheets | Log alle meldingen in een spreadsheet |
| Telegram | Bericht naar een Telegram-kanaal |
| SMS | Verstuur een SMS bij belangrijke meldingen |

### Beperkingen

- IFTTT gratis accounts zijn beperkt tot 2 Applets
- De Pro-versie biedt meer mogelijkheden en snellere verwerking
- Er kan een kleine vertraging zitten tussen trigger en actie (1-15 seconden)

Question 29

Agenda en mededelingen

Accepted Answer

## Agenda

De agenda-functie stelt je in staat om oefeningen, vergaderingen en andere evenementen te plannen.

### Item toevoegen

1. Ga naar je post → **Agenda**
2. Klik op **Item toevoegen**
3. Vul in:
   - **Titel** — Naam van het evenement
   - **Datum en tijd** — Wanneer het plaatsvindt
   - **Locatie** — Waar het plaatsvindt
   - **Beschrijving** — Eventuele details

### Weergave

Agenda-items worden getoond op:

- De agendapagina in het kazernemanagement
- Het kazernescherm (als geconfigureerd)

---

## Mededelingen

Met mededelingen kun je belangrijke berichten delen met je team.

### Mededeling plaatsen

1. Ga naar je post → **Mededelingen**
2. Klik op **Mededeling plaatsen**
3. Vul de titel en het bericht in
4. De mededeling is direct zichtbaar

### Weergave

Mededelingen worden getoond op:

- De mededelingenpagina in het kazernemanagement
- Het kazernescherm (als geconfigureerd)

### Tips

- Gebruik mededelingen voor tijdsgevoelige informatie
- Verouderde mededelingen kun je archiveren of verwijderen
- Mededelingen worden in volgorde van nieuw naar oud getoond

Question 30

API rate limits en limieten

Accepted Answer

## API rate limits en limieten

Om de API snel en betrouwbaar te houden voor iedereen, hanteren we rate limits per abonnement.

### Limieten per plan

| Limiet | Developer | Developer Pro |
|--------|-----------|--------------|
| Requests per minuut | 30 | 60 |
| Requests per dag | 5.000 | 25.000 |
| Max. resultaten per pagina | 50 | 100 |
| Historische data | 30 dagen | 90 dagen |
| Webhook-endpoints | 3 | 10 |

### Rate limit headers

Bij elke API-response ontvang je headers die aangeven hoeveel requests je nog kunt doen:

```
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 28
X-RateLimit-Reset: 1707820800
```

### Wat gebeurt er bij overschrijding?

Als je het limiet bereikt, ontvang je een `429 Too Many Requests` response:

```json
{
  "message": "Too Many Attempts.",
  "retry_after": 42
}
```

Wacht het aangegeven aantal seconden (`retry_after`) voordat je een nieuw verzoek doet.

### Historische data beperking

Je kunt alleen meldingen ophalen binnen de historische periode van je plan. Als je een `date_from` parameter opgeeft die ouder is dan toegestaan, ontvang je een `422` fout met de vroegst toegestane datum.

### Paginering

De API gebruikt cursor-based paginering voor efficiënte navigatie door grote datasets:

```bash
# Eerste pagina
curl -H "Authorization: Bearer token" \
     "https://meldingsmonitor.test/api/v1/incidents?per_page=25"

# Volgende pagina (gebruik de cursor uit de response)
curl -H "Authorization: Bearer token" \
     "https://meldingsmonitor.test/api/v1/incidents?cursor=abc123&per_page=25"
```

### Tips voor efficiënt API-gebruik

- Gebruik filters om alleen relevante data op te halen
- Cache responses waar mogelijk
- Gebruik webhooks in plaats van polling voor real-time notificaties
- Houd je requests per minuut in de gaten via de rate limit headers

Question 31

Koppeling met Zapier

Accepted Answer

## Koppeling met Zapier

Zapier is een krachtige automatiseringsplatform waarmee je MeldingsMonitor kunt koppelen aan duizenden andere apps en diensten.

### Stap 1: Zapier Webhook instellen

1. Ga naar [zapier.com](https://zapier.com) en log in
2. Klik op **Create Zap**
3. Kies als trigger: **Webhooks by Zapier**
4. Selecteer **Catch Hook**
5. Kopieer de webhook URL die Zapier genereert

### Stap 2: MeldingsMonitor koppelen

1. Ga naar **Automatiseringen** in MeldingsMonitor
2. Maak een nieuwe automatisering aan met je gewenste triggers
3. Plak de Zapier webhook URL als actie-URL
4. Sla op en verstuur een testmelding

### Stap 3: Actie kiezen in Zapier

Nadat Zapier de test-webhook heeft ontvangen, kun je een actie kiezen:

- **Slack** — Bericht in een Slack-kanaal
- **Microsoft Teams** — Bericht in een Teams-kanaal
- **Notion** — Melding loggen in een Notion-database
- **Airtable** — Melding opslaan in een Airtable-base
- **Twilio** — SMS of telefoongesprek bij een melding
- **Discord** — Bericht in een Discord-kanaal
- **Email** — E-mail versturen

### Voorbeeld: Slack-notificatie

1. Trigger: Webhooks by Zapier → Catch Hook
2. Action: Slack → Send Channel Message
3. Configureer het bericht:
   - Channel: `#p2000-meldingen`
   - Message: `Nieuwe melding: {{message}} - Locatie: {{location}}`

### Voorbeeld: Meldingen loggen in Google Sheets

1. Trigger: Webhooks by Zapier → Catch Hook
2. Action: Google Sheets → Create Spreadsheet Row
3. Map de velden:
   - Kolom A: `{{created_at}}` (Tijdstip)
   - Kolom B: `{{discipline}}` (Discipline)
   - Kolom C: `{{message}}` (Melding)
   - Kolom D: `{{location}}` (Locatie)

### Tips

- Zapier heeft een gratis plan met 100 taken per maand
- Gebruik "Paths" voor complexe logica (bijv. verschillende acties per discipline)
- Test altijd met een testmelding voordat je live gaat

Question 32

API-documentatie en endpoints

Accepted Answer

## API-documentatie en endpoints

De volledige API-documentatie is beschikbaar op [/api/docs](/api/docs). Hier vind je een overzicht van de belangrijkste endpoints.

### Base URL

```
https://meldingsmonitor.test/api/v1/
```

### Authenticatie

Alle requests vereisen een Bearer token in de `Authorization` header:

```
Authorization: Bearer jouw-api-token
```

### Beschikbare endpoints

#### Meldingen (Incidents)

| Methode | Endpoint | Beschrijving |
|---------|----------|-------------|
| GET | `/incidents` | Lijst van meldingen (gepagineerd) |
| GET | `/incidents/{id}` | Details van een specifieke melding |

**Filters voor `/incidents`:**
- `priority` — Filter op prioriteit (1, 2, 3)
- `city` — Filter op stad
- `discipline_id` — Filter op discipline
- `capcode_id` — Filter op capcode
- `date_from` / `date_to` — Filter op datum
- `search` — Zoek in meldingtekst

#### Capcodes

| Methode | Endpoint | Beschrijving |
|---------|----------|-------------|
| GET | `/capcodes` | Lijst van capcodes (gepagineerd) |
| GET | `/capcodes/{id}` | Details van een specifieke capcode |

**Filters voor `/capcodes`:**
- `discipline_id` — Filter op discipline
- `search` — Zoek op capcode of beschrijving

#### Voertuigen (Vehicles)

| Methode | Endpoint | Beschrijving |
|---------|----------|-------------|
| GET | `/vehicles` | Lijst van voertuigen (gepagineerd) |
| GET | `/vehicles/{id}` | Details van een specifiek voertuig |

**Filters voor `/vehicles`:**
- `type` — Filter op voertuigtype
- `search` — Zoek op roepnaam of beschrijving

#### Webhooks

| Methode | Endpoint | Beschrijving |
|---------|----------|-------------|
| GET | `/webhooks` | Lijst van je webhook-endpoints |
| POST | `/webhooks` | Nieuw webhook-endpoint aanmaken |
| PATCH | `/webhooks/{id}` | Webhook-endpoint bijwerken |
| DELETE | `/webhooks/{id}` | Webhook-endpoint verwijderen |

### Voorbeeld: Laatste meldingen ophalen

```bash
curl -H "Authorization: Bearer jouw-token" \
     "https://meldingsmonitor.test/api/v1/incidents?per_page=10"
```

### Voorbeeld response

```json
{
  "data": [
    {
      "id": 12345,
      "occurred_at": "2026-02-13T10:30:00+00:00",
      "message": "P 1 BRT-01 Brandmelding industrie",
      "priority": "1",
      "city": "Amsterdam",
      "latitude": 52.3676,
      "longitude": 4.9041,
      "disciplines": [{"id": 1, "name": "Brandweer"}],
      "capcodes": [{"id": 100, "capcode": "0120901", "description": "Kazerne Centrum"}],
      "vehicles": [{"id": 50, "call_sign": "AB 13-1", "type": "TS"}]
    }
  ],
  "meta": {
    "per_page": 10,
    "next_cursor": "abc123",
    "prev_cursor": null
  }
}
```

### Volledige documentatie

Bekijk de volledige API-documentatie met alle details, voorbeelden en foutcodes op [/api/docs](/api/docs).

Question 33

Koppeling met Domoticz

Accepted Answer

## Koppeling met Domoticz

Domoticz is een open-source domotica-systeem dat populair is onder doe-het-zelvers. Met een klein script kun je MeldingsMonitor webhooks ontvangen en vertalen naar Domoticz-acties.

### Optie 1: Via een script (aanbevolen)

Maak een klein Python-script dat de webhook ontvangt en de Domoticz API aanroept:

```python
from flask import Flask, request, jsonify
import requests

app = Flask(__name__)

DOMOTICZ_URL = "http://localhost:8080"

@app.route('/webhook/meldingsmonitor', methods=['POST'])
def webhook():
    data = request.json

# Schakel een virtueel apparaat in Domoticz
    requests.get(f"{DOMOTICZ_URL}/json.htm", params={
        "type": "command",
        "param": "switchlight",
        "idx": 1,  # IDX van je virtuele switch
        "switchcmd": "On"
    })

# Stuur een notificatie
    requests.get(f"{DOMOTICZ_URL}/json.htm", params={
        "type": "command",
        "param": "sendnotification",
        "subject": "P2000 Melding",
        "body": data.get('message', 'Nieuwe melding'),
        "subsystem": "fcm"
    })

return jsonify({"status": "ok"})

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)
```

### Optie 2: Via Node-RED

Als je Node-RED gebruikt naast Domoticz:

1. Installeer de `node-red-contrib-domoticz-output` node
2. Maak een HTTP-input node met het pad `/webhook/meldingsmonitor`
3. Verbind deze met een Domoticz-output node
4. Configureer het gewenste apparaat en de actie

### Stap voor stap in MeldingsMonitor

1. Draai het Python-script (of Node-RED) op je server
2. Maak de webhook bereikbaar via het internet (port forwarding, ngrok, reverse proxy)
3. Ga naar **Automatiseringen** in MeldingsMonitor
4. Maak een nieuwe automatisering en plak je webhook URL
5. Test de koppeling

### Domoticz-acties bij een melding

Met Domoticz kun je bij een P2000-melding:

- Lampen aansturen (Hue, Z-Wave, Zigbee)
- Sirenes activeren
- Notificaties versturen (Pushover, Prowl, Telegram)
- Een logboek bijhouden
- Scripts uitvoeren

### Tips

- Gebruik een virtuele switch in Domoticz als "trigger" apparaat
- Stel een timer in zodat het apparaat automatisch na X seconden uitschakelt
- Test eerst lokaal voordat je het bereikbaar maakt via het internet

Hoe kunnen we je helpen?

Alles

Aan de slag

Live Meldingen

Capcodes & Voertuigen

Automatiseringen

Koppelingen & Integraties

Kazerneschermen

Kazernemanagement

Statistieken

Account & Instellingen

API & Developer

Support & Contact

Wat zijn automatiseringen?

Wat zijn kazerneschermen?

Een post aanmaken en beheren

Statistieken bekijken

Philips Hue koppeling

Profiel en instellingen wijzigen

Wat is de MeldingsMonitor API?

Wat zijn capcodes?

Een supportticket aanmaken

Het live dashboard gebruiken

Wat is MeldingsMonitor?

Account aanmaken en inloggen

Abonnement beheren en opzeggen

API-tokens aanmaken en beheren

Postleden beheren

Veelgestelde vragen

Kazernescherm instellen

Koppeling met Home Assistant

Automatisering aanmaken

Voertuigen en eenheden

De live kaart gebruiken

Koppeling met Homey

Dienstrooster instellen

Webhook-URL instellen

Mijn meldingen en opgeslagen meldingen

API-webhooks instellen

Abonnementen en prijzen

Koppeling met IFTTT

Agenda en mededelingen

API rate limits en limieten

Koppeling met Zapier

API-documentatie en endpoints

Koppeling met Domoticz

Staat je antwoord er niet bij?

Cookies