La fonctionnalité webhooks et callbacks de Post Affiliate Pro vous permet de notifier automatiquement les systèmes externes lorsque des événements spécifiques se produisent, tels que de nouvelles ventes, des inscriptions d’affiliés ou des approbations de commissions.
Disponible dans :
Post Affiliate Pro , Post Affiliate Pro Ultimate , Post Affiliate Network
Les webhooks (également appelés Application Callbacks ou URL de postback) sont des notifications HTTP automatisées que Post Affiliate Pro envoie aux systèmes externes lorsque des événements spécifiques se produisent. Au lieu de constamment interroger pour obtenir des mises à jour, vos systèmes connectés reçoivent des notifications instantanées au moment où quelque chose se passe dans votre programme d’affiliation.
Cette fonctionnalité est essentielle pour :
Post Affiliate Pro prend en charge deux types principaux de webhooks :
Ces webhooks sont déclenchés par des événements liés aux transactions :
| Événement déclencheur | Description |
|---|---|
| À la création | Se déclenche immédiatement lorsqu’une nouvelle transaction (vente, action, prospect) est enregistrée |
| À l’approbation | Se déclenche lorsqu’une transaction en attente est approuvée |
| Au refus | Se déclenche lorsqu’une transaction est refusée |
| Au remboursement/rétrofacturation | Se déclenche lorsqu’un remboursement ou une rétrofacturation est traité |
Vous pouvez configurer un seul webhook pour se déclencher sur plusieurs événements, ou créer des webhooks séparés pour chaque type d’événement.
Ces webhooks sont déclenchés par des événements d’inscription d’affiliés :
| Événement déclencheur | Description |
|---|---|
| À l’inscription | Se déclenche immédiatement lorsqu’un nouvel affilié complète le formulaire d’inscription |
| À l’approbation | Se déclenche lorsqu’un affilié en attente est approuvé par un marchand |
Post Affiliate Pro prend en charge trois types de requêtes HTTP pour les webhooks :
Les paramètres sont ajoutés à l’URL sous forme de paramètres de chaîne de requête.
https://votre-systeme.com/webhook?transactionid=abc123&commission=50.00&orderid=ORD-456
Les paramètres sont envoyés dans le corps de la requête en utilisant l’encodage de formulaire standard.
Content-Type: application/x-www-form-urlencoded
transactionid=abc123&commission=50.00&orderid=ORD-456
Les paramètres sont envoyés sous forme d’objet JSON dans le corps de la requête.
Content-Type: application/json
{"transactionid": "abc123", "commission": "50.00", "orderid": "ORD-456"}
Vous pouvez utiliser des variables dynamiques dans vos URL de webhook qui sont automatiquement remplacées par les valeurs réelles. Utilisez le format ${#nomvariable#} pour inclure une variable.
| Variable | Description |
|---|---|
${#transactionid#} | Identifiant unique de transaction |
${#visitorid#} | ID du visiteur (cookie de suivi) |
${#commission#} | Montant de la commission |
${#totalcost#} | Valeur totale de la commande |
${#fixedcost#} | Montant du coût fixe |
${#orderid#} | ID de commande de votre système e-commerce |
${#productid#} | ID du produit |
${#dateinserted#} | Date et heure de création de la transaction |
${#dateapproved#} | Date et heure d’approbation de la transaction |
${#tier#} | Niveau de palier de commission |
${#status#} | Statut de la transaction (Approuvé, En attente, Refusé) |
${#statuscode#} | Code de statut (A, P, D) |
${#type#} | Type de transaction (Vente, Action, etc.) |
| Variable | Description |
|---|---|
${#campaignid#} | Identifiant de campagne |
${#campaignname#} | Nom de la campagne |
${#bannerid#} | Identifiant de bannière |
${#channel#} | Nom du canal |
${#channel_code#} | Code du canal |
${#coupon_code#} | Code promo utilisé |
| Variable | Description |
|---|---|
${#userid#} | ID utilisateur de l’affilié |
${#refid#} | ID de parrainage de l’affilié |
| Variable | Description |
|---|---|
${#firstclicktime#} | Horodatage du premier clic |
${#firstclickreferer#} | URL référent du premier clic |
${#firstclickip#} | Adresse IP du premier clic |
${#firstclickdata1#} | Données personnalisées 1 du premier clic |
${#firstclickdata2#} | Données personnalisées 2 du premier clic |
${#lastclicktime#} | Horodatage du dernier clic |
${#lastclickreferer#} | URL référent du dernier clic |
${#lastclickip#} | Adresse IP du dernier clic |
${#lastclickdata1#} | Données personnalisées 1 du dernier clic |
${#lastclickdata2#} | Données personnalisées 2 du dernier clic |
| Variable | Description |
|---|---|
${#saledata1#} | Champ de données personnalisé 1 de la transaction |
${#saledata2#} | Champ de données personnalisé 2 de la transaction |
${#saledata3#} | Champ de données personnalisé 3 de la transaction |
${#saledata4#} | Champ de données personnalisé 4 de la transaction |
${#saledata5#} | Champ de données personnalisé 5 de la transaction |
| Variable | Description |
|---|---|
${#ip#} | Adresse IP du client |
${#countrycode#} | Code pays basé sur l’IP |
${#refererurl#} | URL référent |
| Variable | Description |
|---|---|
${#originalcurrency#} | Nom de la devise d’origine |
${#originalcurrencyvalue#} | Valeur de la devise d’origine |
${#originalcurrencyrate#} | Taux de change utilisé |
| Variable | Description |
|---|---|
${#merchantnote#} | Note visible par l’affilié |
${#systemnote#} | Note visible uniquement par le marchand |
${#actionName#} | Nom du type de commission d’action |
${#actionCode#} | Code du type de commission d’action |
Pour les webhooks d’inscription d’affiliés, vous pouvez utiliser les variables de profil d’affilié :
| Variable | Description |
|---|---|
${#username#} | Email/nom d’utilisateur de l’affilié |
${#firstname#} | Prénom de l’affilié |
${#lastname#} | Nom de famille de l’affilié |
${#name#} | Nom complet (prénom + nom) |
${#userId#} | ID utilisateur de l’affilié |
| Champs personnalisés | Tout champ de profil personnalisé par son code |
Par défaut, les webhooks sont exécutés uniquement pour les commissions de niveau 1 (directes). Vous pouvez activer l’option “Exécuter pour chaque niveau” pour déclencher les webhooks pour tous les niveaux de palier dans les structures de commission multi-niveaux.
C’est utile lorsque :
Vous pouvez configurer les webhooks pour être plus spécifiques :
Limitez le webhook à un type de commission spécifique (par ex., uniquement pour les commissions d’action “Ventes Premium”).
Créez des webhooks qui ne se déclenchent que pour un affilié spécifique. C’est utile pour :
Dans Post Affiliate Network, vous pouvez créer des webhooks spécifiques à un compte.
Post Affiliate Pro maintient un journal complet de toutes les exécutions de webhooks, accessible dans le panneau marchand sous Outils > Journal des callbacks.
Le journal affiche :
Si un webhook échoue (par ex., votre serveur est temporairement indisponible), Post Affiliate Pro réessaiera automatiquement la requête. Cela garantit une livraison fiable même pendant les pannes temporaires.
Les journaux de webhooks sont automatiquement nettoyés après un nombre de jours configurable (par défaut : 60 jours). Vous pouvez ajuster cela dans Configuration > Fonctionnalités > Application Callbacks.
Par défaut, les webhooks créés par les affiliés nécessitent l’approbation du marchand avant de devenir actifs. Les marchands peuvent :
Les webhooks ont trois statuts possibles :
Les marchands peuvent modifier le statut du webhook à tout moment depuis l’écran de gestion des webhooks.
Post Affiliate Pro peut envoyer des notifications par email pour les événements liés aux webhooks :
Ces notifications peuvent être activées ou désactivées dans Configuration > Notifications par email.
Envoyer les données de nouvelle vente à votre CRM lorsqu’une transaction est approuvée :
https://crm.exemple.com/api/sales?customer_order=${#orderid#}&value=${#totalcost#}&affiliate=${#refid#}
Notifier votre canal d’équipe lorsqu’un nouvel affilié s’inscrit :
https://hooks.slack.com/services/xxx/yyy?text=Nouvel+affilié:+${#firstname#}+${#lastname#}
Ajouter des clients à une séquence email après achat :
POST https://email.exemple.com/api/subscribers
Body: {"email": "${#saledata1#}", "purchase_value": "${#totalcost#}"}
Enregistrer les paiements de commission dans votre système comptable :
https://compta.exemple.com/webhook?affiliate_id=${#userid#}&commission=${#commission#}&order=${#orderid#}
Les webhooks (également appelés Application Callbacks) sont des requêtes HTTP que Post Affiliate Pro envoie automatiquement à une URL que vous spécifiez lorsque certains événements se produisent, comme une nouvelle vente, une approbation de commission ou une inscription d'affilié. Cela vous permet de vous intégrer avec des systèmes externes en temps réel.
Les webhooks peuvent être déclenchés par : la création d'une nouvelle transaction, l'approbation d'une transaction, le refus d'une transaction, les remboursements et rétrofacturations, une nouvelle inscription d'affilié et l'approbation d'un affilié. Vous pouvez configurer différentes URL pour différents événements.
Vous pouvez inclure n'importe quelles données de transaction ou d'affilié en utilisant des variables dynamiques. Pour les webhooks de ventes, vous pouvez utiliser plus de 40 variables, notamment l'ID de transaction, la commission, l'ID de commande, l'ID de produit, l'ID d'affilié, le nom de la campagne et les champs de données personnalisés. Pour les webhooks d'inscription, vous pouvez inclure les détails de l'affilié comme le nom, l'email et les champs de profil personnalisés.
Oui, Post Affiliate Pro prend en charge les types de requêtes GET, POST (form-urlencoded) et POST JSON. Vous pouvez choisir le format qui correspond le mieux aux exigences de votre système récepteur.
Connectez Post Affiliate Pro à votre CRM, plateforme email ou tout système externe grâce à de puissants webhooks et callbacks. Recevez des notifications en temps réel pour chaque événement important.
Découvrez comment exécuter des callbacks dans Post Affiliate Pro. Apprenez à configurer les URL de callback, à les sécuriser et à explorer des cas d'utilisation...
Découvrez le fonctionnement des rappels d'application dans Post Affiliate Pro. Découvrez des déclencheurs d'événements personnalisables pour les ventes, les pro...
Post Affiliate Pro s'integre avec plus de 200 plateformes incluant les passerelles de paiement, les systemes e-commerce, les outils CRM et les plateformes d'aut...
Rejoignez notre communauté de clients satisfaits et offrez un excellent support client avec Post Affiliate Pro.
