Hoe installeer en configureer je de Generieke webhook app in Datamotive?

De Generieke webhook is een door Datamotive ontwikkelde app waarmee je eenvoudig een webhook configureert voor het afleveren van aanvragen bij een externe partij. Zo koppel je Datamotive flexibel aan elk systeem dat webhooks ondersteunt, ongeacht het platform dat je gebruikt. Deze app wordt ingezet binnen Formulieren en de Werkplaatsplanner, waar je per onderdeel ontvangers instelt die de webhookgegevens ontvangen.

Voorwaarde: vraag de benodigde URL en eventuele authenticatiegegevens op bij de externe partij voordat je de app configureert.

De Generieke webhook app installeren

Stap 1 – Navigeer naar Apps
Klik in het linkermenu op Apps en vervolgens op Beschikbare apps.

Stap 2 – Zoek de app
Typ "generieke webhook" in de zoekbalk en selecteer de app Generieke webhook uit de zoekresultaten.

Stap 3 – Installeer de app
Klik op + App installeren om de installatie te starten.

De app configureren

Stap 4 – Geef de integratie een naam
Vul bij Naam een herkenbare naam in voor deze integratie, bijvoorbeeld "Webhook".

Stap 5 – Vul de credentials in
Vul onder Credentials de volgende velden in:

• URL — het endpoint waar de webhookgegevens naartoe worden gestuurd, bijvoorbeeld https://api.datamotive.nl/webhook/test
• Authenticatiemethode — de manier waarop de webhook zich authenticeert bij de externe partij. Kies uit:
  • Geen authenticatie
  • Basic authenticatie
  • Bearer token
  • API key in header
  • API key in query string

Stap 6 – Voeg data velden toe
Klik onder Data velden op + Toevoegen om een veld toe te voegen dat wordt meegestuurd in de webhook. Vul per veld het volgende in:

• Sleutel — de technische sleutel waarmee het veld wordt aangeroepen, bijvoorbeeld "emailadres"
• Naam — de naam van het veld, bijvoorbeeld "emailadres"
• Pad — het pad waarop de waarde wordt gevonden, bijvoorbeeld "emailadres"
• Verplicht — schuif de schakelaar aan om het veld verplicht te maken

Herhaal deze stap voor elk gewenst data veld. Onder JSON Preview zie je direct hoe de opgebouwde webhookdata eruitziet.

Stap 7 – Sla de app op
Controleer of alle velden correct zijn ingevuld en klik op Aanmaken om de app te activeren. Wil je de installatie annuleren, klik dan op Annuleren.

Ontvangers instellen

Zodra de app is geïnstalleerd, kun je per onderdeel ontvangers toevoegen die de webhookgegevens ontvangen.

• Voor Formulieren: raadpleeg de handleiding [Hoe voeg je een ontvanger toe voor Generieke webhook in Datamotive?]
• Voor de Werkplaatsplanner: raadpleeg de handleiding [Hoe stel je Ontvangers in binnen de Werkplaatsplanner in Datamotive?]

De app beheren of verwijderen

Om de instellingen van een bestaande Generieke webhook app te wijzigen, klik je op Wijzigen naast de app onder Geïnstalleerde apps. Wil je de app verwijderen, klik dan op Verwijderen en bevestig de actie om de app definitief te verwijderen.

Overzicht instellingen