Saltar al contenido principal

Systeme de variables

Les variables sont des conteneurs de donnees dynamiques que vous utilisez pour personnaliser les messages, stocker les reponses des contacts et alimenter la logique de vos chatbots. Ce guide couvre l'ensemble du systeme de variables disponible dans Reepli.

Qu'est-ce qu'une variable ?​

Une variable est un espace de stockage nomme qui contient une valeur. Cette valeur peut changer au cours de la conversation. Dans Reepli, les variables sont utilisees pour :

  • Personnaliser les messages (ex : "Bonjour {{contact.prenom}}")
  • Stocker les reponses du contact
  • Alimenter les conditions et branchements
  • Transmettre des informations entre les flux
  • Envoyer des donnees vers des systemes externes (CRM, API)

Syntaxe​

Les variables sont inserees dans les messages et les champs de configuration avec la syntaxe a doubles accolades :

{{nom_de_la_variable}}

Categories de variables​

Reepli propose quatre categories de variables, chacune avec un perimetre et une duree de vie differents.

CategoriePrefixePorteeDuree de vie
Variables systemesystem.GlobalePermanente
Attributs de contactcontact.Par contactPermanente
Variables de fluxflow.Par fluxDuree du flux
Variables de sessionsession.Par conversationDuree de la session

Variables systeme​

Les variables systeme sont fournies automatiquement par Reepli. Elles sont en lecture seule.

VariableDescriptionExemple de valeur
{{system.date}}Date actuelle (AAAA-MM-JJ)2026-04-03
{{system.heure}}Heure actuelle (HH:MM)14:35
{{system.timestamp}}Horodatage Unix1775318100
{{system.jour_semaine}}Jour de la semainejeudi
{{system.langue_detectee}}Langue detectee du dernier messagefr
{{system.canal}}Canal de la conversationwhatsapp
{{system.chatbot_nom}}Nom du chatbot en coursBot Support
{{system.flux_nom}}Nom du flux en coursAccueil
{{system.message_brut}}Dernier message recu (texte brut)Bonjour
{{system.message_id}}Identifiant du dernier messagemsg_abc123
Information

Les variables systeme sont mises a jour automatiquement a chaque etape du flux. Vous ne pouvez pas modifier leur valeur.

Attributs de contact​

Les attributs de contact sont lies au profil du contact dans le CRM Reepli. Ils persistent entre les conversations.

Attributs standard​

VariableDescriptionModifiable
{{contact.prenom}}Prenom du contactOui
{{contact.nom}}Nom de familleOui
{{contact.telephone}}Numero de telephoneNon
{{contact.email}}Adresse e-mailOui
{{contact.langue}}Langue prefereeOui
{{contact.pays}}PaysOui
{{contact.ville}}VilleOui
{{contact.entreprise}}Nom de l'entrepriseOui
{{contact.date_creation}}Date de creation du contactNon
{{contact.derniere_interaction}}Date de la derniere interactionNon
{{contact.tags}}Liste des tags du contactOui (via action)
{{contact.agent_assigne}}Agent actuellement assigneOui (via action)

Attributs personnalises​

Vous pouvez creer des attributs personnalises pour stocker des informations specifiques a votre activite.

Creer un attribut personnalise​

  1. Accedez a Parametres puis Attributs de contact.
  2. Cliquez sur Nouvel attribut.
  3. Remplissez les champs :
    • Nom -- identifiant unique (ex : numero_client)
    • Libelle -- nom affiche (ex : "Numero client")
    • Type -- texte, nombre, date, booleen, liste deroulante
    • Valeur par defaut (optionnel)
  4. Cliquez sur Enregistrer.

L'attribut est ensuite accessible via {{contact.numero_client}}.

Types d'attributs disponibles​

TypeDescriptionExemple
TexteChaine de caracteres libre"ABC-12345"
NombreValeur numerique42
DateDate au format AAAA-MM-JJ2026-01-15
BooleenVrai ou Fauxtrue
Liste deroulanteValeur parmi des choix predefinis"premium"

Variables de flux​

Les variables de flux existent uniquement pendant l'execution d'un flux. Elles sont detruites a la fin du flux.

Creer une variable de flux​

  1. Dans le panneau de configuration d'un noeud Action, selectionnez Definir une variable.
  2. Choisissez la portee Flux.
  3. Saisissez le nom de la variable (ex : compteur).
  4. Definissez la valeur initiale.

Cas d'utilisation​

  • Compteur de tentatives dans une boucle de validation
  • Stockage temporaire d'un calcul intermediaire
  • Indicateur d'etat pour controler le parcours

Variables de session​

