Variables globales - Référence des variables système ChatMaxima

Référence des variables globales ChatMaxima (champs système sys_) servant à personnaliser bots, diffusions et réponses automatiques avec les données de contact et de session.

Vue d'ensemble

Les variables globales, également appelées variables système, sont des espaces réservés intégrés que ChatMaxima résout automatiquement au moment de l'exécution. Elles vous donnent accès aux informations concernant le contact actuel, la conversation, le message, la plateforme et les médias sans aucune configuration. Chaque variable globale commence par le préfixe sys_ et est entourée d'accolades simples, comme {sys_account_contact_name}.

Utilisez les variables globales partout où vous avez besoin de personnaliser du contenu, d'acheminer des conversations ou de transmettre du contexte à des intégrations : blocs du générateur de bots, modèles de diffusion, réponses automatiques, modèles de messages et charges utiles d'API ou de webhook.

Comment insérer une variable globale

Dans n'importe quel champ de saisie pris en charge, tapez simplement { et un sélecteur apparaît, listant chaque variable globale et chaque attribut personnalisé disponible. Sélectionnez celui que vous voulez et ChatMaxima l'insère au format correct.

Cliquez dans le champ où vous souhaitez insérer la variable
Tapez une seule accolade ouvrante {
Choisissez la variable dans le menu déroulant qui apparaît
Le sélecteur insère le jeton complet, par exemple {sys_account_contact_name}

Remarque : Les noms de variables sont sensibles à la casse. Utilisez toujours des accolades simples autour du nom de la variable.

Variables globales prises en charge

Variable	Description
`{sys_account_contact_name}`	Nom du contact associé à la session du chatbot
`{sys_account_contact_email}`	Adresse e-mail du contact interagissant avec le chatbot
`{sys_account_contact_mobile}`	Numéro de mobile associé au compte du contact
`{sys_contact_reference_id}`	Identifiant de référence de la conversation en cours
`{sys_current_message}`	Message en cours de traitement dans un bot
`{sys_account_platform}`	Plateforme actuelle traitée dans un bot (par exemple WhatsApp, Facebook, Telegram)
`{sys_current_date_time}`	Date et heure actuelles au moment de l'exécution
`{sys_current_page_url}`	URL de la page web où le chatbot est actuellement actif
`{sys_current_conversation}`	Historique complet de la conversation, y compris les messages et les horodatages
`{sys_ai_intent}`	Intention détectée dans la requête de l'utilisateur dans les blocs MaxIA (par exemple `general_query`, `human_agent`, `booking_request`)
`{sys_current_media}`	URL, type et nom de fichier du média le plus récent (image, vidéo, audio, document) téléversé par l'utilisateur, sous forme d'objet JSON. Utilisez `{sys_current_media.url}` ou `{sys_current_media.type}` pour des champs spécifiques

Variables de contact

Elles correspondent aux données stockées dans le profil du contact.

{sys_account_contact_name} est la variable la plus courante pour la personnalisation. Utilisez-la dans les messages d'accueil, les modèles de diffusion et les messages de confirmation.
{sys_account_contact_email} et {sys_account_contact_mobile} sont utiles pour transmettre l'identité aux webhooks, à la synchronisation CRM et aux flux de vérification.
{sys_contact_reference_id} identifie de manière unique le fil de conversation, ce qui est utile pour corréler des événements entre plusieurs systèmes.

Variables de conversation

Elles décrivent le message actuel et l'historique.

{sys_current_message} contient le texte que l'utilisateur vient d'envoyer. Utilisez-la pour renvoyer la saisie, la journaliser ou la transmettre à un bloc API.
{sys_current_conversation} contient l'historique complet du chat avec les horodatages, utile pour la synthèse par IA ou le contexte de transfert.

Variables de canal et de contexte

{sys_account_platform} vous permet de ramifier la logique selon le canal, par exemple en envoyant un message différent sur WhatsApp et sur le widget web.
{sys_current_page_url} capture l'endroit où se trouvait le visiteur sur votre site lorsqu'il a commencé à discuter. Utile pour l'acheminement ou l'analyse.
{sys_current_date_time} horodate le moment de l'exécution, utile pour les horodatages dans les tickets ou les systèmes en aval.

Variables d'IA et de médias

{sys_ai_intent} est renseignée par les blocs MaxIA après la détection d'intention. Ramifiez votre bot selon que l'utilisateur souhaite human_agent, booking_request, general_query, et ainsi de suite.
{sys_current_media} est un objet JSON décrivant le fichier le plus récent envoyé par l'utilisateur. Accédez aux champs individuels avec la notation par points :

{sys_current_media.url}
{sys_current_media.type}
{sys_current_media.filename}

Variables globales et attributs personnalisés

ChatMaxima prend en charge deux types d'espaces réservés dynamiques. Les deux apparaissent dans le même sélecteur {.

	Variables globales	Attributs personnalisés
Préfixe	`sys_`	Aucun (vous choisissez le nom)
Créés par	ChatMaxima (intégrés)	Vous, dans les paramètres des contacts
Exemples	`{sys_account_contact_name}`, `{sys_current_message}`	`{company_name}`, `{order_id}`, `{plan_type}`
Source de la valeur	Session, profil de contact, message ou contexte de plateforme	Stockée pour chaque contact, renseignée manuellement, par import CSV, par bloc de bot ou par API
À utiliser quand	La donnée est quelque chose que ChatMaxima connaît déjà	La donnée est spécifique à votre logique métier

Où utiliser les variables globales

Les variables globales fonctionnent sur toute la plateforme partout où le sélecteur { est disponible :

Blocs du générateur de bots : Envoyer un message, Envoyer un e-mail, bloc API, bloc Webhook, bloc Conditionnel, bloc Définir un attribut, et la plupart des autres blocs acceptent des variables dans leurs champs de texte et de paramètres.
Modèles de diffusion : associez les espaces réservés des modèles WhatsApp approuvés ({{1}}, {{2}}) à des variables globales lors de la création d'une diffusion.
Réponses automatiques et réponses prédéfinies : personnalisez les messages d'absence et les réponses enregistrées.
Invites IA de la base de connaissances : transmettez le contexte de session à l'invite système de votre agent IA.
Webhooks et intégrations : incluez des variables dans les URL, les en-têtes et les corps de requête des webhooks pour transférer le contexte vers des systèmes externes.

Exemples de cas d'usage

Personnaliser une diffusion WhatsApp

Modèle approuvé :

Hello {{1}}, your order {{2}} has been confirmed.

Dans le composeur de diffusion, associez {{1}} à {sys_account_contact_name} et {{2}} à votre attribut personnalisé {order_id}. Chaque destinataire reçoit un message tel que « Hello Priya, your order ORD-1042 has been confirmed. »

Saluer par le nom dans un bot

Placez un bloc Envoyer un message au début de votre flux avec :

Hi {sys_account_contact_name}, how can we help you today?

Si le contact n'a aucun nom enregistré, l'espace réservé se résout en valeur vide, alors ajoutez une branche de repli si nécessaire.

Acheminer selon l'intention IA

Utilisez {sys_ai_intent} dans un bloc Conditionnel après un bloc MaxIA :

Si {sys_ai_intent} est égal à human_agent, acheminez vers le chat en direct
Si {sys_ai_intent} est égal à booking_request, passez à votre flux de réservation
Sinon, continuez avec le flux FAQ

Transmettre du contexte à un webhook

Dans le corps d'un bloc Webhook :

{
  "name": "{sys_account_contact_name}",
  "phone": "{sys_account_contact_mobile}",
  "message": "{sys_current_message}",
  "platform": "{sys_account_platform}",
  "page": "{sys_current_page_url}"
}

ChatMaxima remplace chaque variable par la valeur en direct avant d'envoyer la requête.

Transférer un fichier téléversé vers votre backend

Si un utilisateur envoie une image et que vous devez l'enregistrer côté serveur, utilisez :

{
  "file_url": "{sys_current_media.url}",
  "file_type": "{sys_current_media.type}",
  "file_name": "{sys_current_media.filename}"
}

Bonnes pratiques

Validez les données de vos contacts : si une variable globale comme {sys_account_contact_mobile} est manquante pour un contact, l'espace réservé se résout en valeur vide. Nettoyez vos données de contact avant de diffuser.
Combinez avec les attributs personnalisés : utilisez les variables globales pour les données d'identité et de session, et les attributs personnalisés pour les champs spécifiques à votre activité comme les numéros de commande, les types de forfait ou les dates de rendez-vous.
Testez avant d'envoyer : lancez une diffusion ou une session de bot de test sur votre propre fiche de contact pour confirmer que chaque variable se résout correctement.
Utilisez la notation par points pour les variables JSON : {sys_current_media} renvoie un objet JSON. Accédez toujours à des champs spécifiques comme {sys_current_media.url} au lieu d'utiliser l'objet complet en texte brut.
Évitez le codage en dur : partout où vous taperiez sinon le nom, le mobile ou l'e-mail d'un contact, optez plutôt pour une variable globale.

Dépannage

La variable apparaît comme texte littéral dans la sortie

Vérifiez que la variable est entourée d'accolades simples et non doubles : {sys_account_contact_name} est correct, {{sys_account_contact_name}} ne l'est pas (les accolades doubles sont la syntaxe des espaces réservés des modèles Meta, utilisée uniquement dans les modèles WhatsApp approuvés).
Confirmez que l'orthographe correspond exactement à celle du sélecteur. Les variables sont sensibles à la casse.
Assurez-vous d'utiliser la variable dans un champ pris en charge. Certains champs en texte brut en dehors des éditeurs de bot, de diffusion et de modèle n'analysent pas les variables.

La variable se résout en valeur vide

Vérifiez que la donnée sous-jacente existe dans le profil du contact (par exemple, que le contact a réellement un nom ou un mobile enregistré).
Pour {sys_ai_intent}, confirmez qu'un bloc MaxIA s'est exécuté avant le point où la variable est utilisée.
Pour {sys_current_media}, confirmez que l'utilisateur a envoyé un média dans cette session.

Vous avez besoin d'une valeur que ChatMaxima n'expose pas

Si la valeur dont vous avez besoin ne figure pas dans la liste des variables globales, créez un attribut personnalisé et renseignez-le via le profil du contact, un import CSV, un appel API ou un bloc de bot Définir un attribut.