Les webhooks permettent à Digital Permit Book de prévenir vos autres systèmes, comme un TMS, la paie ou un outil d'automatisation, dès qu'un changement se produit. Par exemple, quand un chauffeur est ajouté, qu'un document est mis à jour ou qu'un DVIR est soumis.
Forfait : Les webhooks font généralement partie du forfait Enterprise, il est donc possible que Webhooks n'apparaisse pas dans les Paramètres. Contactez le support pour les activer pour votre entreprise.
Ajouter un webhook
- Allez dans Paramètres > Webhooks.
- Cliquez sur + Ajouter un webhook.
- Saisissez un Nom pour le reconnaître plus tard, par exemple Synchro TMS.
- Choisissez le Type et indiquez où envoyer les événements :
- URL : saisissez l'adresse web du système qui reçoit les événements.
- E-mail : saisissez une adresse e-mail. Les mêmes événements y sont envoyés par e-mail, pratique pour une personne ou une boîte partagée.
- Sous Événements, choisissez un ou plusieurs événements à envoyer (voir la liste ci-dessous). Si vous choisissez un événement de document, un champ Type de document apparaît. Choisissez les types de documents à envoyer, par exemple seulement Carte médicale et Immatriculation du véhicule. Tapez pour chercher dans la liste.
- Facultatif : cliquez sur + Ajouter un en-tête personnalisé pour envoyer des en-têtes supplémentaires avec chaque événement, comme une clé API ou un jeton attendu par votre système.
- Cliquez sur Enregistrer.
Le webhook apparaît dans la liste avec son nom, son URL ou e-mail, ses événements et ses types de documents. Utilisez la colonne Action pour le modifier ou le supprimer.
Événements disponibles
| Domaine | Événements |
|---|---|
| Chauffeurs | Driver Created, Driver Updated, Driver Deleted |
| Véhicules | Vehicle Created, Vehicle Updated, Vehicle Deleted |
| Remorques | Trailer Created, Trailer Updated, Trailer Deleted |
| Documents | Document Created, Document Updated, Document Deleted |
| DVIR | DVIR Submitted |
| Formulaires | Form Submitted |
Conseils
- Utilisez les En-têtes personnalisés pour protéger votre URL : ajoutez un en-tête secret et faites refuser par votre système les requêtes qui ne le contiennent pas.
- Créez des webhooks distincts si différents systèmes ou personnes ont besoin d'événements différents.
- Utilisez les webhooks E-mail pour prévenir quelqu'un sans aucune configuration de son côté, par exemple le responsable sécurité quand un DVIR est soumis.
- Vous voulez lire ou modifier des données plutôt que recevoir des événements ? Utilisez l'API. Pour connecter un assistant IA, consultez MCP.