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.
💡 Uniquement les utilisateurs « Admin » peuvent accéder à l’onglet permettant de paramétrer les webhooks.
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 assignée à une tournée
- Intervention réalisée
- Intervention annulée
- Intervention supprimée
- Intervention verrouillée
- Intervention confirmée
- Intervention en attente
- Intervention avancée ou reculée ou assignée à une autre tournée
- Intervention passée à l’état non assigné
- Signature du client ajoutée
- Preuve de passage (photo) ajoutée
- Tournée démarrée
- Tournée terminée
- Notification envoyée au client
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.
💡 Vous pouvez filtrer les logs pour afficher uniquement ceux en erreur.
- Identifiez un webhook et cliquez sur « … ».
- Cliquez sur « Logs ».
💡 L’icône ✔ indique que les informations ont bien été remontées. En revanche, l’icône X indique que les informations n’ont pas été remontées vers l’application tierce. Dans ce cas, vous pouvez cliquer sur le contenu envoyé dans le tableau afin de comprendre l’erreur.