Intégrations sortantes

🔗 Intégrations Sortantes

Connectez vos événements LoyaltyTree à des plateformes externes de marketing, d'automatisation et d'analytique. Envoyez des données en temps réel sur l'activité des clients pour alimenter des campagnes par e-mail, des segments de clients, des automatisations, et plus encore.

---

Plateformes Supportées

LoyaltyTree prend en charge l'envoi d'événements aux plateformes suivantes :

Plateforme	Type	Ce dont vous avez besoin
Klaviyo	Marketing par e-mail/SMS	Votre clé API privée Klaviyo
Omnisend	Marketing par e-mail/SMS	Votre clé API Omnisend
Shopify Flow	Automatisation Shopify	Un identifiant de déclencheur Flow (créé dans Shopify Flow)
Webhook Générique	Tout point de terminaison HTTP	Une URL de webhook qui accepte les requêtes POST

---

Commencer

---

Événements Supportés (19 au Total)

Vous pouvez abonner chaque intégration à n'importe quelle combinaison de ces événements. Seuls les événements que vous sélectionnez seront envoyés à cette plateforme.

🌱 Événements de Semences Gagnées

Déclenché lorsqu'un client gagne des semences à travers diverses activités.

Événement	Clé de l'Événement	Déclenché Lorsque
Semences – Gagnées – Commande	seeds.earned.order	Le client gagne des semences lors d'un achat
Semences – Gagnées – Visite	seeds.earned.visit	Le client gagne des semences en visitant la boutique
Semences – Gagnées – Avis	seeds.earned.review	Le client gagne des semences en écrivant un avis
Semences – Gagnées – Référence	seeds.earned.referral	Le client gagne des semences grâce à une référence réussie
Semences – Gagnées – Partage Social	seeds.earned.social_share	Le client gagne des semences en partageant sur les réseaux sociaux
Semences – Gagnées – Bonus	seeds.earned.bonus	Le client reçoit des semences bonus (anniversaire, attribution manuelle, etc.)

⭐ Événements de Niveau & Avis

Événement	Clé de l'Événement	Déclenché Lorsque
Niveau – Changé	tier.changed	Le client passe à un niveau de fidélité différent
Avis – Soumis	review.submitted	Le client soumet un nouvel avis sur un produit
Avis – Approuvé	review.approved	Un avis sur un produit est approuvé (par IA ou manuellement)
Avis – Rejeté	review.rejected	Un avis sur un produit est rejeté

🎁 Événements de Récompense

Événement	Clé de l'Événement	Déclenché Lorsque
Carte Cadeau – Gagnée	gift_card.earned	Le client est éligible à une récompense de carte cadeau
Carte Cadeau – Réclamée	gift_card.claimed	Le client réclame sa carte cadeau
Crédit Boutique – Gagné	store_credit.earned	Le client est éligible à un crédit boutique
Crédit Boutique – Réclamé	store_credit.claimed	Le client réclame son crédit boutique

🌳 Événements Écologiques & de Référence

Événement	Clé de l'Événement	Déclenché Lorsque
Produit Écologique – Attribué	eco_product.awarded	Le client échange des semences pour un produit écologique
Écologique – Arbre Planté	eco.tree_planted	Un arbre est planté pour le client
Référence – Générée	referral.generated	Le client génère un lien de référence
Référence – Visite	referral.visit	Quelqu'un visite la boutique via un lien de référence
Référence – Réussie	referral.successful	Un visiteur référé effectue un achat

---

Guides de Configuration de la Plateforme

📧 Klaviyo

Klaviyo est une plateforme de marketing par e-mail et SMS populaire auprès des boutiques Shopify. LoyaltyTree envoie des événements à Klaviyo en utilisant leur API des Événements (v3), vous permettant de créer des segments, des flux et des campagnes basés sur l'activité de fidélité.

Comment ça fonctionne : LoyaltyTree crée des événements Klaviyo avec l'e-mail du client comme identifiant de profil. Les événements apparaissent comme des métriques personnalisées (par exemple, "Semences Gagnées Commande", "Niveau Changé") que vous pouvez utiliser dans les flux et segments Klaviyo. Les montants de semences sont envoyés comme valeur de l'événement, vous permettant de les utiliser dans des divisions conditionnelles.

📨 Omnisend

Omnisend est une autre plateforme populaire de marketing par e-mail et SMS. LoyaltyTree envoie des événements en utilisant l'API des Événements Omnisend (v5).

Comment ça fonctionne : Les événements sont envoyés avec l'e-mail, le nom et l'ID client Shopify du client. Chaque événement inclut toutes les propriétés pertinentes (montants de semences, détails de commande, informations sur le niveau, etc.) afin que vous puissiez les utiliser dans les flux d'automatisation et la segmentation d'Omnisend.

⚡ Shopify Flow

Shopify Flow est l'outil d'automatisation intégré de Shopify. LoyaltyTree envoie des événements directement à Shopify Flow en utilisant la mutation flowTriggerReceive GraphQL, ce qui signifie que les événements apparaissent comme des déclencheurs dans vos flux Flow — aucune application tierce n'est nécessaire.

