Qu’est-ce qu’un webhook ? 🧐

Pour faire simple, un webhook est une solution qui permet de faire communiquer deux systèmes d’information en temps réel. Également appelé lien de rappel HTTP, un webhook récupère des informations sur une application afin de les transférer de façon automatisée vers un autre système. L’objectif ? Gagner du temps en éliminant les tâches répétitives de transfert de données. En utilisant cette méthode de programmation, vous n’avez plus besoin d’interroger constamment une application afin de déterminer si des changements ont eu lieu.

Et cerise sur le gâteau ? La mise en place d’un webhook se fait en quelques instants et ne nécessite généralement aucun codage.

Déclencher des workflows dans vos app. favorites sans effort ✨

L’utilisation de webhooks permet de recevoir des notifications en temps réel dans vos applications favorites dès qu’une modification est apportée sur une intervention depuis AntsRoute. Ainsi, vous pouvez automatiser une multitude de tâches dans vos applications.

Par exemple, vous pouvez mettre en place un webhook qui déclenche l’envoi d’une notification automatique vers votre logiciel de facturation dès qu’une livraison est réalisée. Ainsi, dès réception de cette notification, vous avez la possibilité de déclencher un flux de travail. En d’autres termes, il s’agit de créer une action personnalisée qui s’effectuera en fonction des informations reçues. Par exemple, la création d’une facture et l’envoi par email du document au client.

Voici les événements AntsRoute à envoyer :

• Intervention réalisée ;
• Intervention annulée ;
• Intervention supprimée ;
• Intervention verrouillée ;
• Signature du client ajoutée ;
• Preuve de passage (photo) ajoutée.

Voici les informations associées qui sont transférées via les requêtes HTTP :

• Événement ;
• Identifient de l’intervention ;
• Identifient externe ;
• Identifient du site ;
• Date de passage ;
• Statut de l’intervention ;
• Heure de passage planifiée prévue ;
• Intervenant assigné ;
• Véhicule assigné.

Exemple JSON de requête HTTP

Et pour ceux qui utilisent Zapier ?

Si vous utilisez le web service Zapier pour jongler entre vos différents outils, nous avons une bonne nouvelle pour vous ! Jusqu’à présent AntsRoute pouvait uniquement être sélectionné pour l’événement ‘Action’. Eh bien, vous pouvez désormais choisir notre outil d’optimisation de tournées pour l’événement ‘Trigger’. Prenons l’exemple d’une connexion entre AntsRoute et Quickbooks à l’aide de Zapier. Vous pouvez à présent créer un Zap pour qu’une annulation d’intervention sur AntsRoute déclenche une suppression de la facture associée sur Quickbooks.

Comment paramètrer un webhook ? 🤖

Prêt à découvrir comment transférer automatiquement vos données depuis AntsRoute vers d’autres applications ? Pour commencer, sachez que vous n’avez pas besoin de savoir coder. Prenez quelques minutes pour paramétrer vos webhooks et dès que c’est fait vous n’aurez plus besoin de vous en occuper. Pour cela, vous devez simplement suivre ces quelques étapes :

Étape 1 : Indiquez l’URL du webhook de l’application réceptrice, c’est-à-dire l’application vers laquelle vous souhaitez envoyer les données. Par exemple, si vous utilisez un logiciel pour gérer votre facturation et souhaitez automatiser la création d’une nouvelle facture dès qu’une livraison est réalisée avec AntsRoute, vous devez récupérer l’URL de son webhook.

Étape 2 : Rendez-vous maintenant sur AntsRoute pour ajouter un nouveau webhook. Pour cela, vous devez aller dans ’Intégration’ > ‘Webhook’ > ‘Ajouter’. Renseignez l’URL que vous avez récupérée précédemment, choisissez un mode d’authentification et déterminez l’événement à envoyer parmi ceux présentés ci-dessus. Et le tour est joué ! 😉

Désormais, dès que l’événement choisi est réalisé, les informations seront envoyées automatiquement à l’URL renseignée. Par exemple, l’outil de facturation est ainsi alerté et peut créer une nouvelle facture pour chaque nouvelle livraison réalisée.

Afin de vérifier que les informations ont bien été envoyées à l’application réceptrice, vous disposez de logs pour chacun des webhooks que vous avez créé. Vous pouvez ainsi connaître les éventuelles erreurs qui empêchent la remontée des informations.

💡 Pour en savoir davantage sur le paramétrage des webhooks sur AntsRoute, consultez notre article de support.

Remarques : Les webhooks sont disponibles pour tous les utilisateurs AntsRoute à partir de l’offre Essential.

D’autres (très) belles nouveautés arrivent prochainement sur AntsRoute. À très vite. 🤩