Comment utiliser les variables

Découvrons ce que sont les variables et comment les utiliser efficacement lors de la création de chatbots dans MaviBot.

Veuillez prendre connaissance des limites système suivantes pour les variables et constantes au sein d'un seul projet :

Variables de modèle :

  • Quantité maximale : 100 variables
  • Longueur maximale du nom : 100 caractères

Constantes du projet :

  • Quantité maximale : 50 constantes
  • Longueur maximale du nom : 100 caractères
  • Longueur maximale de la valeur : 5 000 caractères

Une variable est un emplacement de stockage nommé pour des données, identifié par une étiquette textuelle unique.

Fig. 1 : Une variable nommée total, stockant un montant de paiement.

MaviBot fournit plusieurs types de variables :

  1. Variables intégrées
  2. Variables système
  3. Variables définies par l'utilisateur — ce sont celles que vous créez vous-même dans le projet.

Déclarer une variable signifie attribuer une valeur à un conteneur nommé. En d'autres termes, une instruction comme a=0 est la déclaration de la variable a. Nous venons de dire (déclarer au constructeur) que nous allons stocker un nombre dans la variable a, et pour l'instant, cette valeur est 0.

Attribuer une valeur à une variable a la même signification.

Les expressions "attribuer à une variable la valeur d'une fonction" ou "définir une variable égale à une fonction" sont également couramment utilisées. Le principe est le même : au lieu d'attribuer une valeur spécifique, vous attribuez le résultat d'une fonction. Par exemple : s_id = tg_send_message(platform_id, "Bonjour !") Dans ce cas, le résultat de la fonction sera stocké dans la variable.

Réinitialiser une variable signifie lui attribuer la valeur 0.

Fonctions et méthodes sont des ensembles de commandes prédéfinies qui sont configurées à l'avance par MaviBot. La plupart des fonctions nécessitent des paramètres - des valeurs que la fonction ou la méthode peut comprendre. Une fois que le bot reçoit les paramètres nécessaires, il exécute une commande spécifique.

tg_send_message(platform_id, "Bonjour !") — cette fonction envoie le message "Bonjour !" dans Telegram.

RÈGLES POUR TRAVAILLER AVEC LES VARIABLES :

  1. Un nom de variable ne peut commencer que par une lettre ; il ne peut pas commencer par un chiffre.

    Age1 - ✅ correct

    1Age - ❌ incorrect

    age1 - ✅ correct - option recommandée

  2. Une variable ne peut pas contenir d'espaces ni de caractères spéciaux, à l'exception du trait de soulignement (_).

    Nom_Prenom - ✅ correct

    Nom Prenom - ❌ incorrect

    nomPrenom - ✅ correct - option recommandée

    Les mots réservés des langages de programmation ne peuvent pas être utilisés comme noms de variables, par exemple : print, true, false, count, sum, etc.

  3. Il est strictement interdit d'utiliser les noms des variables intégrées et système pour les variables définies par l'utilisateur. Vous pouvez trouver la liste de ces variables ici. lien

  4. Nous recommandons :

    • Utiliser des noms latins (anglais) pour les variables.
    • Utiliser des noms de variables courts mais significatifs, par exemple : totalSum, pay_name, ns, name_client, etc.

Comment obtenir la valeur d'une variable

Placez le nom de la variable entre accolades #{}. Vous pouvez référencer sa valeur dans le champ de texte du message de cette façon. Cependant, dans le champ "Calculatrice", vous devez vous référer à la valeur de la variable simplement par son nom, sans syntaxe supplémentaire.

La construction #{} permet de récupérer la valeur d'une variable. Elle est utilisée dans le champ "Texte du message" pour insérer la valeur de la variable dans le texte.

Exemple :

Le système prend en charge les variables imbriquées, où la valeur d'une variable fait partie du nom d'une autre variable. Par exemple : #{q#{test#{i}}}

Dans le champ "Calculatrice", référez-vous aux variables par leurs noms sans utiliser la notation #{}.
Par exemple, si nous avons deux variables : price (somme) et quantity (num).

num = 10

sum = 1500