Comment ça fonctionne : Lorsqu'un événement abonné se produit, LoyaltyTree utilise la connexion API Shopify de votre boutique pour envoyer les données de l'événement directement dans Shopify Flow via GraphQL. La charge utile est aplatie en clés lisibles par l'homme comme "E-mail du client", "Type d'événement", "Montant", etc. Vous pouvez ensuite utiliser ces valeurs comme conditions dans votre Flow pour déclencher des actions telles que l'envoi d'e-mails, le marquage des clients ou la création de tâches.

Exemples d'automatisations Shopify Flow :

• Taguer les clients lorsqu'ils atteignent le niveau Or
• Envoyer une notification interne Slack lorsqu'un arbre est planté
• Créer une tâche lorsqu'un avis est soumis
• Ajouter une note au profil du client lorsqu'il gagne une carte cadeau

 

🌐 Webhook Générique

Envoyez des événements LoyaltyTree à n'importe quel point de terminaison HTTP. C'est parfait pour se connecter à des systèmes personnalisés, Zapier, Make (Integromat), n8n, ou toute autre plateforme qui accepte les POST de webhook.

Options d'authentification :

Méthode	En-tête Envoyé	Description
Signature HMAC	X-LoyaltyTree-Signature	HMAC SHA-256 du corps de la charge utile, signé avec votre secret de webhook
Token Bearer	Authorization: Bearer <token>	Authentification standard de type token bearer OAuth
X-Token	X-Token: <token>	Token simple dans un en-tête personnalisé
En-tête Personnalisé	<your-header>: <token>	Spécifiez votre propre nom d'en-tête et valeur de token

Modèles de Charge Utile Personnalisés : Pour les Webhooks Génériques, vous pouvez personnaliser le format de la charge utile pour chaque événement en utilisant des variables de modèle. Cela vous permet de correspondre exactement au format que votre système de réception attend.

En-têtes standards envoyés avec chaque requête :

• Content-Type: application/json
• User-Agent: LoyaltyTree/1.0
• X-LoyaltyTree-Event: <event_type>
• X-LoyaltyTree-Timestamp: <ISO timestamp>

---

Exemple de Charge Utile de Webhook

Voici à quoi ressemble un événement typique seeds.earned.order lorsqu'il est livré à un Webhook Générique :

{
  "event": "seeds.earned.order",
  "timestamp": "2026-02-06T14:30:00.000Z",
  "customer": {
    "email": "jane@example.com",
    "first_name": "Jane",
    "last_name": "Smith",
    "display_name": "Jane Smith",
    "shopify_customer_id": "7891234567890"
  },
  "amount": 50,
  "order_id": "6012345678901",
  "order_number": "1042",
  "order_total": "89.99",
  "order_currency": "USD",
  "balance": 350,
  "tier": "Silver"
}

Chaque charge utile d'événement inclut l'objet customer avec leur e-mail, nom et ID client Shopify, ainsi que des champs de données spécifiques à l'événement.

---

Référence des Données d'Événements

Voici une liste détaillée des champs de données inclus avec chaque type d'événement.

---

Fiabilité & Logique de Réessai

LoyaltyTree utilise une file d'attente asynchrone pour garantir la livraison fiable des événements. Les événements ne sont jamais perdus — si la livraison échoue, le système réessaie automatiquement avec un délai exponentiel.

Tentative de Réessai	Temps d'Attente
1er réessai	1 minute
2ème réessai	5 minutes
3ème réessai	30 minutes
4ème réessai	2 heures
5ème réessai (final)	24 heures

Après que tous les réessais aient échoué, l'événement est marqué comme "épuisé" et apparaît dans vos journaux d'événements avec un bouton Réessayer afin que vous puissiez le réessayer manuellement à tout moment.

Journaux d'Événements

Chaque livraison d'événement est enregistrée et visible dans la section Journaux d'Événements sur la page des Intégrations. Vous pouvez filtrer les journaux par :

• Connexion – Voir les événements pour une intégration spécifique
• Événement – Filtrer par type d'événement
• Client – Rechercher par e-mail ou nom du client
• Plage de Dates – Voir les événements d'une période spécifique

Chaque entrée de journal montre l'heure, la plateforme, le type d'événement, le statut et tout message d'erreur. Les événements échoués incluent un bouton Réessayer pour les remettre immédiatement dans la file d'attente.

 

---

Dépannage

---

Sécurité

• Toutes les clés API et tokens sont cryptés au repos à l'aide du chiffrement AES-256-CBC
• Les secrets de webhook permettent une vérification de signature HMAC afin que votre point de terminaison puisse vérifier que les requêtes proviennent réellement de LoyaltyTree
• Les événements sont traités via une file d'attente asynchrone — la performance de votre boutique n'est jamais impactée par la livraison d'intégration
• Les anciens événements livrés et journaux sont automatiquement nettoyés après 30 jours