Webhook : c’est quoi ? Définition simple, exemples concrets (paiement Mobile Money, WhatsApp, formulaires) et comment l’utiliser avec n8n ou Make
G. CHRIST
Publié le 18 novembre 2026

Un client paie par Mobile Money sur votre site. Trois secondes plus tard, la commande passe en « payée », le reçu part par e-mail, l’équipe de livraison reçoit un message et une ligne s’ajoute dans votre tableau de suivi. Personne n’a rien touché. Derrière ce petit miracle, il n’y a presque jamais d’intelligence artificielle : il y a un webhook.
Le mot fait peur parce qu’il sonne technique. L’idée, elle, est très simple : au lieu de demander sans arrêt à un service « est-ce qu’il y a du nouveau ? », vous lui donnez une adresse, et c’est lui qui vous prévient dès qu’il se passe quelque chose. Chez Guelichweb, c’est une pièce que l’on retrouve dans la plupart des automatisations que nous concevons avec n8n ou Make. C’est aussi, à notre avis, la plus négligée : on la branche en dix minutes, on oublie de la sécuriser et de la surveiller, et le jour où elle tombe en panne, personne ne s’en aperçoit.
Ce guide répond donc à la question « webhook, c’est quoi ? » sans jargon inutile, puis va plus loin que les définitions habituelles : des exemples qui parlent à une PME, une ONG ou une institution d’Afrique francophone (paiement FedaPay ou KkiaPay, WhatsApp, formulaires, boutique en ligne), ce que disent vraiment les documentations officielles, et les règles à respecter pour qu’un webhook soit fiable. Les informations techniques ont été vérifiées le 18 novembre 2026 dans les documentations de FedaPay, KkiaPay, Meta, n8n, Make, WooCommerce et Stripe.
En bref
- Un webhook est une notification automatique : quand un événement se produit dans un service (paiement approuvé, message reçu, formulaire envoyé), ce service envoie aussitôt une requête HTTP, le plus souvent un POST au format JSON, vers une adresse que vous avez choisie.
- Avec une API, c’est vous qui allez chercher l’information. Avec un webhook, c’est l’information qui vient à vous. Les bonnes intégrations utilisent les deux.
- Pas besoin d’être développeur pour en recevoir un : n8n et Make créent l’adresse de réception pour vous.
- Un webhook qui touche à l’argent ou aux données personnelles doit être vérifié (signature ou secret), dédoublonné et surveillé. Sinon, il finit par créer des doubles reçus ou par s’arrêter en silence.
Webhook : la définition simple
Un webhook, c’est un message automatique envoyé d’une application à une autre au moment précis où un événement se produit. Le terme vient de l’anglais : web pour le protocole utilisé, hook (crochet) pour l’endroit où l’on vient « s’accrocher » à un logiciel. On parle parfois de « rappel HTTP » en français, mais personne n’utilise ce mot dans les interfaces : vous verrez partout « webhook ». D’après Wikipédia, le terme a été proposé en 2007 par le développeur Jeff Lindsay.
Concrètement, un webhook met en jeu trois éléments :
- L’émetteur : le service où quelque chose se passe. Une passerelle de paiement, WhatsApp, une boutique WooCommerce, un formulaire.
- L’événement : le fait précis qui déclenche l’envoi. « Transaction approuvée », « nouveau message reçu », « commande créée ».
- L’URL de réception (on dit aussi endpoint, ou point de terminaison) : une adresse web publique qui attend ces messages. Ce peut être une page de votre site, un serveur, ou un nœud dans n8n ou Make.
Quand l’événement se produit, l’émetteur envoie une requête à l’URL de réception, avec les détails de l’événement. Le récepteur répond par un code de succès (un code de la famille 200), et l’échange est terminé. Il dure souvent moins d’une seconde, et personne ne le regarde. C’est précisément pour ça qu’il faut le concevoir avec soin.
Ce que contient un webhook
Le contenu (on parle de « payload ») dépend du service. Pour donner une idée, voici une version simplifiée de ce que KkiaPay envoie quand un paiement réussit, d’après sa documentation :
{ "transactionId": "3iH6wjHJ3", "isPaymentSucces": true, "method": "MOBILE_MONEY", "amount": 1000, "fees": 19, "performedAt": "2024-03-20T08:55:22.883Z", "event": "transaction.success" }
Rien de magique : un identifiant de transaction, un statut, un moyen de paiement, un montant, une date et le nom de l’événement. Votre automatisation lit ces champs et décide quoi faire : valider la commande, générer un reçu, prévenir le client. Les noms de champs changent d’un service à l’autre, mais la logique reste la même.
Webhook ou API : qui appelle qui ?
On confond souvent les deux, parce qu’ils utilisent le même langage (HTTP et JSON). La différence tient en une phrase : avec une API, vous posez la question ; avec un webhook, on vous prévient.