Comment afficher la somme totale

Saisissez ce qui suit dans la calculatrice :

total_sum = sum1 * num2 ✅ correct

Comment ne pas faire :

total_sum = #{sum1} * #{num2} - ❌ incorrect

Comment supprimer une variable du bot

Pour supprimer (effacer) une variable, saisissez l'une des options suivantes dans le champ "Calculatrice" :

NomDeVotreVariable =

ou

NomDeVotreVariable = ""

Après le signe égal, laissez un espace ou utilisez des guillemets doubles (ou simples).

Veuillez noter ! Il est important d'utiliser le préfixe correct pour indiquer à qui appartient la variable.

Pour les variables au niveau du projet (stockées dans les paramètres du projet), utilisez le préfixe project:

Exemple :
project.NomDeVotreVariable =
ou
project.NomDeVotreVariable = ""

Pour les variables au niveau du client, utilisez le préfixe client:

Exemple :
client.NomDeVotreVariable = ou
client.NomDeVotreVariable = ""

Pour les variables au niveau de l'affaire, aucun préfixe n'est nécessaire.

Variables intégrées

Voici la liste des variables intégrées :

#{none} - ignorer le message

#{api_key} - jeton API utilisé dans les appels API Mavibot

#{attachment_url} - contient le lien vers la pièce jointe

#{attachments} - un tableau JSON des URL des pièces jointes du message de l'utilisateur

#{avatar} - lien vers l'avatar de l'utilisateur (affiché dans la section "Clients")

#{client_id} - identifiant du client dans le constructeur, également utilisé dans les requêtes API

#{client_type} - le type de messagerie d'où vient le client (les valeurs sont décrites [ici])

#{current_date} - date actuelle au format jj.mm.aaaa, basée sur le fuseau horaire du projet

#{current_time} - heure actuelle au format hh:mm, basée sur le fuseau horaire du projet

#{custom_answer} - la réponse reçue du serveur spécifié dans le champ "URL de réponse du serveur"

#{message_from_outside} - type de message entrant. Valeurs possibles :
&#xNAN;message régulier = 0
message envoyé via API = 1
notification de rappel (fond jaune dans le dialogue) = 3
notification de téléphonie (fond bleu clair dans le dialogue) = 5
Cette variable est générée avec chaque message entrant mais n'apparaît pas dans la fiche client.

Vous pouvez l'utiliser dans le champ "Variable de comparaison" pour configurer des conditions pour les déclencheurs de blocs et les connexions.

#{date_of_creation} - date à laquelle l'utilisateur a été ajouté au bot ou lui a envoyé un message pour la première fois

#{full_name} - nom complet de l'utilisateur (prénom et nom)

#{group} - bot auquel le client est lié (affiché comme "Lié au bot" dans la fiche client)

#{main_client_id} - ID du client principal parmi un groupe de fiches clients liées

#{message_id} - ID de l'état actuel de la conversation avec le client (par défaut NONE)

#{messenger} - nom de la messagerie d'où vient le client

#{name} - prénom de l'utilisateur

#{next_day} - date de demain au format jj.mm.aaaa (utile pour planifier des messages)

#{order_id} - identifiant de la commande (ID client et ID de commande interne séparés par un trait d'union)

#{order} - contenu de la commande soumise par l'utilisateur

#{platform_id} - ID client dans la plateforme de messagerie

#{question} - message envoyé par l'utilisateur

#{timestamp} - horodatage actuel incluant les millisecondes

#{time_of_creation} - heure à laquelle l'utilisateur a été ajouté au bot ou lui a envoyé un message pour la première fois

#{wa_bot} - numéro WhatsApp auquel l'utilisateur a envoyé un message (utile pour transmettre aux champs CRM et distribuer les prospects entre les gestionnaires)

#{weekday} - jour de la semaine sous forme de nombre (lundi = 1, mardi = 2, etc.)

Valeurs de client_type

Variables système

Le système génère automatiquement diverses variables d'exécution pendant le fonctionnement d'un bot. Vous pouvez utiliser ces variables lors de la construction de votre bot. Voici une liste de celles qui pourraient vous être utiles.

