Webhook-URL instellen
Hoe stel je een webhook-URL in en wat zijn de vereisten.
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 structuur:
| Veld | Type | Beschrijving |
|---|---|---|
automation_id |
integer | ID van de automatisering |
automation_name |
string | Naam van de automatisering |
incident.id |
integer | Uniek ID van de melding |
incident.message |
string | Volledige meldingtekst |
incident.priority |
string | Prioriteit (P1, P2, etc.) |
incident.occurred_at |
string | Tijdstip van de melding (ISO 8601) |
incident.disciplines |
array | Lijst van disciplines (bijv. ["Brandweer"]) |
incident.capcodes |
array | Lijst van capcodes met capcode en description |
incident.safety_regions |
array | Lijst van veiligheidsregio's |
incident.street |
string | Straatnaam |
incident.city |
string | Plaatsnaam |
incident.postal_code |
string | Postcode |
incident.latitude |
float/null | Breedtegraad |
incident.longitude |
float/null | Lengtegraad |
Headers
Elke webhook-aanroep bevat de volgende header:
Content-Type: application/json
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.
Staat je antwoord er niet bij?
Neem contact met ons op via een supportticket. We helpen je graag verder.
