Variables et données dynamiques

Une variable est un emplacement, écrit entre doubles accolades, que Flowtative remplace par une valeur au moment de la conversation : Bonjour {{caller.name}} devient « Bonjour Claire Martin ». Les variables permettent à un même agent de saluer chaque client par son nom, de reprendre un numéro de commande donné plus tôt ou de transmettre une information à la fin de l'appel. Cette page décrit d'où viennent les valeurs, où les utiliser et comment éviter les trous quand une valeur manque.

Les quatre sources de donnéesCopier le lien

Écrire une variableCopier le lien

La syntaxe est la même partout où les variables sont acceptées :

• {{nom}} ou {{groupe.nom}} : le nom peut être pointé, par exemple {{caller.phone_number}} ;
• les espaces autour du nom sont tolérés : {{ company }} équivaut à {{company}} ;
• la valeur est substituée au moment de la conversation, pas à l'enregistrement : le texte enregistré garde les accolades.

Dans le prompt d'un agentCopier le lien

Le champ Prompt système de l'éditeur d'agent (section Identité & prompt) aide à insérer les variables sans faute de frappe.

1. Placez le curseur à l'endroit voulu.
2. Tapez {{, ou cliquez sur Insérer une variable. Un menu s'ouvre, avec un champ Rechercher une variable….
3. Tapez quelques lettres pour filtrer, par nom ou par libellé (« tél » trouve Téléphone).
4. Cliquez sur la variable : elle est insérée sous sa forme complète, et le curseur se place juste après.

Les variables proposéesCopier le lien

Le menu regroupe les variables de contexte que l'éditeur connaît :

Une variable proposée n'a une valeur que si la conversation la fournit. Le nom ou l'e-mail de l'appelant, par exemple, ne sont pas connus d'un simple appel entrant : il faut les transmettre au démarrage ou les retrouver pendant la conversation (voir Exemple : personnaliser l'accueil).

Variables standard et personnaliséesCopier le lien

Vous pouvez écrire n'importe quel autre nom, par exemple {{numero_contrat}} : c'est une variable personnalisée, fournie à l'exécution. L'éditeur les distingue :

• dans le texte, une variable du catalogue et une variable personnalisée sont surlignées dans deux couleurs différentes ;
• sous le champ, la ligne Variables : récapitule toutes les variables détectées, avec la même distinction. Au survol, une variable du catalogue affiche son libellé suivi de « variable standard », une variable personnalisée « Variable personnalisée (fournie à l'exécution) ».

Exemple de promptCopier le lien

Rôle : assistant d'accueil de {{company}}.
Contexte : nous sommes le {{currentDate}}. L'appelant appelle depuis le {{caller.phone_number}}.
Objectif : identifier le motif de l'appel et orienter vers le bon service.
Si le numéro de contrat {{numero_contrat}} est vide, demande-le avant toute autre question.

Dans un flowCopier le lien

Dans un flow, les blocs partagent un état commun : tout ce qu'une fonction ou un bloc enregistre pendant la conversation est rangé sous state.parameters.<nom> et reste lisible par tous les blocs suivants. Pour le réutiliser dans un texte, écrivez {{state.parameters.<nom>}}.

Les champs qui acceptent des variablesCopier le lien

Ces champs portent une barre « Tapez {{ ou insérez » avec un bouton Insérer, et listent sous la saisie les variables qu'ils utilisent. La substitution a lieu à chaque entrée dans le bloc : si une valeur change entre deux passages, le texte suit.

Les variables proposées par l'éditeurCopier le lien

Le menu Insérer et le panneau Variables de l'éditeur plein écran (bouton Agrandir) proposent automatiquement :

Les écritures d'état de toutes les fonctions du flow sont proposées dans tous les blocs, puisque l'état est partagé. Si la liste est vide, le menu indique « Aucune variable détectée — les écritures d'état des fonctions en créent. » : commencez par déclarer une écriture d'état dans une fonction (voir Fonctions appelables).

Dans l'éditeur plein écran, le panneau Variables se filtre avec Filtrer… ; un clic insère la variable au curseur, et la mention utilisée signale celles déjà présentes dans le texte.

Prévoir une valeur de repliCopier le lien

Une variable non résolue est remplacée par un texte vide. Pour éviter une phrase bancale, ajoutez une valeur de repli après || :

Bonjour {{state.parameters.prenom || Madame, Monsieur}}, merci de votre appel.

Si prenom n'a pas encore été enregistré, l'IA reçoit « Bonjour Madame, Monsieur, merci de votre appel. ».

Valeurs fixes et cheminsCopier le lien

Certains champs ne prennent pas un texte avec des {{…}}, mais une seule valeur, fixe ou lue dans la conversation au moment de l'exécution. Une valeur qui commence par state., args. ou result. est un chemin ; toute autre valeur est prise telle quelle.

Dans les Paramètres de fin et les champs de la Validation humaine, un bouton bascule chaque valeur entre texte fixe (abc) et chemin (path). En mode path, la valeur s'affiche précédée d'accolades, par exemple state.parameters.orderId.

Données d'une base de contactsCopier le lien

Dans une campagne d'appels sortants, chaque appel part d'une fiche de la base de contacts. L'agent qui appelle peut reprendre les colonnes de cette fiche dans son prompt avec la forme ${contact.<colonne>}, où <colonne> est le nom exact de la colonne :

Bonjour ${contact.prenom}, je vous appelle de la part du cabinet au sujet
de votre rendez-vous du ${contact.rdv_date} à ${contact.rdv_heure}.

Pour vérifier le résultat, l'assistant de création de campagne affiche à sa première étape :

• l'Aperçu de l'ouverture : la première phrase du prompt qui commence par « Bonjour », remplie avec la première fiche valide de la base. Tant qu'aucune base n'est choisie, ou si une colonne est vide, la variable reste visible sous la forme ⟨prenom ?⟩ ;
• Variables détectées dans l'agent : les colonnes que l'agent attend. L'assistant y reconnaît ${contact.colonne} et aussi les variables simples sans point, comme {{rdv_date}}.

Si l'assistant indique « Aucune variable dans le prompt de l'agent », l'agent parlera sans personnalisation. Voir Créer une campagne.

Valeurs fournies au démarrageCopier le lien

Deux autres moyens fournissent des variables à l'ouverture de la conversation :

• Automatisations : le champ Variables par défaut (JSON, optionnel), par exemple { "reason": "rappel_commercial" }, est transmis à l'agent à chaque déclenchement, et un appel API peut le compléter. L'agent lit alors {{reason}}. Voir Automatisations.
• Testeur : les Variables de test simulent les données d'une vraie conversation, en chat comme en voix. Voir Tester un agent.

Exemple : personnaliser l'accueilCopier le lien

Ce parcours identifie l'appelant dans une base « Clients », le salue par son nom et transmet sa référence à la fin de l'appel.

Vérifier les valeurs reçuesCopier le lien

Voir Transcriptions.

Bonnes pratiquesCopier le lien

• Insérez plutôt que de taper. Le menu évite les fautes de frappe, qui produisent une variable vide sans message d'erreur.
• Prévoyez l'absence. Dans un flow, ajoutez un repli {{… || …}} à toute variable qui peut manquer. Dans le prompt d'un agent, écrivez la consigne à suivre si la valeur est vide (« si le nom est inconnu, demande-le »).
• Ne comptez pas sur le testeur pour révéler un trou. Il préremplit les variables du prompt avec des valeurs d'exemple (« Testeur », un numéro de test, la date du jour). Videz une valeur dans Variables de test pour vérifier le comportement sans elle.
• Nommez de façon stable. Choisissez un nom par information (email, numero_commande) et gardez-le dans tout le flow : l'éditeur propose les noms déjà utilisés.
• Limitez les données personnelles dans les prompts au strict nécessaire pour la conversation.

Questions fréquentesCopier le lien

Pour aller plus loinCopier le lien