Webhook
Un webhook est un message qu'un système envoie de lui-même, au moment où un événement se produit chez lui. Une commande vient d'être payée sur la boutique : la boutique appelle une adresse que vous lui avez donnée et dit, en substance, « voici la commande 18422, elle est payée ». Personne n'a eu à poser la question. En français, on parle d'une notification d'événement. Dans les projets, c'est le mot anglais qui s'emploie, y compris entre francophones.
L'autre méthode, et pourquoi elle existe encore
Avant les notifications, et encore aujourd'hui dans beaucoup d'installations, les systèmes se tiennent au courant en demandant. L'entrepôt interroge la boutique toutes les cinq minutes : as-tu de nouvelles commandes ? Dans l'immense majorité des cas la réponse est non, et l'échange a eu lieu pour rien.
Cette méthode a deux défauts et une vertu.
Les défauts : elle fait beaucoup d'appels inutiles, et elle introduit un retard. Si vous interrogez toutes les cinq minutes, une commande attend en moyenne deux minutes et demie avant d'être vue, et jusqu'à cinq. Sur un stock lu par plusieurs canaux de vente, ce retard est exactement la fenêtre dans laquelle la même pièce se vend deux fois.
La vertu, qu'on oublie : elle est robuste et facile à réparer. Si un échange échoue, le suivant rattrape tout seul. Rien n'est perdu de façon définitive, parce que la question est reposée en permanence.
Ce que la notification change, et ce qu'elle suppose
Avec un webhook, le délai tombe à quelques secondes et les échanges à vide disparaissent. En échange, trois exigences apparaissent, et elles sont techniques.
Il faut une adresse joignable depuis l'extérieur. Le système émetteur doit pouvoir atteindre quelque chose chez vous. C'est une décision d'infrastructure, pas un réglage, et c'est souvent ce qui tranche le débat dans une entreprise dont les systèmes ne sont pas exposés.
Il faut accepter de recevoir deux fois le même message. Un émetteur qui n'a pas reçu votre accusé de réception réessaie, même si vous avez bien traité le message la première fois. Si le second passage crée une deuxième commande, vous avez un doublon dans l'entrepôt. La réception doit donc reconnaître un message déjà traité et ne rien faire — c'est ce que les développeurs appellent l'idempotence, et c'est le mot à retenir de cette fiche.
Il faut garder une reprise. Une notification perdue reste perdue : l'émetteur a essayé, il a abandonné, et personne ne repose la question. Les installations sérieuses combinent donc les deux approches : les notifications pour la vitesse, et une interrogation de rattrapage, une fois par heure ou une fois par nuit, pour vérifier que rien ne manque. Ce n'est pas de la redondance inutile, c'est le filet.
Où cela se joue dans un entrepôt
Les trois flux qui gagnent le plus à être immédiats sont toujours les mêmes.
La commande qui descend : plus tôt elle arrive, plus tôt elle entre dans la préparation, et plus large est la fenêtre avant l'heure limite d'expédition.
Le stock qui remonte : c'est le flux où le retard coûte de l'argent, parce qu'il se paie en survente. Quand plusieurs canaux lisent le même stock, l'arbitrage relève d'un OMS, mais aucun arbitrage ne vaut mieux que la fraîcheur du chiffre sur lequel il s'appuie.
Le statut d'expédition qui part vers le client : le numéro de suivi n'a de valeur que s'il arrive avant que le client ne pose la question.
Pour les systèmes de la liste publiée, ces échanges sont déjà portés par les connecteurs existants, et il n'y a pas d'adresse à exposer ni de notification à configurer : c'est ce que montre le catalogue des connecteurs. La question des notifications se pose pour le reste — un outil maison, un système ancien, un partenaire hors de la liste. Et pour l'échange structuré avec des partenaires commerciaux, la voie n'est ni l'un ni l'autre : c'est l'EDI, dont l'échange des messages passe par Transus.
Questions fréquentes
Qu'est-ce qu'un webhook ?
Un message qu'un système envoie tout seul vers une adresse que vous lui avez donnée, au moment où quelque chose se produit chez lui. Une commande est payée, et la boutique prévient l'entrepôt dans la seconde, sans que l'entrepôt ait eu à demander.
Quelle est la différence entre un webhook et une API ?
Le sens de l'appel. Avec une API, c'est vous qui appelez l'autre système pour lui demander ce qu'il a de nouveau. Avec un webhook, c'est lui qui vous appelle quand il a du nouveau. Les deux cohabitent très souvent : la notification dit qu'il s'est passé quelque chose, et l'appel qui suit va chercher le détail.
Pourquoi ne pas simplement interroger toutes les cinq minutes ?
C'est une méthode parfaitement valable, et elle a l'avantage d'être simple à réparer. Elle a deux défauts : la plupart des interrogations ne ramènent rien, et le délai moyen est la moitié de l'intervalle. Sur un stock partagé entre plusieurs canaux de vente, cinq minutes de retard suffisent à vendre deux fois la même pièce.
Que se passe-t-il si un webhook est perdu ?
Il est perdu, et c'est le vrai risque de la méthode. Un émetteur sérieux réessaie plusieurs fois, en espaçant les tentatives, puis abandonne. Côté réception, il faut donc deux choses : accepter de recevoir deux fois le même message sans conséquence, et garder une reprise par interrogation pour rattraper ce qui serait tombé.
Faut-il une adresse accessible depuis l'extérieur ?
Oui, c'est la contrainte principale. Le système émetteur doit pouvoir atteindre une adresse chez vous, ce qui demande une décision d'infrastructure. Si cette adresse ne peut pas être exposée, l'interrogation régulière reste la voie praticable.
Pour aller plus loin
Prêt à voir BizBloqs sur votre propre processus ?
Réservez une démo : nous parcourons votre flux d’entrepôt et de commandes de bout en bout — réception, stockage, préparation, expédition, retours — et nous vous disons honnêtement ce que BizBloqs changerait.
Deux questions sur votre propre exploitation
Combien de vos articles occupent un emplacement de prélèvement qu'ils vident moins d'une fois par mois ?
Partie un : Aménager un entrepôt ne commence pas par le rayonnage
Après votre dernière intégration, combien de systèmes détiennent une quantité pour le même article ? Nommez-les.