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 8 mois • 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 le lien de redirection après le paiement réussi de l'offre

Dans le lien de redirection après le paiement réussi de l'offre, les variables des blocs contact.*, order.* et payment.* sont disponibles

Exemple : https://my.site.com/success?order_id={order.id}&email={contact.email}&payment_price={payment.price}

5. Dans les infoblocs des leçons

Les variables et les blocs conditionnels fonctionnent dans les textes des infobulles. Par exemple :

Appel par le prénom : Salut, {user.first_name} !
Affichage du nom du cours, de la date, du statut, etc.
Données du contact : {contact.name}, {contact.email} et autres champs
Données de la leçon actuelle : {lesson.title}, {lesson.slug} et autres champs de la leçon
Blocs conditionnels @if/@endif : afficher un contenu différent selon que le contact a un tag, l’accès à l’offre, etc.

6. Dans les emails

L’utilisation de variables dans les e-mails permet de rendre la communication plus personnalisée et plus efficace. Grâce à des variables telles que {имя}, {дата} ou {название курса}, l’e-mail paraît adressé personnellement au client. Cela augmente la confiance, l’engagement et la probabilité que l’utilisateur lise l’e-mail jusqu’au bout ou effectue l’action souhaitée. De plus, les variables simplifient l’automatisation des envois en masse sans perdre l’approche individuelle.

7. Dans les notifications

Lors de la configuration des notifications dans les actions d'automatisation, les variables permettent d'insérer dynamiquement des informations dans les notifications, telles que le nom d'utilisateur, le numéro de commande ou le nom de l'offre. Cela simplifie et accélère le processus de création de notifications, les rendant plus intuitives et adaptatives pour différents scénarios.

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
Ces variables sont disponibles dans le lien de redirection après le paiement réussi de l'offre.

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

Comment modifier la valeur d’une variable

Après la variable, vous pouvez ajouter des options pour modifier son apparence : ajouter du texte, mettre les lettres en majuscules ou formater la date.

Format général : {variable|option:value|option}. Par exemple : {order.id|prefix:ORDER-} ou {payment.paid_at|format:DD.MM.YYYY}.

Ce que vous voulez obtenir	Que saisir
Ajouter du texte avant la valeur	`{order.id\|prefix:ORDER-}` -> donnera `ORDER-123`
Ajouter du texte après la valeur	`{order.id\|suffix:-EU}` -> donnera `123-EU`
Donner au numéro une longueur fixe	`{payment.number\|pad:6}` -> donnera `000001`
Compléter non pas avec des zéros, mais avec votre propre symbole	`{payment.number\|pad:6\|padchar:_}` -> donnera `_____1`
Mettre toutes les lettres en majuscules	`{contact.city\|upper}` -> `KYIV`
Mettre toutes les lettres en minuscules	`{contact.city\|lower}` -> `kyiv`
Mettre seulement la première lettre en majuscule	`{contact.city\|ucfirst}` -> `Kyiv`
Afficher la date dans le format souhaité	`{payment.paid_at\|format:DD.MM.YYYY}` -> donnera `24.12.2026`

Si vous souhaitez utiliser votre propre modèle de date, vous pouvez consulter les notations prêtes à l’emploi dans la documentation publique : pour des variantes comme DD.MM.YYYY, MMMM YYYY, dddd, la documentation Carbon convient. Pour des variantes comme Y-m-d et H:i:s, la documentation officielle de PHP convient.

Important : si pad est utilisé, la valeur est d’abord complétée jusqu’à la longueur souhaitée, puis seulement les autres options sont appliquées.

Blocs conditionnels @if / @endif

Permettent d’afficher ou de masquer une partie du texte selon une condition. Si la condition est vraie, le bloc s’affiche ; sinon, il est complètement supprimé.

Syntaxe : @if(condition)...texte...@endif

Exemple :
@if({contact.has|offer:123})Obtenez l’accès aux contenus@endif

La condition dans @if() est toute variable qui renvoie true ou false. Actuellement, {contact.has|...} est pris en charge (vérification de l’appartenance du contact).

Condition contact.has — vérification du contact

Permet de vérifier si le contact correspond à certaines conditions. Renvoie true ou false. Généralement utilisé avec les blocs conditionnels @if/@endif.

Syntaxe : {contact.has|type:valeur}

Type	Valeur	Description
`offer`	ID de l’offre	Le contact a accès à l’offre
`order`	ID de la commande	Le contact a une commande avec cet ID
`product`	ID du produit	Le contact a accès au produit
`tag`	ID ou nom du tag	Le contact a un tag (le cyrillique et les espaces dans le nom sont pris en charge)
`list`	ID de la liste	Le contact appartient à la liste
`course`	ID du cours	Le contact est inscrit au cours
`marathon`	ID du cours	Alias de course (un marathon est un sous-type de cours)
`webinar`	ID du вебинар	Le contact a accès au webinar
`closed_group`	ID du groupe privé	Le contact a accès au groupe privé

Vous pouvez indiquer plusieurs conditions via | — elles doivent toutes être remplies en même temps (logique AND). Par exemple : {contact.has|offer:123|tag:VIP}

Exemples d’utilisation :

{contact.has\|offer:123}	vérifie la présence d’une offre avec l’ID 123
{contact.has\|tag:VIP}	vérifie le tag par son nom
{contact.has\|tag:тест тег}	tag avec espace et cyrillique
{contact.has\|offer:123\|tag:VIP}	les deux conditions en même temps (AND)

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)