Introduction

Une fois votre compte Connectif connecté à Loyoly, vous devez créer dans Connectif les événements Loyoly que vous souhaitez exploiter, puis construire vos workflows en mappant les variables. Ce guide vous accompagne pas à pas.

💡 Vous devez d'abord avoir connecté Loyoly à Connectif via clé API. Si ce n'est pas encore fait, consultez le guide Intégration de Loyoly avec Connectif.

1. Créer l'intégration sur Connectif

Dans Connectif, allez dans Ajustes generales → Integraciones → Integraciones Personalizadas (Intégrations personnalisées) et cliquez sur Crear nueva integración (Créer une nouvelle intégration). Nommez-la, par exemple « Integration Loyoly ».

2. Créer les événements de réception

Ouvrez votre intégration, puis l'onglet Recibir datos (Recevoir des données) et cliquez sur Crear nuevo evento de recepción (Créer un nouvel événement de réception). Créez un événement pour chaque événement Loyoly que vous voulez utiliser.

💡 Exemples d'événements déjà configurés côté Loyoly (onglet « Recibir datos ») : points_earned, post_purchase, reward_redeemed. Chaque événement affiche son identifiant, son nom, son alias, son type (Webhook), la date de création et son nombre de champs.

À la création d'un événement, une fenêtre « Crear nuevo evento de recepción » vous demande de choisir le type de connexion :

Third-Party Platform (Webhook) — reçoit les événements automatiquement depuis une plateforme externe. C'est l'option utilisée pour Loyoly.
Sélectionnez Third-Party Platform (Webhook) puis cliquez sur Ir al editor (Aller à l'éditeur).

Dans l'éditeur (onglet Configuración básica), renseignez :

Nombre del evento de recepción (Nom de l'événement) — ex. reward_redeemed.
Alias del evento de recepción (Alias) — ex. reward_redeemed. L'alias permet d'envoyer l'événement sans utiliser l'ID généré.
L'identifiant est fourni automatiquement une fois l'événement créé.
(Optionnel) un icône pour l'événement.

Le champ email : la clé qui relie l'événement au bon client

Chaque événement que vous créez doit obligatoirement contenir un champ email. C'est l'élément le plus important de la configuration, alors prenez le temps de bien le comprendre.

À quoi sert ce champ ? Quand Loyoly envoie un événement à Connectif (par exemple « une récompense vient d'être échangée »), Connectif a besoin de savoir à quel contact rattacher cet événement. C'est l'adresse email qui joue ce rôle d'identifiant unique : Connectif compare l'email reçu avec ceux de votre base de contacts et associe l'événement à la bonne personne. On parle de clé primaire (clave primaria) car c'est la donnée qui sert de point de correspondance.

Comment le configurer ? Cliquez sur Añadir un nuevo campo (Ajouter un nouveau champ), puis renseignez exactement :

Tipo de campo (Type de champ) = Email
Nombre del campo (Nom du champ) = email
Identificador del campo (Identifiant du champ) = email
Cochez Es obligatorio (Obligatoire) : l'événement ne sera pas accepté s'il arrive sans email.
Cochez Es clave primaria (Clé primaire) : c'est ce qui désigne l'email comme identifiant de rapprochement.

🚨 À refaire pour chaque événement. Si vous oubliez le champ email, ou si les cases Obligatoire et Clé primaire ne sont pas cochées, Connectif ne saura pas à quel contact rattacher l'événement : les données (points, récompense, etc.) ne s'afficheront pas dans l'email, ou l'événement sera ignoré. Vérifiez ces deux cases à chaque création d'événement.

Une fois le champ email en place, ajoutez tous les autres champs de l'événement (un par variable Loyoly à recevoir). Pour chaque champ : définissez le Tipo de campo (ex. Texto), le Nombre del campo et l'Identificador del campo (ex. reward_name). Contrairement à l'email, ces champs ne sont ni obligatoires ni clés primaires.

Cliquez sur Guardar (Enregistrer) une fois tous les champs ajoutés.

3. Créer le workflow

Dans Connectif, allez dans Workflows et créez un nouveau workflow. Construisez la structure suivante : un nœud de départ Inicio, le nœud déclencheur « Déclencheur [nom de l'événement] » (ex. Déclencheur reward_redeemed), puis un nœud « Enviar email » (Envoyer email).

Dans le nœud Enviar email, créez ou sélectionnez votre email. Insérez les variables dans le texte avec la syntaxe double accolade : {{nom_variable}}.

Exemple de corps d'email :

Congrats, there is your reward:

Your reward : {{reward_name}}

Your code : {{reward_code}}

Minimum purchase : {{reward_condition}}

💡 Les variables de l'email doivent correspondre aux champs déclarés dans l'événement. Si une variable reste vide dans l'email, vérifiez son rattachement (Asignar) dans l'étape Variables du nœud Enviar email.

Cliquez sur Aplicar, puis enregistrez et démarrez le workflow.

Configurez vos événements et workflows avec Connectif