Votre boutique en ligne, votre outil de paiement ou votre agenda peuvent prévenir Odoo dès qu'il se passe quelque chose, et Odoo peut leur répondre de la même façon. Cet article explique simplement comment fonctionne ce mécanisme, les trois façons de l'utiliser et les précautions à prendre.
Un webhook Odoo, c'est une manière simple de faire parler Odoo avec le reste de vos outils sans que personne ait à ressaisir ou à exporter des données. Si vous avez déjà recopié une commande d'un site web vers votre ERP, ou relancé à la main un export chaque matin, ce sujet vous concerne.
Ce qu'est un webhook, et pourquoi il change le quotidien
Un webhook est un message automatique envoyé d'un logiciel à un autre au moment précis où un événement se produit. Techniquement, c'est une requête web envoyée à une adresse (une URL) que le destinataire a préparée pour l'occasion. Pensez à un coup de sonnette : au lieu de venir voir toutes les cinq minutes si quelqu'un est à la porte, vous êtes prévenu quand il arrive.
La différence avec une synchronisation classique est là. Dans le fonctionnement traditionnel, un programme interroge régulièrement l'autre (« y a-t-il du nouveau ? »). Avec un webhook, c'est l'événement qui déclenche l'envoi. Les données arrivent donc au bon moment, et il y a moins de traitements inutiles.
Deux sens sont possibles :
- Envoyer : Odoo prévient un outil extérieur (une commande est confirmée, une facture est payée, un contact est créé).
- Recevoir : un outil extérieur prévient Odoo (un paiement est validé, un formulaire est rempli, un colis est expédié).
Envoyer un webhook Odoo depuis une action automatisée
C'est le sens le plus accessible. Odoo dispose d'un outil appelé actions automatisées (ou règles d'automatisation selon la version) : vous indiquez « quand tel événement arrive sur tel type de fiche, fais telle chose ». On y accède en général par le menu des paramètres, dans la partie technique, après avoir activé le mode développeur.
Selon la version d'Odoo, la liste des actions proposées inclut une action de type « Envoyer une notification webhook ». Elle vous demande :
- L'adresse de destination, fournie par l'outil qui doit recevoir le message.
- Les champs à transmettre : par exemple le numéro de commande, le client, le montant.
- Le déclencheur : création d'une fiche, modification d'un champ précis, changement d'étape, etc.
Cette action n'existe pas dans toutes les versions, et les intitulés des menus et des champs varient d'une version à l'autre. Avant de planifier quoi que ce soit, vérifiez dans votre propre base ce qui est proposé. Si l'action n'est pas disponible chez vous, il existe un plan B : une action automatisée qui exécute un petit bout de code Python (avec les droits adéquats) et envoie elle-même le message. Cette option est puissante mais plus délicate, et elle n'est pas toujours autorisée selon votre type d'hébergement.
Recevoir un webhook dans Odoo : trois chemins possibles
Le sens inverse demande un peu plus de réflexion, car Odoo doit exposer une adresse prête à écouter. Selon votre version et votre hébergement, trois approches existent.
1. Le déclencheur « webhook » des règles d'automatisation. Certaines versions récentes d'Odoo permettent de créer une règle dont le déclencheur est la réception d'un message externe : Odoo génère alors une adresse unique à communiquer à l'outil émetteur. Vérifiez si ce déclencheur apparaît dans votre version avant de choisir cette voie.
2. Un module personnalisé. Un développeur peut ajouter à Odoo une adresse d'écoute sur mesure (un « contrôleur »). C'est très flexible, mais cela suppose de pouvoir installer des modules, ce qui n'est pas possible sur toutes les formules d'hébergement Odoo.
3. Un petit connecteur intermédiaire. Un programme Python, hébergé à part, reçoit le webhook, contrôle le message, le transforme si besoin, puis écrit dans Odoo via son API (l'interface officielle qui permet à un programme de lire et d'écrire des données, avec une clé d'accès). C'est souvent la solution la plus robuste : elle fonctionne quel que soit l'hébergement d'Odoo et laisse votre base propre. Le détail de l'API (protocoles, authentification) évolue d'une version à l'autre : consultez la documentation officielle correspondant à la vôtre.
Les précautions à prendre avant de brancher quoi que ce soit
Un webhook ouvre une porte. Quelques réflexes évitent bien des soucis.
- Vérifier l'expéditeur. Beaucoup de services signent leurs messages avec un secret partagé. Votre récepteur doit contrôler cette signature, sinon n'importe qui pourrait lui envoyer de fausses commandes.
- Utiliser une adresse sécurisée (en https) et ne jamais afficher publiquement les clés d'accès.
- Prévoir les doublons. Un service renvoie parfois le même message plusieurs fois, par exemple si votre serveur a tardé à répondre. Gardez l'identifiant de l'événement et ignorez ceux déjà traités : on parle d'idempotence, c'est-à-dire que traiter deux fois le même message ne doit pas créer deux fois la même commande.
- Répondre vite. L'émetteur attend une confirmation de réception. Si le traitement est long, accusez réception d'abord et traitez ensuite.
- Tout journaliser. Quand un client dit « ma commande n'est pas arrivée », vous devez pouvoir retrouver le message reçu et ce qu'on en a fait.
- Tester sur une copie. Ne branchez pas un nouveau flux directement sur votre base de production : essayez d'abord sur une base de test avec des données fictives.
Un exemple concret à reproduire
Prenons une PME qui vend en ligne et encaisse via un service de paiement. Elle souhaite que la facture Odoo passe automatiquement en « payée » quand le paiement est validé.
- Le service de paiement propose, dans ses réglages, une section « webhooks » : vous y saisissez l'adresse de votre récepteur et choisissez l'événement « paiement réussi ».
- Le récepteur reçoit le message, vérifie la signature, relève la référence de commande.
- Il retrouve la facture correspondante dans Odoo via l'API et enregistre le paiement.
- Il note l'opération dans un journal, avec l'identifiant de l'événement pour éviter tout doublon.
- En parallèle, une action automatisée Odoo envoie un webhook vers l'outil de messagerie de l'équipe pour signaler « Facture réglée ».
Vous pouvez commencer dès aujourd'hui sans rien installer :
- Listez trois événements qui vous font perdre du temps (un paiement, une commande, un formulaire).
- Pour chacun, notez de quel outil vient l'information et où elle doit atterrir dans Odoo.
- Ouvrez, en mode développeur, le menu des actions automatisées de votre base et regardez quels types d'actions et de déclencheurs votre version propose.
- Vérifiez dans la documentation de l'outil concerné s'il sait envoyer ou recevoir des webhooks.
Ce petit inventaire suffit à savoir si votre besoin se règle avec un simple paramétrage ou s'il demande un connecteur.
Comment CARONNA Odoo vous évite le plus technique
C'est précisément le genre de chantier où l'on hésite : la partie Odoo se règle avec quelques paramètres, mais le récepteur, la vérification de signature et le journal demandent du code. Avec CARONNA Odoo, vous branchez votre base, vous décrivez votre besoin en français (« quand un paiement est validé, marque la facture comme payée et préviens l'équipe »), et l'intelligence artificielle prend en charge la suite.
Concrètement, elle paramètre les actions automatisées dans votre base et, si votre cas l'exige, développe un connecteur en Python hébergé sur PythonAnywhere pour recevoir les messages. Elle peut aussi vous livrer un module sous forme de fichiers lorsque c'est la bonne option, et voir votre écran grâce à l'extension Chrome pour vous guider dans les menus de votre version précise.
Les garde-fous sont pensés pour des équipes non techniques : vous choisissez le mode test ou le mode production, aucune action irréversible n'est lancée sans votre accord explicite, et un journal complet permet de revenir en arrière. L'IA est incluse dans l'abonnement. Pour estimer ce que cela peut vous apporter, rendez-vous sur la section gain de temps, regardez le fonctionnement en vidéo ou en situation dans la démonstration, ou accédez directement à l'application pour essayer sur votre propre base.
Un webhook n'a rien de mystérieux : c'est un message envoyé au bon moment, vers la bonne adresse, avec les bonnes vérifications. En commençant par un seul flux bien choisi, testé sur une copie, vous gagnez vite en confiance.
Votre intégrateur Odoo, disponible tout de suite
Branchez votre Odoo et décrivez votre besoin en français : l'IA paramètre, connecte et vérifie, avec votre accord pour chaque action sensible. IA incluse, dès 149 € par mois.