Sans webhook, votre outil devrait interroger la passerelle de paiement toutes les cinq ou quinze minutes. C’est lent (le client attend), c’est du gaspillage (la plupart des réponses sont « rien de nouveau ») et, sur Make ou Zapier, chaque interrogation consomme des crédits. Avec un webhook, l’information arrive une seule fois, au bon moment.
Mais le webhook ne remplace pas l’API. Il signale ; l’API sert ensuite à relire le détail à jour, corriger une fiche ou rattraper un événement manqué. Pour un paiement, notre règle est simple : le webhook déclenche, l’API confirme, et c’est seulement après cette confirmation qu’on livre. Si la notion d’API reste floue pour vous, notre article API : c’est quoi ? explique la base avec des exemples ; nous ne le refaisons pas ici.
6 exemples concrets pour une PME, une ONG ou une institution
1. Le paiement Mobile Money confirmé (FedaPay, KkiaPay)
C’est l’exemple roi en Afrique de l’Ouest. FedaPay envoie par exemple un événement « transaction.approved » quand le paiement est validé, « transaction.declined » quand il échoue, « transaction.canceled » quand il est annulé (documentation FedaPay). KkiaPay, de son côté, notifie « transaction.success » ou « transaction.failed ». Une école qui encaisse des frais d’inscription, une ONG qui reçoit des dons ou une boutique qui vend en ligne peuvent ainsi valider automatiquement le dossier, envoyer le reçu et prévenir l’équipe. Pour choisir et intégrer une passerelle, voyez notre guide passerelle de paiement mobile money.
2. Le message WhatsApp reçu (WhatsApp Business Platform)
Quand un client écrit à votre numéro connecté à l’API WhatsApp, Meta envoie un webhook à votre serveur avec le texte du message, l’expéditeur et l’heure. C’est ce webhook qui permet à un chatbot de répondre, à un agent humain d’être alerté ou à une conversation d’être enregistrée dans votre CRM. Meta l’utilise aussi pour vous dire si vos messages ont été délivrés et lus, ou si la qualité d’un modèle de message baisse (documentation Meta). Sans webhook, pas de chatbot WhatsApp digne de ce nom. Nous détaillons ce que l’API permet dans WhatsApp Business API : c’est quoi ? et ce qu’un bot peut réellement faire dans Chatbot WhatsApp : ce qu’il fait vraiment.
3. Le formulaire envoyé
Un formulaire de contact ou d’inscription peut envoyer ses réponses vers un webhook au lieu (ou en plus) d’un simple e-mail. La demande arrive alors directement dans un Google Sheets, un CRM ou un canal d’équipe, avec un accusé de réception automatique. Beaucoup d’extensions de formulaire WordPress proposent cette option. Google Forms n’a pas de webhook natif, mais un petit script Apps Script déclenché à chaque réponse peut en envoyer un. Pour la conception du formulaire lui-même, voyez formulaire de contact pour site web et comment faire un Google Form.
4. La commande en ligne (WooCommerce)
WooCommerce peut déclencher un webhook à chaque création ou modification de commande, de produit, de client ou de coupon (documentation WooCommerce). Une nouvelle commande peut ainsi mettre à jour un fichier de stock, prévenir le livreur sur WhatsApp et créer la facture. Si vous préparez une boutique, notre guide créer une boutique en ligne au Bénin montre où ce maillon se place.
5. Les alertes internes (Discord, Slack, Teams)
Certains outils fonctionnent dans l’autre sens : ils vous donnent une URL de webhook « entrant » à laquelle vous envoyez un message pour qu’il apparaisse dans un canal. C’est ce que les gens cherchent quand ils tapent « webhook Discord c’est quoi » : une adresse qui permet à un programme de poster dans un salon sans bot complet. Utile pour être alerté quand un paiement important arrive, quand un formulaire urgent est envoyé ou quand une automatisation échoue.
6. Le suivi d’activités d’une ONG ou d’une institution
Une inscription à une formation peut déclencher l’envoi du programme, l’ajout à une liste de participants et, après l’événement, la génération d’une attestation. Une demande citoyenne déposée en ligne peut créer un dossier, attribuer un numéro et envoyer un accusé de réception. Rien de spectaculaire, mais c’est exactement le genre de tâches répétitives qui mangent des heures de secrétariat. Notre article automatisation des tâches aide à repérer celles qui valent la peine d’être automatisées.
Ce que disent vraiment les documentations (et pourquoi c’est important)
Les définitions générales s’arrêtent souvent à « le service envoie une requête ». Les documentations officielles, elles, contiennent les détails qui font la différence entre une automatisation fiable et une automatisation qui casse un samedi soir. Voici ce que nous avons relevé le 18 novembre 2026 :
- FedaPay attend une réponse 2xx ; toute autre réponse est un échec. En cas d’échec, il réessaie jusqu’à 9 fois à intervalles croissants, puis désactive automatiquement le webhook après 10 essais sans succès (sauf si vous décochez l’option correspondante). Les webhooks sont signés via l’en-tête X-FEDAPAY-SIGNATURE, avec un horodatage pour empêcher la réutilisation d’un message intercepté, et seules les versions TLS 1.2 et 1.3 sont acceptées. Un bouton « Re-déclencher » dans les logs permet de renvoyer un événement (source).
- KkiaPay réessaie 5 fois en cas de non-réception et considère tout code hors de la famille 2xx, y compris les redirections 3xx, comme un échec. Chaque requête porte un en-tête x-kkiapay-secret basé sur le « secret hash » que vous définissez dans le tableau de bord (source).
- Meta (WhatsApp) réessaie pendant 7 jours maximum si votre serveur ne répond pas 200, ce qui peut produire des notifications en double. Les payloads peuvent atteindre 3 Mo (source). Au moment de la configuration, Meta envoie une requête de vérification avec un paramètre hub.challenge que votre serveur doit renvoyer, et signe ensuite chaque notification dans l’en-tête X-Hub-Signature-256 (source).
- WooCommerce envoie un « ping » à l’URL la première fois que vous activez le webhook, et le désactive après plus de cinq échecs consécutifs. Un secret permet de signer chaque envoi (source).
- Stripe, que vous croiserez si vous vendez à l’international, réessaie pendant 3 jours en production, rappelle qu’un même événement peut arriver plusieurs fois et recommande de répondre 2xx rapidement avant tout traitement lourd (source).
Source : documentation FedaPay, « Webhooks et Événements » (docs.fedapay.com), capture du 18/11/2026.
La leçon est claire : un webhook peut arriver deux fois, arriver en retard, ou ne plus arriver du tout si votre serveur a été en panne trop longtemps. Toute automatisation sérieuse doit être construite en partant de ces trois hypothèses.
Source : Meta for Developers, « WhatsApp webhooks » (developers.facebook.com), capture du 18/11/2026.
Recevoir son premier webhook avec n8n
n8n est l’outil sur lequel repose notre offre de chatbot WhatsApp, notamment parce qu’il peut être installé sur votre propre serveur (voir n8n, c’est quoi ?). Son nœud Webhook crée l’URL de réception pour vous. Les étapes :
- Créez un workflow et ajoutez le nœud Webhook comme déclencheur.
- Choisissez la méthode HTTP (POST dans la grande majorité des cas) et, si vous voulez une adresse lisible, un chemin personnalisé.
- Copiez l’URL de test, cliquez sur « Listen for test event », puis déclenchez un événement depuis le service émetteur (beaucoup proposent un bouton « Tester » ou un mode sandbox). Les données s’affichent dans n8n : vous voyez exactement ce que le service envoie.
- Construisez la suite : vérification, filtre, écriture dans Google Sheets ou dans votre CRM, message WhatsApp, e-mail.
- Remplacez l’URL de test par l’URL de production dans le service émetteur, puis publiez (activez) le workflow.
Source : documentation n8n, nœud « Webhook » (docs.n8n.io), capture du 18/11/2026.
Le piège le plus classique ? Laisser l’URL de test dans le service émetteur. Selon la documentation n8n, l’URL de test ne fonctionne que lorsque vous êtes en écoute dans l’éditeur, et l’URL de production n’est enregistrée que quand le workflow est publié. Tout marche pendant la démonstration, puis plus rien le lendemain.
Le nœud offre aussi des protections utiles : authentification (Basic, Header ou JWT), liste d’adresses IP autorisées, option « Only Run If » pour ignorer les requêtes qui ne correspondent pas à une condition, et choix du moment où n8n répond (immédiatement, ou à la fin du workflow). La taille maximale d’un payload est de 16 Mo par défaut. Pour un webhook de paiement, nous répondons immédiatement et traitons ensuite.
Et avec Make (ou Zapier) ?
Make fonctionne sur le même principe avec son module Custom webhook, qui génère une URL à laquelle n’importe quel service peut envoyer des données. Beaucoup d’applications ont aussi des déclencheurs « instantanés », qui sont des webhooks préconfigurés.
Source : centre d’aide Make, « Webhooks » (help.make.com), capture du 18/11/2026.
Quelques points de la documentation Make à connaître avant de vous lancer :
- Chaque webhook a sa file d’attente. Sa taille dépend de votre abonnement ; quand elle est pleine, Make rejette les nouvelles données.
- Make traite jusqu’à 300 requêtes entrantes par tranche de 10 secondes ; au-delà, il répond par une erreur 429.
- Un webhook qui n’est relié à aucun scénario depuis plus de 5 jours est désactivé et renvoie une erreur 410.
- Les journaux des webhooks sont conservés 3 jours (30 jours sur l’offre Enterprise). Si un problème survient, il faut le voir vite.
- Par défaut, les exécutions déclenchées par webhook tournent en parallèle. Si l’ordre compte (stock, numérotation de reçus), activez le traitement des données dans l’ordre.
Zapier propose aussi un module de webhooks. Pour comparer les trois outils sur le prix, l’hébergement des données et la facilité, lisez n8n ou Make et Zapier, c’est quoi ?.
Les règles d’or d’un webhook fiable et sécurisé
Une URL de webhook est une porte ouverte sur internet. Si quelqu’un la découvre et que vous ne vérifiez rien, il peut vous envoyer un faux « paiement approuvé ». Voici le circuit que nous mettons en place dès qu’il y a de l’argent ou des données personnelles en jeu :

