Webhook

Qu’est-ce qu’un Webhook ?

Un Webhook (aussi appelé HTTP callback ou reverse API) est un mécanisme dans lequel un système envoie lui-même une requête HTTP POST à une URL définie au préalable, lorsqu’un événement défini se produit en son sein — nouvelle facture, changement d’état d’une commande, réception d’un paiement. C’est l’inverse d’un appel API classique, où le client interroge le serveur (« tu as quelque chose de nouveau ? »). Un webhook est du push, un appel API classique est du pull.

Avantages des webhooks :

• Temps réel — l’événement est livré immédiatement, sans polling périodique
• Efficacité — ne surchargent pas les deux systèmes avec des appels vides
• Simplicité — la configuration se résume souvent à une URL + un token d’authentification

Problèmes typiques à prendre en compte lors de l’implémentation d’un webhook :

• Authentification — ajouter une signature HMAC ou un token pour vérifier l’expéditeur
• Logique de retry — si le système cible répond par une erreur (5xx), réessayer avec un backoff exponentiel
• Idempotence — le système cible doit gérer la réception du même événement deux fois
• Ordre de livraison — les webhooks peuvent ne pas arriver dans l’ordre

Dans l’écosystème SaaS, les webhooks sont le standard — Stripe, Shopify, Mailchimp, GoCardless et de nombreuses autres intégrations utilisent toutes le modèle webhook.

Quand l’utiliser ?

Les webhooks conviennent pour :

• La synchronisation entre systèmes (ERP ↔ boutique en ligne)
• Le déclenchement d’automatisation de workflow lors d’un événement
• Les notifications vers les canaux de communication (Slack, Teams)
• Les tableaux de bord en temps réel

Voir la page API, le module Flux de travail et les intégrations.

Termes associés

• API — modèle classique request/response. Voir /fr/glossaire/api.
• Workflow automation — les webhooks sont un déclencheur typique. Voir /fr/glossaire/workflow-automation.
• MCP — protocole alternatif pour les assistants IA. Voir /fr/glossaire/mcp.

Dans Modulario

Modulario expose des webhooks configurables pour chaque événement clé — création d’une facture, clôture d’un deal, changement d’état d’une commande. Le retry automatique avec signature assure une livraison fiable. Exemples et schémas sur /api.

Modulario fournit une interface de gestion des webhooks, où l’administrateur voit toutes les inscriptions actives, les journaux des 1 000 derniers appels (avec payload et réponse) et peut déclencher un « replay » pour la livraison des événements après une panne du système cible.