Vous pouvez trouver des variables système supplémentaires dans la documentation. Elles se trouvent dans les sections pertinentes à leur utilisation.

phone - numéro de téléphone

notSubscribed - si la variable est égale à 1, le client s'est désabonné des messages et ne recevra aucun message

clientBlocked - le client est bloqué et le bot ne fonctionne pas pour lui

story_url - identifiant de la story Instagram à laquelle le client a répondu

viewed_page - page à partir de laquelle l'utilisateur écrit dans le chat en ligne

wa_bot - numéro de téléphone du bot WhatsApp

Pour savoir quelles variables peuvent être créées lors du paiement, consultez les guides d'intégration des services de paiement dans la section "Système de paiement".

Variables personnalisées

Les variables personnalisées sont divisées en :

Chaque type de variable sera expliqué ci-dessous.

Veuillez éviter d'utiliser les mêmes noms pour différents types de variables afin d'éviter toute confusion lorsque le constructeur affiche ou utilise une valeur autre que celle attendue.

Lors de l'attribution d'une valeur à une variable, il est important de spécifier son type en utilisant le préfixe approprié :

client. (pour les variables client) et project. (pour les variables de projet). Aucun préfixe n'est utilisé pour les variables d'affaire.

Le préfixe est omis lors de la récupération de la valeur d'une variable.

Exemple :
Imaginons que vous souhaitiez créer une variable de projet appelée like pour servir de compteur de likes de vos clients.

project.like = 0 - déclaration, effectuée une fois

Dans le bloc où vous devez compter les likes, écrivez :
project.like = like + 1

Ordre de priorité des variables :
les variables d'affaire ont la priorité la plus élevée, suivies des variables client, puis des variables de projet.

ID de messagerie (platform_id)

L'ID de messagerie (platform_id) est l'identifiant de l'utilisateur/chat/canal au sein de la messagerie. Pour le trouver, ouvrez la conversation avec le client souhaité dans la section "Clients". Sur le côté droit de la fenêtre de chat, accédez à l'onglet "À propos du client - Variables système" ou à l'onglet "Tout".

Le platform_id est une variable permanente générée par le système représentant l'ID de messagerie unique de l'utilisateur.

  • Persistance : Cet ID reste constant pour un utilisateur. Même si vous supprimez son enregistrement du constructeur, son platform_id sera le même lors d'une réinscription.
  • Origine : L'ID est attribué par la plateforme de messagerie (par exemple, Telegram, WhatsApp) lorsque l'utilisateur interagit pour la première fois avec le bot.

L'exemple suivant montre comment le platform_id apparaît dans une fiche client.

La variable platform_id existe pour les utilisateurs réguliers ainsi que pour les communautés, les canaux et les chats.

Pour obtenir le platform_id (ID de messagerie) d'un canal Telegram dont le bot est administrateur, envoyez simplement un message au canal depuis votre compte personnel. Cela créera automatiquement un dialogue entre le bot et le canal.

Vous pouvez copier la valeur platform_id du canal dans la section "À propos du client".

Dans Telegram, l'ID de messagerie des canaux commence toujours par un signe moins (-). Lors de l'utilisation de fonctions, assurez-vous d'inclure la valeur entière, y compris le signe moins.

Comment utiliser les variables

Les variables peuvent être utilisées dans les déclencheurs, les commandes, les réponses des utilisateurs, les blocs, etc. Examinons un exemple concret lors de la création d'un entonnoir pour une agence immobilière.

Alors, créons un bloc Démarrage :

Étape 1 : Créer le bloc "Merci"

Créez un nouveau bloc avec un message remerciant l'utilisateur pour sa saisie.

Étape 2 : Configurer la transition

Sur la connexion menant à ce bloc, configurez le déclencheur suivant :

  1. Activez l'interrupteur "L'utilisateur saisit des données".
  2. Dans le champ "Données saisies", entrez le nom de la variable : name.