- Toujours en HTTPS, avec un certificat valide. FedaPay et Meta l’exigent de toute façon.
- Vérifier l’origine : signature (FedaPay, Meta, WooCommerce, Stripe) ou secret partagé (KkiaPay). Une requête qui ne passe pas la vérification est rejetée, point.
- Garder les secrets hors du code visible : jamais dans une page web, jamais dans un message WhatsApp, jamais dans un fichier partagé. Dans n8n ou Make, utilisez les identifiants (credentials) ou des variables protégées.
- Refuser les messages trop anciens quand le service fournit un horodatage. C’est ce qui empêche de rejouer un webhook intercepté.
- Répondre vite, traiter ensuite. Le service émetteur attend une réponse rapide ; si votre traitement prend du temps, il croit à un échec et renvoie le message.
- Dédoublonner : enregistrez l’identifiant de chaque événement traité et ignorez ceux que vous avez déjà vus. Un paiement reçu deux fois ne doit jamais produire deux reçus.
- Confirmer par l’API avant toute action irréversible (livrer, débloquer un accès, valider une inscription payante).
- N’écouter que les événements utiles. Recevoir tout « au cas où » surcharge votre système et vos journaux.
Ces règles ne sont pas de la paranoïa. Elles reprennent, presque mot pour mot, les bonnes pratiques publiées par FedaPay, Stripe et Meta. Si un prestataire vous livre un webhook de paiement sans vérification de signature ni gestion des doublons, demandez-lui pourquoi.
Les pannes classiques (et comment les éviter)
- Le récepteur est un ordinateur du bureau. Une coupure de courant ou d’internet, et les webhooks échouent. Après assez d’échecs, FedaPay ou WooCommerce désactivent le webhook. Le récepteur doit tourner sur un serveur en ligne, pas sur un PC. Pour choisir où héberger, voyez notre guide sur l’hébergement web en Afrique de l’Ouest.
- Le webhook a été désactivé en silence. Personne ne regarde le tableau de bord de la passerelle. Prévoyez une alerte : si aucun paiement n’a été reçu depuis un délai anormal pour votre activité, quelqu’un est prévenu.
- Une redirection casse tout. Votre site est passé de http à https, ou de « www » à sans « www », et l’ancienne URL redirige. Pour KkiaPay, une réponse 3xx compte comme un échec. Utilisez toujours l’adresse finale exacte.
- Le traitement est trop long. Génération d’un PDF, appel à une IA, envoi de plusieurs messages : si tout se fait avant de répondre, le service considère que vous n’avez pas répondu et renvoie l’événement. Résultat : des doublons.
- Le certificat SSL a expiré. Les webhooks s’arrêtent du jour au lendemain. Un renouvellement automatique et une surveillance évitent ce piège.
- L’URL de test est restée en production (voir plus haut pour n8n). Vérifiez-le systématiquement à la mise en ligne.
- Les événements arrivent dans le désordre. Une mise à jour peut arriver avant la création. Ne vous fiez pas à l’ordre d’arrivée : relisez l’état réel par l’API quand c’est important.
Surveiller sans y passer ses journées
Trois habitudes suffisent dans la plupart des cas. D’abord, un journal : chaque webhook reçu laisse une ligne (heure, événement, identifiant, résultat). Ensuite, une alerte d’échec : si le workflow plante, un message part sur WhatsApp ou par e-mail à la personne responsable. Enfin, un rapprochement quotidien pour les paiements : une petite tâche compare chaque soir les transactions de la passerelle (lues par l’API) avec les commandes validées chez vous. Le jour où un webhook a été perdu, vous le voyez le soir même, et pas à la fin du mois.
Tester un webhook sans tout casser
Avant de brancher un vrai service, il est utile de voir à quoi ressemble ce qu’il envoie :
- Le mode test (sandbox) du service : FedaPay et KkiaPay ont des environnements de test, avec des clés distinctes des clés réelles. Faites tous vos essais là.
- Le bouton de test du service : KkiaPay propose un test après la création du webhook, Meta permet d’envoyer une notification d’essai depuis le tableau de bord de l’application, WooCommerce envoie un ping à l’activation.
- L’URL de test de n8n ou l’écoute d’un module Make, qui affichent les données reçues.
- Un service d’inspection public comme webhook.site, pratique pour voir une requête brute. N’y envoyez jamais de données réelles de clients : c’est un tiers.
Pour un développement local, Stripe et d’autres mentionnent des outils de tunnel comme ngrok, qui donnent une adresse publique temporaire à votre machine. Très bien pour tester ; jamais pour la production.
Webhooks et données personnelles : le point qu’on oublie
Un webhook transporte souvent des numéros de téléphone, des noms, des montants, parfois le contenu de messages WhatsApp. Ces données passent par votre outil d’automatisation et peuvent y rester : Make, par exemple, conserve les données en file d’attente jusqu’à leur traitement, et les journaux pendant plusieurs jours. Posez-vous trois questions : où transitent ces données, combien de temps sont-elles conservées, et qui y a accès ? Au Bénin, le cadre de protection des données personnelles est suivi par l’APDP ; une ONG financée par des bailleurs européens aura souvent aussi des exigences liées au RGPD. Un n8n hébergé sur votre propre serveur donne plus de contrôle, à condition qu’il soit bien entretenu.
Faut-il un développeur ? Combien ça coûte ?
Pour recevoir un webhook dans n8n ou Make et écrire une ligne dans un Google Sheets, non : une personne à l’aise avec les outils numériques peut y arriver en suivant la documentation. Notre guide Google Sheets, c’est quoi ? peut servir de point de départ pour la partie tableau.
Dès qu’il y a de l’argent, des données sensibles ou plusieurs systèmes à synchroniser (site, passerelle, WhatsApp, CRM, comptabilité), notre avis est tranché : faites-vous accompagner, au moins pour la conception et la mise en production. Le coût d’un webhook mal conçu ne se voit pas tout de suite ; il se voit le jour où cinquante clients ont payé et n’ont rien reçu.
Chez Guelichweb, nous ne vendons pas de forfait « webhook » au prix fixe : chaque projet dépend des outils déjà en place et du niveau de sécurité nécessaire. Nous établissons un devis après diagnostic, comme indiqué sur notre page offres. Pour comprendre ce qui fait varier un budget, lisez combien coûte une automatisation IA au Bénin, et pour l’exemple le plus demandé, notre page chatbot WhatsApp avec n8n au Bénin.
Questions fréquentes sur les webhooks
Un webhook, c’est gratuit ?
Le mécanisme lui-même est gratuit : c’est une simple requête web. Ce qui peut coûter, c’est l’outil qui le reçoit (abonnement Make ou Zapier, serveur pour n8n) et le temps de conception. Certains services réservent les webhooks à leurs offres payantes ; vérifiez au cas par cas.
Quelle est la différence entre une API et un webhook ?
Avec une API, votre outil demande l’information quand il en a besoin. Avec un webhook, le service envoie l’information dès qu’un événement se produit. Le webhook est plus rapide et plus économe ; l’API permet de vérifier, corriger et rattraper. Les deux se complètent.
C’est quoi une URL de webhook ?
C’est l’adresse web à laquelle le service envoie ses notifications. Vous la créez dans votre outil (n8n, Make, votre site) et vous la collez dans les paramètres du service émetteur. Elle doit être publique, en HTTPS, et ne doit pas être diffusée.
C’est quoi un webhook Discord ?
C’est une URL fournie par Discord qui permet à un programme de publier des messages dans un salon, sans créer de bot complet. Le principe est le même que pour Slack ou Teams : on parle de webhook « entrant ».
Comment tester un webhook ?
Utilisez le mode test du service émetteur, son bouton d’envoi d’essai s’il existe, et l’URL de test de n8n ou l’écoute d’un module Make pour voir les données reçues. Un inspecteur public comme webhook.site aide pour une première découverte, sans données réelles.
Que se passe-t-il si mon serveur est en panne ?
La plupart des services réessaient : 9 fois pour FedaPay, 5 fois pour KkiaPay, pendant 7 jours pour Meta, pendant 3 jours pour Stripe. Mais certains désactivent le webhook après trop d’échecs (FedaPay, WooCommerce). D’où l’importance d’un serveur fiable, d’une alerte et d’un rapprochement par l’API.
Peut-on utiliser des webhooks sans site web ?
Oui. Un outil comme n8n ou Make fournit lui-même l’URL de réception. Vous pouvez par exemple recevoir les paiements d’un lien de paiement ou les messages WhatsApp sans avoir de site.
Pour finir
Un webhook, c’est une sonnette : le service appuie, votre système ouvre. Bien installé, il rend vos automatisations instantanées et économes. Mal installé, il sonne deux fois, sonne pour un inconnu, ou ne sonne plus du tout sans que personne le remarque. La différence ne tient pas à l’outil choisi mais à quelques règles : vérifier, répondre vite, dédoublonner, confirmer, surveiller.
Vous voulez connecter vos paiements Mobile Money, votre WhatsApp ou vos formulaires à vos outils sans craindre la panne silencieuse ? Contactez Guelichweb : nous regardons d’abord ce que vous utilisez déjà, puis nous vous disons franchement ce qui mérite d’être automatisé, et comment le faire proprement. Vous pouvez aussi parcourir nos services.



