| Public | Administrateurs de Flotte, Gestionnaires de Flotte |
| S'applique à | Tableau de bord de flotte |
Introduction
Les webhooks (une fonction de rappel HTTP) représentent une passerelle pour recevoir des informations utiles lorsque des événements se produisent, au lieu de guetter ces données en permanence. Dans le cas de plusieurs événements, plusieurs URL doivent être spécifiées. Motive (anciennement Keeptruckin) enverra ainsi les données aux URL en question lorsque les événements se produisent.
Suivez le lien ci-dessous pour trouver les actions actuellement prises en charge et leurs charges utiles dans la documentation destinée aux développeurs de webhooks :
developer.keeptruckin.com/reference#webhooks
Voici quelques-uns des cas d'utilisation courants des webhooks :
- Mises à jour de l'emplacement du véhicule : Si vous souhaitez être averti à chaque mise à jour de la position actuelle d'un véhicule, abonnez-vous à l'action vehicle_location_updated.
- Fault Code Opened: Si vous voulez recevoir une notification chaque fois qu'un nouveau code de défaillance est ouvert sur un véhicule, abonnez-vous à l'action fault_code_opened.
- Fault Code Closed: Si vous voulez recevoir une notification chaque fois qu'un code de défaillance existant est fermé sur un véhicule, abonnez-vous à l'action fault_code_closed, car celle-ci se déclenche dès qu'un code de défaillance existant est fermé sur un véhicule.
Étapes : Créer des webhooks sur le tableau de bord de flotte
1. Connectez-vous au tableau de bord Motive Fleet et accédez à l'onglet Administrateur en bas à gauche.
2. Accédez à l'onglet Développeurs depuis le menu latéral gauche.
3. Cliquez sur Webhooks puis sur Créer un webhook.
4. Renseignez toutes les informations requises, y compris les attributs suivants :
- Nom : Le nom
- URL : Adresse à laquelle le webhook émet une requête HTTP Post to
- Secret : code de 20 caractères pour garantir que la requête a été envoyée par les serveurs de Motive et qu'elle n'a pas été modifiée pendant la transmission
- Événement : Action au sujet de laquelle vous voulez être informé (p. ex. Violation des HDS)
5. Une fois le formulaire rempli, cliquez sur Enregistrer en haut à droite.