Webhook : comment synchroniser deux outils en direct ?
En bref
Un webhook est un message qu'un logiciel envoie automatiquement à un autre dès qu'un événement se produit : une commande payée, un dossier validé. L'outil destinataire est prévenu tout de suite, au lieu de demander sans cesse « du nouveau ? ». C'est la méthode la plus réactive, mais elle exige une adresse de réception fiable et une gestion des échecs.
Quand deux logiciels doivent rester à jour l'un par rapport à l'autre, il existe deux façons de faire : interroger régulièrement, ou se faire prévenir. La seconde repose sur les webhooks. Voici ce que recouvre ce mot et quand il est justifié.
Deux méthodes pour rester à jour
| Interrogation régulière | Webhook | |
|---|---|---|
| Principe | Votre outil demande périodiquement s'il y a du nouveau. | L'autre outil vous envoie un message dès qu'un événement se produit. |
| Réactivité | Dépend de l'intervalle choisi. | Quasi immédiate. |
| Charge | Beaucoup de demandes pour rien quand il ne se passe rien. | Un message seulement quand il y a une nouveauté. |
| Si l'autre outil est indisponible | On réessaiera à la demande suivante. | Il faut prévoir une file d'attente et des tentatives. |
| Mise en place | Simple : un programme qui tourne à intervalles fixes. | Il faut exposer une adresse accessible et la sécuriser. |
Comment fonctionne un webhook
Vous indiquez au logiciel émetteur une adresse web à appeler, et les événements qui vous intéressent. À chaque événement, il envoie à cette adresse un petit message contenant les informations utiles. Votre application le reçoit, le comprend et agit : créer une fiche, changer un statut, déclencher un envoi.
Le mot « direct » mérite une nuance. Le message part tout de suite, mais il peut être retardé si le réseau ou votre serveur est lent. Une synchronisation par webhook est très rapide, pas instantanée au sens strict.
Les précautions indispensables
- Vérifier l'expéditeur : l'adresse de réception est publique. Sans contrôle, n'importe qui peut y envoyer un faux message. Les éditeurs sérieux fournissent une signature à vérifier, ou un secret partagé.
- Utiliser HTTPS pour que le contenu du message ne circule pas en clair.
- Accepter les répétitions : un même événement peut arriver deux fois. Votre application doit reconnaître qu'elle l'a déjà traité et ne rien faire la seconde fois.
- Répondre vite : accusez réception immédiatement, puis effectuez le traitement à part. Un traitement long fait croire à l'émetteur que l'envoi a échoué.
- Prévoir les échecs : si votre serveur est indisponible, les messages doivent être rejoués. Vérifiez ce que fait l'émetteur, et conservez de votre côté une trace des messages reçus.
Quand le webhook n'est pas le bon choix
La réactivité n'est pas toujours nécessaire. Une reprise complète de catalogue, un export comptable ou un rapprochement de fin de journée se prêtent mieux à un traitement groupé, lancé une fois par nuit. Le webhook se justifie quand un délai ferait perdre quelque chose de concret : un client qui attend une confirmation, un technicien qui doit être prévenu, un stock qui risque d'être vendu deux fois.
Comment surveiller une synchronisation
- Conserver un journal des messages reçus, avec leur résultat.
- Compter les échecs et déclencher une alerte au-delà d'un seuil que vous fixez.
- Prévoir un moyen de rejouer manuellement un événement manqué.
- Contrôler périodiquement que les deux outils affichent bien les mêmes totaux.
Ce dernier point est souvent oublié : même bien conçue, une synchronisation dérive avec le temps. Une comparaison régulière des volumes de chaque côté révèle les écarts avant les utilisateurs. La supervision de ces échanges relève de la maintenance courante. NexSecure met en place et surveille ces liaisons dans le cadre de son offre de développement web sur mesure.
Questions fréquentes
Un webhook est-il sécurisé ?
Il le devient si l'adresse de réception est en HTTPS et si la signature envoyée par l'émetteur est vérifiée à chaque message. Sans cette vérification, l'adresse accepte n'importe quel envoi.
Que se passe-t-il si mon serveur est arrêté ?
Les messages émis pendant l'arrêt sont perdus, sauf si l'émetteur prévoit de nouvelles tentatives. Vérifiez ce point dans sa documentation et prévoyez un rattrapage.
Faut-il un webhook pour chaque type d'événement ?
Non. Une même adresse peut recevoir plusieurs types d'événements, le message indiquant de quoi il s'agit. Ne vous abonnez qu'aux événements que vous traitez réellement.
Quelle différence entre webhook et API ?
Une API attend qu'on l'interroge. Un webhook part de lui-même vers vous. Les deux coexistent souvent : le webhook prévient, puis votre outil interroge l'API pour obtenir le détail.
Service lié
Articles liés
Rédigé par l'équipe NexSecure. Responsable de la publication : Yohann Toumine. Dernière mise à jour le 11 septembre 2026.
Une question sur votre situation ? Parler de votre projet