Les webhooks permettent de déclencher automatiquement des actions dans d’autres systèmes en fonction d’événements dans votre système de suivi des véhicules.
Par exemple, vous pouvez automatiquement envoyer un e-mail à un client lorsque sa livraison arrive, ou mettre à jour votre système de facturation lorsqu’une tâche est terminée.
Comment configurer des webhooks
La configuration d’un webhook se fait en quatre étapes simples :
Créer un point de terminaison (endpoint) webhook – Il s’agit d’une adresse web (URL) où nous enverrons les données de notification. Vous devez configurer un serveur ou un service capable de recevoir et de traiter ces informations.
Configurer le webhook dans votre système de suivi – Choisissez quels événements doivent déclencher le webhook et fournissez l’URL de votre endpoint.
Écrire du code pour traiter les données – Lorsqu’un événement se produit, nous enverrons des données à votre endpoint. Votre code doit recevoir ces données et exécuter l’action souhaitée.
Tester son fonctionnement – Déclenchez un événement manuellement pour vérifier que votre webhook reçoit bien les données et exécute l’action attendue.
Les webhooks sont un outil puissant pour automatiser des tâches et intégrer votre système de suivi des véhicules avec d’autres systèmes. Avec un peu de configuration, vous pouvez simplifier vos flux de travail et améliorer votre efficacité.
Exemples concrets
Voici quelques manières pratiques dont les entreprises utilisent les webhooks :
Notifications clients – Informez automatiquement vos clients quand leur véhicule arrive au lieu de livraison. Configurez le webhook pour qu’il se déclenche lorsqu’un véhicule atteint une adresse spécifique.
Automatisation de la facturation – Mettez à jour le compte de votre client lorsqu’une livraison est terminée. Le webhook se déclenche quand un véhicule reste à destination un certain temps, indiquant que la tâche est terminée.
Alertes de vitesse – Envoyez des alertes à votre équipe de gestion lorsque des véhicules dépassent les limitations de vitesse. Configurez le webhook pour se déclencher au-delà d’un seuil (par exemple 130 km/h).
Suivi d’itinéraire – Informez les répartiteurs quand les véhicules quittent leur itinéraire prévu. Le webhook se déclenche lorsqu’un véhicule s’écarte de plus d’une certaine distance de la route attendue.
Quelles données sont envoyées ?
Quand un webhook est déclenché, nous vous envoyons des informations sur le véhicule au format JSON, notamment :
Immatriculation et ID du véhicule
Nom du conducteur
Type d’événement (par ex. « EN CONDUITE » ou « ARRÊTÉ »)
Date et heure
Localisation exacte avec adresse
Coordonnées latitude et longitude
Vitesse en km/h et mph
Tension relevée
Relevé de l’odomètre
Exemple de données :
{"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}
Sécurité
Vous pouvez ajouter une sécurité aux appels webhook en configurant un jeton d’authentification dans votre système RAM Tracking. Allez dans l’écran de configuration via le menu de gauche pour l’ajouter.
Une fois configuré, nous inclurons un en-tête HTTP appelé « Auth » avec la valeur spécifiée dans chaque requête webhook. Cela vous permet de vérifier que la requête provient bien de RAM Tracking.