La saisie de l'utilisateur est stockée dans la variable Name. Cette valeur peut être réutilisée dans n'importe quel bloc ultérieur en invoquant la variable avec la syntaxe #{Name}, par exemple : Bienvenue, #{Name}!.

Le bot fonctionnera comme suit :

Maintenant, complexifions un peu la tâche.

Dans ce même bloc, nous demanderons à l'utilisateur s'il est intéressé par un logement neuf (primaire) ou ancien (secondaire) :

Ensuite, créez des connexions à partir des boutons "Logement neuf" et "Logement ancien" dans le bloc "Chat".

Examinons maintenant la deuxième façon d'utiliser les variables dans les blocs.

Sélectionnez le bloc de droite et entrez le texte suivant dans le champ "Calculatrice" :
client_interest = Logement neuf. Dans le bloc de gauche, entrez :
client_interest = Logement ancien.

Une variable est attribuée à l'utilisateur lorsqu'il passe à l'un de ces blocs. Nous pourrons l'utiliser plus tard lors de la création d'une commande.

Ensuite, nous demanderons au client son budget pour l'achat d'un bien immobilier dans ces blocs, et créerons deux autres blocs avec des flèches y menant en fonction des déclencheurs de réponse du client.

À partir du bloc "Quel est votre budget ?", créez une connexion et définissez une condition de déclencheur pour segmenter les utilisateurs en fonction de leur saisie.

  1. Dans les paramètres de la connexion, activez la case à cocher pour "L'utilisateur saisit des données".
  2. Attribuez un nom de variable (par exemple, budget) pour stocker la réponse du client.
  3. Dans le champ "Variable", utilisez la variable intégrée #{question} (qui contient le dernier message de l'utilisateur) pour créer une condition.
    • Exemple : #{question} <= 1000000

Pour toutes les connexions vers les blocs "Leads", activez "L'utilisateur saisit des données" et définissez la variable.

Vous pouvez également définir une variable supplémentaire directement dans le bloc "Leads" pour fournir des informations plus complètes sur l'affaire.

Changez maintenant le type des deux derniers blocs en "Leads" et voyez les résultats :

Testons le flux en action :

Vous pouvez consulter l'affaire créée et les données stockées du client en allant dans la section "Clients" et en ouvrant la conversation concernée. Les variables d'affaire y seront visibles.

Vous savez maintenant comment utiliser les variables d'au moins trois manières différentes :

  1. Attribuer des noms de variables aux données saisies par l'utilisateur (par exemple, "Nom", "Budget")
  2. Attribuer une valeur de variable lors du passage à un bloc (par exemple, client_interest = Logement neuf)

Comment afficher les variables

Pour afficher les variables d'un client, accédez à la section "Clients" et ouvrez sa fiche client.

Les variables sont affichées sous forme de liste dans la fiche client :

  • Chaque variable occupe sa propre ligne.
  • Le nom de la variable est affiché à gauche.
  • Sa valeur correspondante est affichée à droite.

Pour modifier une variable :

Survolez sa ligne dans la liste pour révéler un bouton d'action. Cliquer sur ce bouton vous permet de :

  • Modifier le nom de la variable.
  • Modifier la valeur de la variable.
  • Supprimer complètement la variable.

Les variables système ne peuvent pas être modifiées !

Comment définir des variables client

Les variables client ne sont pas supprimées, réinitialisées ou perdues lors de l'utilisation du bloc "Fin de la collecte de données" (bloc rouge).

Une variable client peut être définie de deux manières : explicite et implicite.

Une manière explicite de définir une variable est de la définir dans le champ "Calculatrice" de l'un des blocs de l'entonnoir.

Exemple : client.age = 28 ou client.age = 28:

La manière implicite est de définir une variable dans le champ de saisie des données de la flèche.

Exemple :

Créons un bloc où nous demandons le nom du client, et créons également un bloc en dessous :

Ensuite, accédez aux paramètres de la connexion et activez l'option "L'utilisateur saisit des données".

Utilisez le préfixe client. lors du nommage de votre variable (par exemple, client.name) pour stocker la saisie de l'utilisateur. Cette variable peut ensuite être référencée dans les messages ultérieurs sous la forme #{client.name}.

