1. Que sont les Webhooks ?
Les webhooks sont un moyen simple et automatique de recevoir des informations en temps réel lorsqu'un événement se produit dans Modjo.
Plutôt que de vérifier constamment si quelque chose a changé, Modjo envoie directement les informations dès qu’un événement survient.
Grâce aux webhooks, vous pouvez connecter Modjo à d’autres outils et automatiser des tâches sans intervention manuelle. Cela permet de gagner du temps, d’améliorer la collaboration et de s’assurer que toutes les informations sont à jour dans vos outils préférés.
Exemple :
Recevoir une alerte dans Slack
Imaginez que votre équipe utilise Slack pour communiquer. Grâce aux webhooks, vous pouvez configurer une alerte automatique qui envoie un message dans un canal Slack.
Cela permet à toute l’équipe d’être informée en temps réel, de réagir rapidement et d’assurer un meilleur suivi client sans effort supplémentaire.
Cette fonctionnalité est particulièrement utile pour :
Synchroniser des données
Automatiser des workflows
Intégrer Modjo avec des outils tiers
2. Comment configurer un webhook
🚨 Prérequis : Avant de créer un webhook, vous devez avoir les permissions Administrateur ou Manager.
Étapes pour créer un webhook
Cliquez sur "Créer un webhook" et renseignez l’URL qui recevra les notifications.
Une fois le webhook créé, vous recevrez un jeton de sécurité unique, qui servira à vérifier l’authenticité des requêtes webhook envoyées par Modjo.
3. Sécurisez votre webhook
L’URL que vous renseignez recevra directement les données envoyées par Modjo. Il est donc essentiel de bien la choisir et de la sécuriser.
Bonnes pratiques pour la sécurité :
Utilisez une URL en HTTPS : Cela garantit le chiffrement des données envoyées.
Assurez-vous que l’URL est accessible : Le serveur qui reçoit le webhook doit être accessible depuis Internet. Pour des tests en local, des outils comme ngrok peuvent être utiles.
Ne renseignez pas d’URL publique ou non sécurisée : L’URL du webhook doit être dédiée à la réception des événements et ne doit pas être accessible à des tiers non autorisés.
Vérifiez les requêtes reçues : Vous devez valider la signature des webhooks en utilisant le jeton de sécurité généré lors de la création du webhook.
Faites attention aux données envoyées : Certains webhooks peuvent contenir des informations sensibles, assurez-vous de protéger votre infrastructure.
4. Gestion des webhooks
Vous pouvez modifier ou supprimer vos webhooks à tout moment depuis la page des paramètres webhook.
Si un webhook n’est plus utilisé, il est recommandé de le supprimer pour éviter des requêtes inutiles.
En cas de compromission de votre URL de webhook, supprimez le webhook et recréez-le pour obtenir un nouveau jeton de sécurité.
Pour en savoir plus sur :
Les différents événements webhook disponibles.
La structure des données envoyées dans chaque webhook.
La vérification de l’authenticité des requêtes webhook.
Consultez la documentation API de Modjo.