Introduction
Les notifications automatisées sont essentielles pour une communication transparente avec les partenaires et une réaction rapide aux écarts dans la distribution partenaire. Affilentra relie le suivi, le calcul des commissions et la facturation avec des notifications basées sur les rôles. Cet article décrit concrètement comment les marchands et les exploitants de réseaux peuvent configurer des notifications pour les conversions, les rétrofacturations et les paiements, utiliser des modèles personnalisés et définir des règles d'escalade pour les cas critiques d'AEL.
Pourquoi les notifications basées sur les événements sont utiles
Les notifications basées sur les événements garantissent que les partenaires et les équipes internes ne reçoivent que les informations pertinentes : une confirmation de conversion pour un éditeur, une alerte de rétrofacturation pour l'équipe opérations ou un avis de paiement pour le partenaire. L'automatisation réduit le travail manuel, accélère la résolution des incidents et assure la traçabilité pour la facturation et les audits.
Préparations : rôles et droits d'accès
Avant de créer des notifications, vérifiez les rôles dans Affilentra :
- Opérateur logiciel : gère les paramètres système, de sécurité et d'intégration.
- Marchand/Merchant : définit les données produit, les conditions et les règles de notification.
- Partenaire/Publisher : reçoit des liens de suivi personnels, des messages in‑app et des avis de paiement.
Assurez‑vous que seules les rôles autorisés peuvent créer ou modifier des notifications et que les modèles sont stockés de manière conservée pour les versions.
Étape 1 — Sélectionner et prioriser les événements
Définissez les événements qui doivent déclencher des notifications. Pour la plupart des marchands, au minimum ces trois événements sont pertinents :
- Conversion : mise en relation réussie, pertinente pour le reporting partenaire et l'information immédiate sur la commission.
- Chargeback : rétrofacturation ou annulation, critique pour la facturation et la surveillance de la fraude.
- Payout : paiement au partenaire, important pour la traçabilité et les demandes de support.
Priorisez selon l'urgence : les rétrofacturations méritent une priorité SLA plus élevée que les informations standards de conversion.
Étape 2 — Canaux : e‑mail, webhook, In‑App
Affilentra prend en charge trois canaux principaux. Choisissez le canal selon le destinataire :
- E‑Mail — adapté aux partenaires et destinataires externes ; utilisez des objets clairs et des contenus structurés.
- Webhook — idéal pour les intégrations avec CRM, ERP, systèmes de ticketing ou de monitoring. Prévoyez une authentification (par ex. HMAC) et des stratégies de nouvelle tentative.
- In‑App — rapide et contextuel pour les tableaux de bord partenaires et les utilisateurs internes dans Affilentra.
Combinez les canaux pour une livraison redondante sur les événements critiques pour les SLA (par ex. In‑App + Webhook vers un système d'incidents).
Étape 3 — Créer et personnaliser les modèles
Utilisez des modèles pour garantir la cohérence. Points importants :
- Définissez des placeholders standardisés, p. ex. {{merchant.name}}, {{partner.id}}, {{conversion.id}}, {{amount}}, {{payout.id}}, {{chargeback.reason}}.
- Séparez objet/titre, corps et éventuellement pied de page pour les e‑mails. Veillez à des lignes d'objet concises : elles augmentent les taux d'ouverture et réduisent les demandes au support.
- Utilisez des blocs conditionnels pour les détails qui n'apparaissent que si nécessaire (p. ex. motif de rétrofacturation pour les chargebacks).
Exemple : modèle d'e‑mail pour une conversion (Objet & Corps) :
Objet : Conversion confirmée — Commande {{conversion.id}} (Partenaire {{partner.id}})
Corps :
Bonjour {{partner.name}},
Votre recommandation a conduit à une conversion : commande {{conversion.id}}.
Montant : {{amount}}.
Statut de la commission : en cours de vérification. Détails dans le tableau de bord partenaire.
Exemple : payload webhook (structure simplifiée) :
{
"event": "conversion",
"conversion": {"id": "{{conversion.id}}", "amount": "{{amount}}", "status": "confirmed"},
"partner": {"id": "{{partner.id}}", "name": "{{partner.name}}"},
"merchant": {"id": "{{merchant.id}}"}
}
Étape 4 — Configuration des webhooks et sécurité
Lors de la configuration des webhooks, prenez en compte :
- URL du endpoint : système cible, modèle de réception (POST, JSON).
- Authentification : signature HMAC avec secret partagé ou Bearer‑Token.
- Logique de retry : configurez des répétitions avec backoff exponentiel et nombre maximal de tentatives.
- Idempotence : envoyez un identifiant d'événement (p. ex. conversion.id) pour éviter les traitements en double.
- Mode test : vérifiez le endpoint avec des événements de test avant de passer en production.
Étape 5 — Règles d'escalade pour les cas critiques SLA
Pour les chargebacks ou les paiements échoués, des parcours d'escalade doivent être définis. Procédure recommandée :
- Définissez des fenêtres SLA (p. ex. première réponse sous X heures). Fixez les délais en interne ; ne communiquez à l'extérieur que les informations nécessaires.
- Créez des niveaux d'escalade : 1. équipe opérations (In‑App + e‑mail), 2. responsable d'équipe (e‑mail + webhook vers le système de ticketing), 3. responsable incidents (push ou SMS via un service externe).
- Automatisez les transitions : si aucune action n'est effectuée dans le délai SLA, Affilentra envoie automatiquement le niveau suivant.
- Consignez toutes les étapes d'escalade dans l'historique d'audit pour assurer la traçabilité.
Règle d'exemple pour les chargebacks : si un chargeback est détecté et n'est pas traité dans les 4 heures, un webhook est déclenché vers le système de ticketing et une notification est envoyée au responsable d'équipe.
Tests, monitoring et maintenance
Des tests réguliers et une surveillance sont essentiels :
- Utilisez des environnements de staging et envoyez des événements de test avec différents états.
- Vérifiez les taux de délivrabilité des e-mails et les codes de réponse des webhooks.
- Gérez les modèles de manière centralisée : versionnez les modifications et conservez les anciennes versions pour vérification.
- Traductions : si vous avez des partenaires internationaux, maintenez des modèles spécifiques aux locales.
Exemple pratique : déroulement de bout en bout pour un chargeback en décollage vertical
1) Le chargeback est signalé par le prestataire de paiement et vérifié par Affilentra.
2) Affilentra déclenche un événement de chargeback : alerte in-app pour l'équipe opérations + e-mail au marchand + webhook vers le système de ticketing.
3) Si aucune prise en charge n'intervient dans le délai SLA défini, Affilentra envoie automatiquement un message d'escalade au chef d'équipe et déclenche une notification push vers le système d'incidents.
4) Après clôture, Affilentra documente le résultat et informe le partenaire du résultat final de la facturation.
Bonnes pratiques en bref
- Précision : seuls les événements pertinents aux partenaires, niveau de détail pour les destinataires internes.
- Standard de sécurité : webhooks signés et restrictions d'accès pour les modifications de modèles.
- Redondance : combinaison in-app, webhook et e-mail pour les événements critiques.
- Test & versioning : modifications d'abord en staging, versionner les modèles.
- Opérationnalisation : automatiser et auditer les chaînes d'escalade conformes aux SLA.
Conclusion et prochaine étape
Affilentra fournit les composants nécessaires pour rendre la communication avec les partenaires automatisée, traçable et sécurisée, en respectant des rôles clairement séparés. Avec des modèles de notification ciblés, des webhooks sécurisés et des parcours d'escalade définis, les informations de conversion, les alertes de chargeback et les notifications de paiement peuvent être gérées efficacement.
Choisissez le point d'entrée adapté et configurez votre système de notifications : Choisir un point d'entrée
Étape suivante
Essayer Affilentra soi‑même
Plateforme unifiée qui regroupe de manière transparente la mise à disposition des produits, le tracking, la validation des conversions, le calcul des commissions et le paiement selon des rôles clairement séparés ; option d'installation en self-hosted avec licence perpétuelle sans participation au chiffre d'affaires ; les marchands conservent le contrôle des produits, des conditions et des supports marketing ; les partenaires reçoivent des liens de tracking personnels et un historique des paiements consultable.