Les variables client sont utilisées exactement comme les variables régulières dans le constructeur, mais sans le préfixe client.

Comment définir des variables de projet

Les variables globales ne sont pas supprimées, réinitialisées ou perdues lors de l'utilisation du bloc "Leads" (bloc rouge).

Les variables globales sont accessibles à tous les utilisateurs du bot. Elles sont idéales pour contrôler le comportement du bot ou faciliter les interactions entre différents utilisateurs.

Exemple de cas d'utilisation :
Un utilisateur peut publier un article dans un canal de marketplace en définissant une variable (par exemple, project.latest_listing), et tous les autres utilisateurs peuvent le voir et y répondre.

Syntaxe d'attribution

Pour créer ou mettre à jour une variable globale, utilisez le préfixe project. dans la Calculatrice :

Exemples :

  • project.product_shop = 28
  • project.age = 28

Elles peuvent être utilisées sans aucun préfixe.

Voyons comment les données sont affichées dans le tableau.

Maintenant, exécutez le bloc "Démarrage" en mode test.

Nous pouvons voir les données qui ont été écrites dans la variable à partir du tableau dans le message envoyé par le bot. Parce que nous avons référencé la variable dans le message en utilisant la syntaxe #{}, les données qui y étaient stockées ont été affichées dans le chat du bot.

Plus de détails sur la façon de travailler avec la fonction get_records_from_table() sont expliqués dans l'article "Assistant IA avec tableau MaviBot".

Le préfixe project. a permis à la fonction d'écrire les données du tableau directement dans les variables globales du projet, accessibles dans la section "Variables".

Vous pouvez modifier les variables de projet dans les paramètres du projet.

Exemple : utilisation des variables de projet

Créez un système qui attribue un numéro séquentiel à chaque nouveau client qui entre dans le bot.

Mise en œuvre :

  1. Accédez à vos Paramètres du projet.
  2. Créez une nouvelle variable de projet (par exemple, project.client_counter).

  1. Définissez sa valeur initiale (par exemple, 0) qui signifie "Aucun client dans le bot" :

Dans le bloc de démarrage du bot, ajoutez une logique qui :

  1. Incrémente la valeur de la variable de projet de 1.
  2. Attribue la nouvelle valeur à une variable spécifique au client pour l'utilisateur actuel.

N'oubliez pas de définir une restriction pour que le compteur ne puisse pas être incrémenté deux fois pour le même client.

Comment définir des variables constantes

Les constantes sont des valeurs fixes qui restent inchangées (ou changent rarement) tout au long du cycle de vie d'un projet.

Différence clé avec les variables globales :

Contrairement aux variables globales, les constantes sont spécifiques au client. Si la valeur d'une constante est modifiée, le changement s'applique uniquement à la session de ce client individuel.

Cas d'utilisation courants :

Les constantes sont idéales pour stocker des données statiques telles que :

  • Prix des produits et remises clients
  • Jetons d'intégration et clés API
  • Coordonnées du vendeur ou du support
  • Toute autre valeur de configuration fixe

Exemple : utilisation des variables constantes

Par exemple, la remise d'un client pourrait être de 10 % par défaut, mais passer à 25 % lors de la saisie d'un code promo.

Dans "Paramètres du projet" → "Constantes", saisissez : Remise : 10

Pour saisir un code promo, ajoutez un bloc "Déclencheur", où nous attribuons à la variable discount la valeur 25.

Affichez la variable qui montre le montant de la remise dans le bloc vert :

Étape 1 : Configurer la transition automatique
Créez une connexion avec une minuterie de zéro seconde à partir du bloc gris. Cela garantit que la remise est appliquée immédiatement et que le client passe au message dans le bloc de démarrage.

Étape 2 : Tester le flux
Maintenant, écrivez un message au bot pour déclencher et tester la séquence entière.

La remise standard est de 10 % sans code promo. Cependant, la saisie d'un code promo valide change la situation.

Ainsi, après avoir saisi le code promo, la variable "discount" pour ce client est devenue 25.

