Webhooks let you automatically trigger actions in other systems based on events in your vehicle tracking system.
For example, you could automatically send a customer an email when their delivery arrives, or update your billing system when a job is completed.
How to Set Up Webhooks
Setting up webhooks involves four simple steps:
Create a webhook endpoint - This is a web address (URL) where we'll send the notification data. You'll need to set up a server or service that can receive and process this information.
Configure the webhook in your tracking system - Choose which events should trigger the webhook and provide your webhook endpoint URL.
Write code to handle the data - When an event happens, we'll send data to your endpoint. Your code needs to receive this data and take whatever action you want.
Test it works - Trigger an event manually to make sure your webhook receives the data and performs the expected action.
Webhooks can be a powerful tool for automating tasks and integrating your vehicle tracking system with other systems. With a little setup, you can use webhooks to streamline your workflows and improve efficiency.
Real-World Examples
Here are some practical ways businesses use webhooks:
Customer Notifications - Automatically notify customers when their vehicle arrives at the delivery location. Set the webhook to trigger when a vehicle reaches a specific address.
Billing Automation - Update your customer's account when a delivery is completed. The webhook triggers when a vehicle stays at the destination for a set time, indicating the job is done.
Speed Alerts - Send alerts to your management team when vehicles exceed speed limits. Set the webhook to trigger when speed goes over your threshold (like 80 mph).
Route Monitoring - Notify dispatchers when vehicles go off their planned route. The webhook triggers when a vehicle deviates by more than a set distance from the expected path.
These are just a few examples of how you could use webhooks with location and time-specific data in a vehicle tracking system. Webhooks can be used in many other ways as well, depending on your specific needs and use case.
What Data Gets Sent?
When a webhook triggers, we send you vehicle information in JSON format including:
Vehicle registration and ID
Driver name
Event type (like "DRIVING" or "STOPPED")
Date and time
Exact location with address
Latitude and longitude coordinates
Speed in both KPH and MPH
Voltage readings
Odometer reading
Example Data:
{"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}Security
You can add security to webhook calls by setting up an auth token in your RAM Tracking system. Go to the setup screen from the left menu to add this.
When you add an auth token, we'll include an HTTP header called "Auth" with your specified value in every webhook request. This lets you verify that the request actually came from RAM Tracking.