Webhooks stellen u in staat om automatisch acties in andere systemen te activeren op basis van gebeurtenissen in uw voertuigvolgsysteem .
Je kunt bijvoorbeeld automatisch een e-mail naar een klant sturen wanneer de levering arriveert, of je facturatiesysteem bijwerken wanneer een opdracht is voltooid.
Webhooks instellen
Het instellen van webhooks bestaat uit vier eenvoudige stappen:
Maak een webhook-eindpunt aan - Dit is een webadres (URL) waarnaar we de notificatiegegevens zullen verzenden. Je moet een server of service instellen die deze informatie kan ontvangen en verwerken.
Configureer de webhook in uw trackingsysteem - Kies welke gebeurtenissen de webhook moeten activeren en geef de URL van uw webhook-eindpunt op.
Schrijf code om de gegevens te verwerken - Wanneer een gebeurtenis plaatsvindt, sturen we gegevens naar uw eindpunt. Uw code moet deze gegevens ontvangen en de gewenste actie uitvoeren.
Test of het werkt - Activeer handmatig een gebeurtenis om er zeker van te zijn dat uw webhook de gegevens ontvangt en de verwachte actie uitvoert.
Webhooks kunnen een krachtig hulpmiddel zijn voor het automatiseren van taken en het integreren van uw voertuigvolgsysteem met andere systemen. Met een beetje configuratie kunt u webhooks gebruiken om uw workflows te stroomlijnen en de efficiëntie te verbeteren.
Praktische voorbeelden
Hieronder volgen enkele praktische voorbeelden van hoe bedrijven webhooks gebruiken:
Klantmeldingen - Stel klanten automatisch op de hoogte wanneer hun voertuig op de afleverlocatie aankomt. Stel de webhook zo in dat deze wordt geactiveerd wanneer een voertuig een specifiek adres bereikt.
Facturatieautomatisering - Werk het account van uw klant bij wanneer een levering is voltooid. De webhook wordt geactiveerd wanneer een voertuig gedurende een bepaalde tijd op de bestemming blijft, wat aangeeft dat de opdracht is afgerond.
Snelheidswaarschuwingen - Verstuur waarschuwingen naar uw managementteam wanneer voertuigen de snelheidslimieten overschrijden. Stel de webhook zo in dat deze wordt geactiveerd wanneer de snelheid boven uw drempelwaarde komt (bijvoorbeeld 129 km/u).
Routebewaking - Stel de dispatchers op de hoogte wanneer voertuigen van hun geplande route afwijken. De webhook wordt geactiveerd wanneer een voertuig meer dan een ingestelde afstand afwijkt van het verwachte traject.
Dit zijn slechts enkele voorbeelden van hoe je webhooks met locatie- en tijdspecifieke gegevens kunt gebruiken in een voertuigvolgsysteem. Webhooks kunnen ook op vele andere manieren worden ingezet, afhankelijk van je specifieke behoeften en gebruiksscenario.
Welke gegevens worden verzonden?
Wanneer een webhook wordt geactiveerd, sturen we u voertuiginformatie in JSON-formaat, waaronder:
Voertuigregistratie en identificatie
Naam van de bestuurder
Type gebeurtenis (zoals RIJDEN of STILSTAAN)
Datum en tijd
Exacte locatie met adres
Breedte- en lengtegraadcoördinaten
Snelheid in zowel km/u als mph.
Spanningsmetingen
Kilometerstand
Voorbeeldgegevens:
{accountId:3,vehicleRegistration:7567453451,vehicleId:345934,vehicleEvent:DRIVING,driverName:NW,dateTime:2023-01-10 11:56:09,location:M1, London, England, NW7 3,latitude:51.6289668131,longitude:-0.2625989914,speedKph:57,speedMph:35,geofenceName:null,congestionZone:null,externalVoltage:14.5,internalVoltage:null,odometer:72185.0}Beveiliging
Je kunt de beveiliging van webhook-oproepen verhogen door een authenticatietoken in je RAM-systeem in te stellen. Ga hiervoor naar het instellingenscherm in het menu aan de linkerkant.
Wanneer je een authenticatietoken toevoegt, voegen we in elk webhookverzoek een HTTP-header met de naam 'Auth' en de door jou opgegeven waarde toe. Hiermee kun je controleren of het verzoek daadwerkelijk vanuit RAM is verzonden.
Heeft u nog steeds hulp nodig?