Comment configurer l'étape Définir des variables ?

À quoi sert-elle ?

« Définir des variables » écrit une valeur dans une ou plusieurs variables. Si vous donnez le nom d'une variable existante, sa valeur change. Dans les étapes suivantes, vous utilisez la valeur sous la forme {name}.

Les visiteurs ne voient pas cette étape et l'avatar ne dit rien ; l'agent continue sans attendre le visiteur.

Pour l'ajouter, cliquez sur « Ajouter une étape » dans l'onglet « Éditeur », puis sur « Définir des variables » dans la catégorie « Logique » ; l'étape est ajoutée au milieu du canevas. Ses réglages sont dans l'onglet « Contenu » du panneau d'étape, qui s'ouvre à droite quand vous cliquez sur l'étape.

Cette étape n'a pas de « Texte à l'écran » ; à la place, il y a une « Note d'étape » en bas du panneau. La note est pour vous seul : les visiteurs ne la voient pas, et elle n'est ni dite ni traduite.

Dans les valeurs, vous utilisez des variables des étapes précédentes, comme {city}. Pour un champ à l'intérieur d'une réponse, ajoutez son nom après un point : {order.status}. Le bouton « Insérer une variable » dans les champs liste les variables utilisables à cet endroit. Une variable pas encore remplie compte comme un texte vide.

Configurer l'étape

1. Tapez le nom de la variable dans le premier champ sous « Affectations ». Une nouvelle affectation suggère un nom que l'agent n'utilise pas encore ; vous pouvez le changer.
2. Choisissez le type de valeur dans la liste à côté et saisissez la valeur en dessous.
3. Pour une autre variable, cliquez sur « Ajouter une affectation » ; retirez les lignes en trop avec la croix (« Supprimer l'affectation »).

Types de valeurs

• « Texte » : le texte saisi, qui peut contenir des variables ({first_name} {last_name}). S'il reste vide, la variable est vidée.
• « Calcul » : nombres, variables, + − × ÷ (ou * et /) et parenthèses, par exemple {total} * 1.2. La multiplication et la division passent en premier. Le résultat est un nombre avec au plus deux décimales (12.5).
• « Date » : ajoute une durée à une date de départ ; l'unité est le jour, la semaine, le mois ou l'année. Si le champ de départ est vide (il affiche « Aujourd'hui »), c'est la date du jour du visiteur qui est utilisée ; une durée négative remonte dans le temps. Le résultat ressemble à 05.10.2026. Une date au-delà de la fin du mois passe au dernier jour du mois : ajouter 1 mois au 31 janvier donne le 28 (ou 29) février.
• « Résumé de liste » : transforme une liste en une seule valeur. L'opération est « Nombre », « Somme », « Moyenne », « Le plus petit », « Le plus grand » ou « Joindre » ; Joindre écrit les valeurs côte à côte, séparées par des virgules. Pour tout sauf Nombre, saisissez dans le champ voisin le champ de l'élément à utiliser (par exemple price) ; sans champ, l'élément lui-même est utilisé. Sur une liste vide, le nombre et la somme valent 0 et les autres sont vides.

Les affectations s'exécutent dans l'ordre ; une affectation suivante peut utiliser la valeur écrite par une précédente. Une valeur impossible à calculer (une variable qui n'est pas un nombre, une division par zéro, un départ qui n'est pas une date) vide la variable, pour que l'agent ne continue pas avec une valeur ancienne ou fausse.

Exemple

Une inscription à un événement a trois affectations : total (« Calcul ») {guests} * 25 ; total_with_tax (« Calcul ») {total} * 1.2 ; due_date (« Date », départ vide, 7 jours). Une étape Message peut alors dire : « Votre total est de {total_with_tax} ; veuillez payer avant le {due_date}. »

Points d'attention

L'éditeur vous avertit quand : il n'y a pas d'affectations, le nom d'une affectation est invalide, une valeur « Calcul » ou « Résumé de liste » est vide, ou un calcul contient une faute de frappe.

Les noms de variables ne peuvent utiliser que les lettres a–z, les chiffres et les tirets bas (_) ; les lettres accentuées et les espaces disparaissent à la saisie. « system » est réservé aux variables système : choisissez un autre nom.

Les problèmes n'empêchent pas d'enregistrer : l'agent est enregistré, mais l'étape incomplète ne fonctionnera pas comme prévu dans la conversation. Corrigez les étapes signalées, puis testez l'agent avec « Aperçu ». Pour trouver les étapes signalées, voir l'éditeur de flux.