Cela s'est produit car une attribution comme discount = 25 a défini la valeur pour la variable d'affaire, plutôt que de modifier la valeur de la constante portant le même nom.

Variables clés de l'affaire

name - nom de l'affaire. Le terme Name est utilisé pour la version internationale du projet.

description - description de l'affaire. Description est utilisé dans la version internationale du projet

budget - montant de l'affaire (nombre).

Pour modifier les variables à l'aide de la requête API /set_order_vars, vous devez utiliser les noms de cet guide exactement comme indiqué, en respectant la casse et la version du projet.

Limites

Longueur maximale du nom de variable : 500 caractères

Longueur maximale de la valeur de variable : 100 000 caractères

Nombre maximal de variables par client ou affaire : 1 000 caractères.

Comment travailler correctement avec les variables

Quand faut-il mettre la valeur d'une variable entre guillemets ?

Par exemple, client_id = 1202020202 ou client_id = '1202020202' ?

Les deux options de syntaxe sont fonctionnellement correctes. L'utilisation de guillemets autour d'une valeur n'affecte que sa mise en évidence visuelle dans l'éditeur de la calculatrice.

Cependant, le respect de conventions de codage cohérentes améliore la lisibilité et la maintenabilité :

  • Omettre les guillemets pour les valeurs numériques (par exemple, discount = 25).
  • Utiliser des guillemets pour les valeurs chaîne de caractères (par exemple, status = "actif").

Quelle est la syntaxe correcte pour passer des identifiants tels que l'ID client, l'ID site, l'ID bloc ou l'ID certificat aux fonctions — doivent-ils être mis entre guillemets ?

Un ID ne doit pas être mis entre guillemets lorsqu'il est passé à une méthode ou une fonction :

Faut-il utiliser des guillemets doubles ou des guillemets simples ?

Il n'y a aucune différence entre l'utilisation de guillemets simples ou doubles, mais nous recommandons d'utiliser des guillemets doubles. Ainsi, par exemple, lors de l'insertion d'une variable dans une chaîne, la variable sera surlignée d'une couleur différente, ce qui la rendra plus facile à remarquer.

Comment les espaces doivent-ils être placés ?

Cela fonctionne-t-il de la même manière s'il y a un espace entre la variable et le signe égal (par exemple, ans="oui", ans = "oui", ans= "oui", ans ="oui" ?

Les espaces n'affectent pas le fonctionnement des méthodes, variables ou fonctions. Cependant, il est recommandé d'utiliser des espaces dans le code pour améliorer la lisibilité.

Comment écrire correctement des commentaires dans la calculatrice

Pour plus de détails sur la façon d'écrire des commentaires dans la Calculatrice, veuillez consulter cet article.

Comment comparer des variables

Vous pouvez contrôler le flux du chatbot en comparant les valeurs des variables. Cela vous permet de créer une logique conditionnelle, comme vérifier l'âge d'un utilisateur pour la conformité légale ou acheminer les interactions en fonction de la plateforme de messagerie de l'utilisateur.

Voici comment diviser l'entonnoir par différentes messageries ou par différents comptes de la même messagerie expliqué ici.

Opérateurs pris en charge :

"+" : addition
"-"' : soustraction
"*" multiplication
"/" : division
"%'"* : reste de la division*
"^" "**" : exponentiation
"and" "AND" "&&" : ET logique
"or" "OR" "||" : OU logique

Opérateurs de comparaison :
"==" — égal à
"!=" — différent de
">" — supérieur à
"<" — inférieur à
">=" — supérieur ou égal à
"<=" — inférieur ou égal à

IMPORTANT !
Pour vérifier que la variable intégrée tag (le tag de lancement du bot) n'est pas présente dans la fiche du client, utilisez la méthode de comparaison suivante :

tag == "NONE"

Les variables doivent être comparées dans la condition à l'intérieur du champ "Variable" (à la fois dans les paramètres de connexion et dans les paramètres du bloc) :

Exemple de comparaison de variables dans le champ "Variable" d'un bloc déclencheur.

Exemple de comparaison de variables dans le champ "Variable" d'une connexion de bloc.

