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.
Exemple de requête HTTP :
Événements qui peuvent être envoyés :
- Changement d’état : Livraison annulée, Livraison confirmée, Livraison créée, Livraison en attente, Livraison supprimée, Livraison réalisée, État confirmé retiré, État en attente retiré.
- Planification : Livraison passée à l’état non assigné, Livraison avancée ou reculée ou assignée à une autre tournée, Livraison assignée à une tournée, Livraison assignée à une tournée démarrée, Livraison planifiée depuis le panier, Livraison déplacée dans le panier, Date de planification changée.
- Preuves de passage : Preuve de passage (photo) ajoutée, Signature du client ajoutée.
- Autres : Livraison verrouillée, Livraison mise à jour.
- Tournée : Tournée démarrée, Tournée terminée.
- Notification : Notification envoyée
- Pick-up & Delivery : Chargement réalisé, Déchargement réalisé, Chargement annulé, Déchargement annulé.
Comment 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 « + » en haut à droite.
- Renseignez les informations demandées : nom, adresse URL, mode d'authentification, etc.
- Sélectionnez les événements à envoyer.
- Choisissez d'inclure ou non toutes les informations des interventions (ID, état, etc.).
- Si vous avez plusieurs sites, sélectionnez les sites qui sont concernés.
- Cliquez sur le bouton « Sauvegarder ».
Comment 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.