Wat kan ik met een webhook?

Wat is een webhook?

Een webhook is een manier om realtime informatie van MeldingsMonitor naar andere systemen en applicaties te sturen. In eenvoudige termen: wanneer een P2000 melding aan jouw voorwaarden voldoet, stuurt MeldingsMonitor automatisch alle relevante gegevens naar een door jou opgegeven URL (eindpunt). Het externe systeem kan vervolgens direct reageren op deze informatie.

Hoe werkt een webhook in MeldingsMonitor?

1. Instellen: Je configureert een webhook URL in je automatisering
2. Trigger: Wanneer een P2000 melding voldoet aan je voorwaarden
3. Verzending: MeldingsMonitor stuurt automatisch een HTTP POST-verzoek naar je webhook URL
4. Data: Het verzoek bevat alle relevante informatie over de melding in JSON-formaat:

{
"automatisering_id": 123,
"automatisering_naam": "Brandweer P1 Meldingen",
"melding": {
"id": 456,
"message": "P 1 BRAND WONING DORPSTRAAT AMSTERDAM",
"capcodes": ["0123456", "0123457"],
"prioriteit": {"id": 1, "naam": "P1", "omschrijving": "Hoogste prioriteit"},
"discipline": {"id": 1, "naam": "Brandweer", "kleur": "#FF0000"},
"datum_tijd": "2025-03-15T15:30:00Z",
"locatie": "DORPSTRAAT, AMSTERDAM"
}

Integratie met Zapier

Zapier is een populair platform voor het automatiseren van werkstromen tussen verschillende applicaties zonder programmeerkennis. Zo integreer je MeldingsMonitor met Zapier:

1. Maak een Zap: Log in op Zapier en klik op "Make a Zap"
2. Kies webhook als trigger: Selecteer "Webhooks by Zapier" als je trigger app
3. Kies "Catch Hook": Dit maakt een unieke webhook URL aan die je in MeldingsMonitor kunt gebruiken
4. Kopieer de webhook URL: Zapier toont nu een unieke URL die je moet kopiëren
5. Configureer in MeldingsMonitor:
   • Ga naar "Automatiseringen" en maak een nieuwe automatisering
   • Stel je voorwaarden in (bijv. specifieke capcodes)
   • Kies "Webhook" als actie
   • Plak de Zapier URL in het URL-veld
6. Test de verbinding: Gebruik de "Test" knop in MeldingsMonitor om een testmelding te sturen
7. Verwerk de gegevens in Zapier: Zapier zal de gegevens ontvangen en je kunt nu kiezen welke velden je wilt gebruiken
8. Kies acties in Zapier: Selecteer wat er moet gebeuren met de gegevens, bijvoorbeeld:
   • Een bericht sturen in Slack of Microsoft Teams
   • Een rij toevoegen aan Google Sheets of Excel Online
   • Een taak aanmaken in Trello of Asana
   • Een bericht posten op sociale media
   • Een SMS sturen via Twilio

Praktijkvoorbeelden van Zapier-integraties

1. Team Notificaties: Stuur P1 meldingen van jouw brandweerkorps automatisch naar een Slack- of Teams-kanaal zodat het hele team direct geïnformeerd is.

2. Incident Logboek: Voeg elke melding automatisch toe aan een Google Spreadsheet met datum, tijd, capcode en meldingstekst voor een compleet logboek.

3. Taakbeheer: Maak automatisch een nieuwe kaart in Trello of een taak in Asana voor elke belangrijke melding om follow-up acties te coördineren.

4. Sociale Media Updates: Post automatisch (geanonimiseerde) meldingen op Twitter of Facebook voor publieke informatievoorziening.

5. Mobiele Notificaties: Stuur pushmeldingen naar je telefoon via Pushover of IFTTT, inclusief aangepaste geluiden voor verschillende typen meldingen.

Integratie met andere platforms

Naast Zapier kun je webhooks ook gebruiken met:

1. IFTTT (If This Then That): Vergelijkbaar met Zapier, maar meer gericht op consumentenelektronica en smart home toepassingen.

2. Microsoft Power Automate (voorheen Flow): Ideaal voor integratie met Microsoft 365-toepassingen zoals Outlook, Teams en SharePoint.

3. Node-RED: Een open-source flowgebaseerde ontwikkeltool voor het verbinden van hardware apparaten, API's en online diensten.

4. n8n: Een workflowautomatiseringstool met een focus op privacy en zelf-hosting.

5. Make (voorheen Integromat): Een krachtig automatiseringsplatform met geavanceerde conditionele logica.

Webhooks voor ontwikkelaars

Als je technische kennis hebt, kun je ook je eigen webhook-ontvangers bouwen:

1. Eigen Server: Ontwikkel een eenvoudige webserver (PHP, Node.js, Python, etc.) die de webhook-verzoeken ontvangt en verwerkt.

2. AWS Lambda: Gebruik serverloze functies om kostenefficiënt webhooks te verwerken zonder een volledige server te beheren.

3. Cloud Functions: Platforms zoals Google Cloud Functions of Azure Functions bieden eenvoudige manieren om code uit te voeren in reactie op HTTP-verzoeken.

4. Custom Applicaties: Bouw eigen apps die de webhook-data gebruiken voor specifieke toepassingen zoals:

   • Aangepaste LED-displays voor meldingsinformatie
   • Aansturen van sirenes of andere waarschuwingsapparaten
   • Integratie met bedrijfseigen systemen