Comment les variables et les déclencheurs fonctionnent ensemble

Pour qu'une connexion soit activée, les deux déclencheurs doivent être remplis :

  1. La condition dans le champ "Déclencheur".
  2. La logique de comparaison dans le champ "Variable".

Comprendre le champ "Variable"

Si vous entrez uniquement un nom de variable (par exemple, client_type) dans le champ "Variable" sans expression, le système vérifie l'existence ou la véracité de la valeur de la variable. Il ne la compare pas à la saisie brute de l'utilisateur.

Exemple :
La configuration ci-dessous vérifie si le client vient de WhatsApp en vérifiant que la variable client_type est égale à 6 (où 6 représente WhatsApp).

client_type == 6

L'exemple ci-dessous fonctionne de manière identique :

Veuillez noter !
Vous ne pouvez pas spécifier plusieurs valeurs pour la comparaison de variables dans le champ "Déclencheur".

Ceci est incorrect !

Si vous devez comparer plusieurs variables, spécifiez leurs valeurs dans le champ "Variable".

Ces options sont correctes.

client_type == 3 transition si la valeur de la variable est égale à 3
attachments != None transition si la variable contient une valeur
attachments == None transition si la variable n'est pas définie
product_quantity >= 100 transition si la quantité de produit est supérieure ou égale à 100
product_quantity <= 100 transition si la quantité de produit est inférieure ou égale à 100
name == "John" transition si le nom de la variable est égal à John

Pour vérifier si une variable est vide ou non, utilisez les expressions :
&#xNAN;"#{value}" == ""
"#{value}" != ""

(où value est le nom de la variable).

Le résultat de l'opération de comparaison renvoie une valeur booléenne : True ou False.

Longueur maximale de l'expression : 1000 caractères

La valeur par défaut sera renvoyée comme résultat lors de la tentative de comparaison de valeurs de types différents.

"==" - False "<" - False
"!=" - True ">=" - False
">" - False "<=" - False

IMPORTANT !
Pour vérifier que la variable intégrée tag (le tag de lancement du bot) n'est pas présente dans la fiche du client, utilisez la méthode de comparaison suivante :

tag == "NONE"

Exemple : un bot qui vérifie l'âge d'un utilisateur (age).

  • Si age < 18, il envoie un message pour les mineurs.
  • Si age >= 18, il envoie un message pour les adultes.

Notez que le flux comprend un bloc sans déclencheur, avec des connexions temporisées qui en partent.

Ce bloc est intentionnellement conçu pour montrer comment construire des flux où le bot réagit non pas aux actions de l'utilisateur, mais aux résultats de calcul. À la première étape, la réponse est enregistrée dans une variable, puis la comparaison a lieu. Le délai sur les flèches est défini sur 0 pour une réponse instantanée.

La comparaison "Age >= 18" peut également être exprimée comme "supérieur ou égal à 18."

Veuillez noter les erreurs dans les déclencheurs :

Un nombre ne peut pas être simultanément supérieur, inférieur et égal à 18 !

Ces déclencheurs sont dénués de sens. Chaque nombre est soit inférieur à 18, soit supérieur à 18, soit égal à 18.

Important !

Les déclencheurs logiques avec des variables doivent être écrits dans le champ "Variable", pas dans le champ "Déclencheur" !

Par exemple, dans l'image ci-dessous, le bloc sera déclenché si la variable phone est remplie (c'est-à-dire différente de None) :

L'exemple suivant montre comment combiner des opérateurs :

Si le client a une variable age avec une valeur comprise entre 18 et 99, le bloc sera déclenché. Si la variable est manquante, ou si l'âge est inférieur à 18 ou supérieur à 99, le bloc ne s'activera pas.

Note !

Si vous comparez une variable à une valeur entre guillemets, assurez-vous qu'il n'y a pas d'espaces entre les guillemets et la valeur ; sinon, le bloc pourrait ne pas se déclencher ou se comporter incorrectement !

Correct (pas d'espace avant le guillemet ou après la valeur my_new_bot) :

Incorrect (avec un espace avant le guillemet) :