Comment fonctionnent les webhooks Kooneo : événements, données envoyées et configuration
Les webhooks Kooneo permettent d'envoyer automatiquement des informations vers un outil externe (Make, Zapier, FluentCRM, un CRM…) chaque fois qu'un événement se produit dans votre compte : un paiement, une commande, un remboursement, etc.
À quoi sert un webhook ?
Un webhook est une notification automatique. Dès qu'un événement a lieu dans Kooneo, votre plateforme envoie un message contenant les détails de cet événement vers une adresse que vous avez définie. L'outil qui reçoit ce message peut alors déclencher une action de son côté : ajouter un contact, envoyer un email, mettre à jour une fiche client…
Quels événements déclenchent un webhook ?
- Nouveau paiement ou 1er paiement récurrent
- Nouveau paiement récurrent
- Paiement récurrent échoué
- Abonnement annulé
- Remboursement
- Nouvelle commande
Comment configurer un webhook ?
- Récupérez l'URL de réception
- Cette URL est fournie par l'outil qui va recevoir les données (Make, Zapier, FluentCRM…).
- Il s'agit d'une URL technique de type Incoming Webhook, générée par cet outil.
- Ajoutez le webhook dans Kooneo
- Rendez-vous dans Outils puis Webhooks.
- Collez l'URL de réception et sélectionnez les événements à transmettre.
- Testez avant de passer en production
- Depuis l'interface Webhooks, vous pouvez envoyer des données de test pour chaque type d'événement vers votre URL.
- Cela vous permet de voir la structure exacte des données reçues côté outil externe avant de l'utiliser pour de vrai.
💡 Le test est le moyen le plus rapide d'avoir une vue concrète des données transmises. Faites-le toujours avant de connecter un automatisme en production.
Quelles données Kooneo envoie-t-il ?
Le contenu est transmis au format JSON, dans le corps de la requête. Il contient notamment :
- Type d'événement : par exemple un nouveau paiement.
- Informations client : prénom, nom, email, adresse, code postal, ville, pays, téléphone, numéro de TVA.
- Informations de facturation : montant, frais de paiement, numéro de facture, mode de paiement, devise, code promo.
- Identifiants : numéro de commande, numéro d'abonnement, identifiant de transaction.
- Détail des produits : pour chaque produit, son identifiant, sa référence, son nom, son prix, sa quantité, sa remise et sa TVA.
- Date de l'événement.
💡 Le bloc products contient l'identifiant et la référence de chaque produit concerné. C'est cette information qui permet à votre outil externe de distinguer une formation ou un pack d'un autre, et de filtrer les actions en conséquence.
Peut-on créer un webhook par produit ?
Pour le moment, les webhooks se configurent par type d'événement, pas par produit. Un même webhook est déclenché pour tous les produits.
En revanche, comme le détail des produits est inclus dans les données envoyées, votre outil externe peut filtrer lui-même : il lui suffit de lire l'identifiant ou la référence du produit dans le message reçu pour ne déclencher une action que sur le produit voulu.
Que se passe-t-il en cas d'échec ?
Si l'envoi d'un webhook échoue, Kooneo retente automatiquement l'opération jusqu'à 3 fois.
⚠️ Un journal des webhooks existe côté Kooneo mais n'est pas encore accessible depuis votre interface. Pour vérifier la bonne réception des données, appuyez-vous sur les logs de votre outil externe (Make, Zapier…) et sur la fonction de test décrite plus haut.
Webhook : notifier ou synchroniser ?
Un webhook sert à transmettre l'information d'un événement. Ce que l'outil externe en fait dépend ensuite de ses propres possibilités.
Si votre outil de réception (ou un connecteur comme Make ou Zapier) le permet, vous pouvez aller au-delà d'une simple notification : créer un contact, mettre à jour une fiche, ou synchroniser un compte utilisateur sur un site externe. Kooneo fournit la donnée ; l'action finale est gérée par l'outil qui la reçoit.
💡 Vous utilisez un outil spécifique (FluentCRM, un CRM, un site WordPress…) et vous avez un doute sur la marche à suivre ? Indiquez-le au support, nous pourrons vous orienter plus précisément.
Récapitulatif
| Question | Réponse |
|---|---|
| Format des données | ✅ JSON, dans le corps de la requête |
| Identifiant produit dans le message | ✅ Oui (bloc products) |
| Nouvelles tentatives en cas d'échec | ✅ Jusqu'à 3 fois, automatiquement |
| Webhook configurable par produit | ❌ Non, par type d'événement |
| Journal des webhooks côté vendeur | ⚠️ Pas encore disponible dans l'interface |
Article connexe
Un doute ou une question technique sur vos webhooks ? Contacter le support utilisateur.