Connexion des plateformes d'examen externes

Intégration de la Plateforme d'Avis Externe

Connectez votre plateforme d'avis tierce existante à LoyaltyTree pour synchroniser les avis et attribuer automatiquement des graines aux clients.

Vue d'ensemble

Si vous utilisez déjà une plateforme d'avis comme Judge.me, Loox ou Yotpo, vous pouvez l'intégrer à LoyaltyTree au lieu de passer à notre système d'avis natif. Cela vous permet de :

• Conserver vos avis existants : Pas besoin de migrer ou de recommencer
• Attribuer des graines pour les avis : Les clients gagnent des récompenses de fidélité lorsqu'ils laissent des avis
• Expérience client unifiée : Les avis contribuent à leur parcours de fidélité global
• Synchronisation automatique : Les avis sont transférés dans LoyaltyTree via des webhooks

Étape 1 : Accéder aux Paramètres d'Avis

1. Naviguez vers Magasins dans votre administration LoyaltyTree
2. Trouvez votre carte de magasin et cliquez sur le bouton Paramètres d'Avis 
3. Allez à l'onglet Paramètres

Étape 2 : Sélectionner le Mode de Plateforme Externe

Dans les Paramètres du Système d'Avis :

1. Trouvez le menu déroulant Système d'Avis
2. Changez-le de "LoyaltyTree Natif" à Plateforme Externe
3. Assurez-vous que Activer le Système d'Avis est coché

Étape 3 : Choisir Votre Plateforme d'Avis

Sélectionnez votre fournisseur d'avis dans le menu déroulant Plateforme d'Avis :

Étape 4 : Activer le Traitement des Webhooks

Cochez l'option Activer le Traitement des Webhooks. Cela permet à LoyaltyTree de recevoir et de traiter les données d'avis de votre plateforme externe.

Étape 5 : Configurer l'URL du Webhook

Une fois que vous avez sélectionné une plateforme, LoyaltyTree génère une URL de Webhook unique pour votre magasin.

Copiez votre URL de Webhook :

1. Trouvez le champ URL de Webhook dans le panneau d'intégration
2. Cliquez sur le bouton Copier pour copier l'URL complète
3. Gardez cette URL en sécurité - elle est unique à votre magasin

Ajoutez le Webhook à Votre Plateforme d'Avis :

Les étapes exactes varient selon la plateforme, mais généralement :

1. Allez dans les paramètres d'administration de votre plateforme d'avis
2. Trouvez la section Webhooks ou Intégrations
3. Ajoutez un nouveau webhook avec l'URL que vous avez copiée
4. Sélectionnez l'événement Avis Créé ou Nouvel Avis
5. Enregistrez votre configuration de webhook

Étape 6 : Secret de Webhook (Optionnel)

Pour une sécurité accrue, vous pouvez configurer un Secret de Webhook pour vérifier que les webhooks entrants sont authentiques.

Comment cela fonctionne :

1. Entrez une clé secrète dans le champ Secret de Webhook
2. Configurez votre plateforme d'avis pour signer les requêtes avec ce secret
3. LoyaltyTree vérifiera la signature en utilisant l'en-tête x-webhook-signature ou x-signature

Note : Toutes les plateformes ne prennent pas en charge les signatures de webhook. Si la vôtre ne le fait pas, vous pouvez laisser ce champ vide.

Étape 7 : Option Générique/Personnalisée - Format JSON Attendu

Lorsque votre plateforme d'avis envoie un webhook, LoyaltyTree s'attend au format de données suivant :

{
  "customer_email": "customer@example.com",
  "rating": 5,
  "body": "Super produit !",
  "has_photos": true,
  "product_id": "12345",
  "product_title": "Nom du Produit"
}

Champs Requis :

Support du Format Imbriqué :

LoyaltyTree prend également en charge les formats de données imbriqués couramment utilisés par les plateformes d'avis :

{
  "data": {
    "email": "customer@example.com",
    "rating": 5,
    "body": "Super produit !"
  }
}

Récompenses de Graines pour les Avis Externes

Note : Les allocations de graines pour les avis sont gérées au niveau du Groupe de Fidélité. Allez dans Paramètres de Fidélité → Paramètres de Graines de votre magasin pour configurer combien de graines les clients gagnent pour les avis, les bonus photo et les bonus pour le premier avis.

Lorsqu'un webhook d'avis est reçu :

1. LoyaltyTree associe le customer_email à un client existant
2. Si trouvé, des graines sont attribuées en fonction de votre configuration des Paramètres de Graines
3. Les avis photo peuvent gagner des graines bonus si configurés
4. Les premiers évaluateurs peuvent gagner des graines bonus supplémentaires

Dépannage

Les avis ne se synchronisent pas ?

• Vérifiez l'URL du webhook : Assurez-vous d'avoir copié l'URL complète, y compris tous les paramètres de requête
• Vérifiez que le webhook est activé : Confirmez que "Activer le Traitement des Webhooks" est coché dans LoyaltyTree
• Vérifiez votre plateforme d'avis : Assurez-vous que le webhook est actif et pointe vers la bonne URL
• Testez avec un nouvel avis : Soumettez un avis test pour déclencher le webhook

Le client ne reçoit pas de graines ?

• L'e-mail doit correspondre : Le customer_email dans le webhook doit correspondre à un client dans votre base de données LoyaltyTree
• Vérifiez les Paramètres de Graines : Vérifiez que les récompenses d'avis sont configurées dans votre Groupe de Fidélité
• Le client doit être enregistré : Les clients anonymes ou invités peuvent ne pas recevoir de récompenses de graines

Erreurs de signature de webhook ?

• Le secret doit correspondre : Le secret dans LoyaltyTree doit correspondre exactement à celui configuré dans votre plateforme d'avis
• Format de l'en-tête : LoyaltyTree recherche les en-têtes x-webhook-signature ou x-signature

Besoin d'aide ?

Contactez notre équipe de support à support@loyaltytree.eco pour obtenir de l'aide concernant l'intégration de la plateforme d'avis externe.