L’utilisation de webhooks vous permet d’être notifié en temps réel dans vos applications favorites dès qu’une modification est apportée sur une intervention de votre compte AntsRoute. Concrètement, un webhook permet d’envoyer une demande HTTP à une URL spécifiée en réponse à un événement.
L’envoi automatisé de ces informations permet de déclencher des workflows (flux de travail) dans l’application entrante. Par exemple, la création d’une facture sur votre compte Quickbooks dès qu’une livraison est réalisée avec AntsRoute.
Ajouter un webhook
Dans un premier temps, vous devez récupérer l’URL du webhook de l’application vers laquelle vous souhaitez envoyer les données.
- Cliquez sur le rond bleu en haut à droite.
- Rendez-vous dans 'Intégrations'.
- Cliquez sur l’onglet 'Webhooks'.
- Cliquez sur le bouton 'Ajouter'.
- Renseignez les informations demandées :
- Nom ;
- Adresse URL ;
- Mode d’authentification ;
- Identifiant ;
- Mot de passe.
- Choisissez l’événement à envoyer.
- Cliquez sur le bouton 'Sauvegarder'.
Voici les événements AntsRoute qui peuvent être envoyés :
- Intervention réalisée ;
- Intervention annulée ;
- Intervention supprimée ;
- Intervention verrouillée ;
- Signature du client ajoutée ;
- Preuve de passage (photo) ajoutée.
- Tournée démarrée
Les événements concernant le pick-up and delivery qui peuvent être envoyés :
- Chargement réalisé
- Déchargement réalisé
- Chargement annulé
- Déchargement annulé
Voici un exemple de requête HTTP :
Vérifier les logs
L’onglet ‘Logs’ vous permet d’accéder à l’historique des informations remontées vers vos applications et visualiser les éventuelles erreurs pour chacun de vos webhooks.
- Identifiez un webhook et cliquez sur '…'.
- Cliquez sur 'Logs'.
