Centre d'aide KWIGA Services, intégrations, API, paramètres Paramètres généraux Utilisation des variables dans le projet, liste des variables disponibles

Utilisation des variables dans le projet, liste des variables disponibles

Articles:

il y a 1 semaine • Mis à jour

Cet article explique comment utiliser les variables dans votre projet : où les appliquer, quelles données sont disponibles et comment les utiliser pour l’automatisation et la personnalisation. Inclut une liste avec descriptions et exemples pour les e-mails, webhooks, boutons, leçons, et plus encore.

Informations générales sur les variables

Les variables sont un moyen pratique d'insérer des données personnalisées dans divers éléments de votre projet. Elles peuvent être utilisées dans les endroits suivants :

1. Webhooks dans les automatisations

Les variables peuvent être insérées :

dans l'URL du webhook, par exemple:
https://example.com/hook?user={user.email}
dans les paramètres du corps de la requête
dans les en-têtes

Cela permet de transmettre automatiquement des données personnelles à des services tiers.

2. CTA (Call to Action)

Dans les boutons et les liens, les variables peuvent être utilisées pour :

personnaliser le texte du bouton
transmettre des données via des liens, comme l'ID utilisateur ou les balises UTM

3. Dans les paramètres

Les variables peuvent être utilisées dans les paramètres des formulaires ou d'autres éléments :

email de l'utilisateur
ID d'abonnement
codes uniques et balises
toute autre variable disponible dans le contexte

4. Dans le lien de redirection (si le passage au paiement n'est pas utilisé)

Vous pouvez ajouter manuellement des variables dans le lien de redirection :

https://my.site.com/thanks?email={user.email}&course={course.title}

5. Dans les infoblocs des leçons

Les variables fonctionnent à l'intérieur des textes des infoblocs. Par exemple :

Appel par le prénom : Salut, {user.first_name} !
Affichage du nom du cours, de la date, du statut, etc.

6. Dans les emails

L'utilisation de variables dans les emails permet de rendre la communication plus personnalisée et efficace. Grâce à des variables comme {nom}, {date} ou {nom du cours}, l'email semble personnellement adressé au client. Cela augmente la confiance, l'engagement et la probabilité que l'utilisateur lise l'email jusqu'au bout ou effectue l'action souhaitée. De plus, les variables simplifient l'automatisation des envois de masse sans perdre l'approche individuelle.

Liste des variables disponibles

Liste des variables disponibles, qui sont disponibles partout où les variables peuvent être utilisées.

Variable	Valeur
contact.id	ID de contact
contact.user_id	ID utilisateur
contact.first_name	Prénom du contact
contact.last_name	Nom de famille du contact
contact.middle_name	Deuxième prénom du contact
contact.name	Nom complet du contact
contact.email	Email du contact
contact.phone	Téléphone du contact
contact.country	Pays du contact. Par exemple : Ukraine
contact.timezone	Fuseau horaire du contact. Par exemple : Europe/Kyiv
contact.currency	Devise du contact. Par exemple : USD
contact.city	Ville du contact
contact.utm_source	Liste des utm_source uniques du contact (séparateur ", ")
contact.utm_medium	Liste des utm_medium uniques du contact (séparateur ", ")
contact.utm_campaign	Liste des utm_campaign uniques du contact (séparateur ", ")
contact.utm_term	Liste des utm_term uniques du contact (séparateur ", ")
contact.utm_content	Liste des utm_content uniques du contact (séparateur ", ")
contact.field_<id>	Champs personnalisés (description ci-dessous)
datetime	Date et heure en UTC au format YYYY-MM-DD HH:mm:ss
contact.visit_source	Source de la visite

Champs personnalisés

{contact.field_<id>}

Exemple {contact.field_123}

<id> - id du champ, qui peut être obtenu dans les paramètres des champs de contact (exemple https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Variables pouvant être utilisées en plus dans les CTA

dans les paramètres
dans le lien de redirection (si le passage au paiement n'est pas utilisé)

Variable	Valeur
first_name	Prénom de la demande
last_name	Nom de la demande
middle_name	Patronyme de la demande
name	Nom complet de la demande
email	Email de la demande
phone	Téléphone de la demande
field_<id>	Champs personnalisés Téléphone de la demande (description ci-dessous)
utm_source	utm_source - de la visite spécifique où la demande a été laissée
utm_medium	utm_medium - de la visite spécifique où la demande a été laissée
utm_campaign	utm_campaign - de la visite spécifique où la demande a été laissée
utm_term	utm_term - de la visite spécifique où la demande a été laissée
utm_content	utm_content - de la visite spécifique où la demande a été laissée
widget_landing	Url de la landing page d'où la demande a été envoyée
widget_landign_referer	Référent qui était sur la landing page lorsque la demande a été envoyée
De plus, dans certains formulaires, des variables peuvent être disponibles, décrites ci-dessous dans Variables disponibles dans les webhooks d'automatisation Par commande ({order.}) - Si l'option d'accès au produit (Accès complet/Par offre) est choisie Par produit({product.}) - Si l'option d'accès au produit + Accès complet est choisie Par offre ({offer.*}) - Si l'option d'accès au produit + Par offre est choisie

Champs personnalisés

{field_<id>}

Exemple {contact.field_123}

<id> - id du champ, qui peut être obtenu dans les paramètres des champs de contact (exemple https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Si sur la page où le CTA ou le script Kwiga pour le suivi des visites est placé, il y a eu des visites avec des balises utm, et le client a laissé une demande sur la landing page sans balises utm, alors elles seront absentes dans ces variables. Mais elles seront disponibles dans les variables {contact.utm_...}, qui sont décrites ci-dessus.

Variables disponibles dans les webhooks d'automatisation (url, paramètres, emails)