Les variables de session persistent pendant toute la duree de la conversation active. Elles sont reintialisees lorsque la session expire (apres 24 heures d'inactivite par defaut).

Creer une variable de session​

  1. Dans un noeud Action, selectionnez Definir une variable.
  2. Choisissez la portee Session.
  3. Nommez la variable et definissez sa valeur.

Cas d'utilisation​

  • Stocker le choix du service selectionne au debut de la conversation
  • Conserver le panier d'achat en cours
  • Enregistrer l'etape atteinte pour reprendre en cas d'interruption

Lire une variable​

Dans un message​

Inserez la variable directement dans le texte du message :

Bonjour {{contact.prenom}}, bienvenue chez {{contact.entreprise}} !
Votre numero de commande est {{session.numero_commande}}.

Dans une condition​

Selectionnez la variable comme source dans le panneau de configuration du noeud Condition :

  1. Source : choisissez la variable dans la liste deroulante.
  2. Operateur : selectionnez la comparaison souhaitee.
  3. Valeur : saisissez la valeur de reference.

Dans un appel API (Webhook)​

Utilisez les variables dans le corps ou les parametres d'un appel webhook :

{
  "telephone": "{{contact.telephone}}",
  "commande": "{{session.numero_commande}}",
  "montant": "{{flow.montant_total}}"
}

Ecrire une variable​

Via un noeud Action​

  1. Ajoutez un noeud Action sur le canevas.
  2. Selectionnez le type Definir une variable.
  3. Choisissez la variable a modifier ou creez-en une nouvelle.
  4. Definissez la nouvelle valeur :
    • Valeur fixe -- saisissez directement la valeur
    • Depuis une autre variable -- copiez la valeur d'une autre variable
    • Expression -- combinez variables et operations

Via la reponse du contact​

Lorsque vous utilisez un noeud Question, la reponse est automatiquement stockee dans la variable configuree :

  1. Ajoutez un noeud Question.
  2. Dans le champ Stocker la reponse dans, selectionnez ou creez une variable.
  3. La reponse du contact sera affectee a cette variable.

Via un webhook​

Lorsque vous recevez une reponse d'une API externe, vous pouvez extraire des valeurs et les stocker dans des variables :

  1. Configurez un noeud Webhook.
  2. Dans la section Mapping de reponse, associez les champs JSON aux variables Reepli.

Operations sur les variables​

Operations texte​

OperationSyntaxeResultat
Concatenation{{contact.prenom}} {{contact.nom}}Jean Dupont
Majuscules{{upper(contact.prenom)}}JEAN
Minuscules{{lower(contact.email)}}[email protected]
Longueur{{length(session.code)}}6
Sous-chaine{{substr(session.code, 0, 3)}}ABC

Operations numeriques​

OperationSyntaxeResultat
Addition{{flow.montant + 10}}110
Soustraction{{flow.montant - flow.remise}}90
Multiplication{{flow.quantite * flow.prix_unitaire}}250
Division{{flow.total / flow.nombre_parts}}50
Arrondi{{round(flow.moyenne, 2)}}14.57

Operations date​

OperationSyntaxeResultat
Date formatee{{format_date(system.date, "DD/MM/YYYY")}}03/04/2026
Ajouter des jours{{add_days(system.date, 7)}}2026-04-10
Difference en jours{{diff_days(contact.date_creation, system.date)}}45

Valeurs par defaut et gestion des variables vides​

Valeur par defaut dans un message​

Utilisez l'operateur de fallback pour afficher une valeur par defaut si la variable est vide :

Bonjour {{contact.prenom | "cher client"}} !

Si contact.prenom est vide, le message affichera "Bonjour cher client !".

Verifier qu'une variable est vide​

Utilisez les operateurs est vide et n'est pas vide dans les conditions pour gerer les cas ou une variable n'a pas de valeur.

Attention

Ne supposez jamais qu'une variable a une valeur. Prevoyez toujours un comportement de repli (fallback) pour les variables potentiellement vides, en particulier les attributs de contact qui n'ont peut-etre pas ete renseignes.

Bonnes pratiques​

  1. Nommez clairement vos variables -- utilisez des noms descriptifs en minuscules avec des underscores (ex : nombre_employes, date_rdv).
  2. Choisissez la bonne portee -- utilisez les variables de flux pour les donnees temporaires, les attributs de contact pour les donnees permanentes.
  3. Documentez vos variables -- ajoutez des notes dans vos flux pour expliquer le role de chaque variable personnalisee.
  4. Prevoyez les valeurs par defaut -- utilisez l'operateur de fallback dans vos messages.
  5. Nettoyez les variables inutiles -- supprimez les attributs personnalises que vous n'utilisez plus.

Prochaines etapes​

Besoin d'aide ?

Si vous rencontrez un probleme avec les variables, contactez notre equipe support via le chat en bas a droite de l'application ou envoyez un e-mail a [email protected].