Variables et templating

Les variables rendent vos prompts dynamiques : le même agent peut saluer un client par son nom, confirmer son numéro ou adapter son discours au canal, sans dupliquer le prompt. Toutes les variables et actions disponibles pour un agent sont regroupées dans le panneau Variables & actions de l’éditeur de prompt.

Insérer une variable ou une action

Ouvrir le panneau

Dans l’onglet Prompt, cliquez sur Variabiliser dans la barre d’outils du message d’accueil ou du prompt de l’agent.

Trouver l'élément

Recherchez une variable ou une action par son nom, ou filtrez la liste avec Variables ou Actions.

Insérer

Cliquez sur + pour l’insérer à l’emplacement du curseur.

Sélectionner une variable affiche en bas du panneau sa syntaxe, un exemple de valeur et sa source (par exemple « Injected by Volubile » pour une variable système). Le filtre Actions liste les actions pendant l’appel configurées sur l’agent. Insérer une action dans le prompt permet d’indiquer précisément à l’agent à quel moment de la conversation la déclencher.

Panneau Variables & actions ouvert à droite de l'éditeur de prompt, avec la liste des variables système et le détail de system.agentDid

D’où viennent les variables

Le contexte d’un appel est l’ensemble des données accessibles à l’agent pendant la conversation. Il alimente le prompt, et il est aussi transmis aux actions de type workflow pendant l’appel et au webhook post-appel.

Source	Quand elle est disponible
Variables système	Toujours, injectées par Volubile avec le préfixe `system.`
Contexte d’entrée	Fourni via API, fichier de campagne ou en-têtes SIP
Action pré-appel	Retour de l’action exécutée avant l’appel

Variables système

Ces variables sont injectées automatiquement à chaque appel.

Variable	Description	Exemple
`system.agentDid`	Numéro de téléphone de l’agent (DID), au format E.164. Disponible uniquement pour les appels entrants.	`+33199001234`
`system.agentId`	Identifiant unique de l’agent. Utile pour différencier les agents dans vos analyses.	`b8d9637f-ba51-…`
`system.callId`	Identifiant unique de l’appel. Pour le suivi, les journaux ou les références croisées.	`40387944-5065-…`
`system.conversationType`	Canal de la conversation : `call` (téléphone) ou `chat` (widget web).	`call`
`system.customerId`	Identifiant du client dans Volubile.	`1e1a79ee-c6ec-…`
`system.date`	Date du jour.	`2025-05-13`
`system.dayOfWeek`	Jour de la semaine, dans la locale du compte.	`tuesday`
`system.now`	Date et heure actuelles, dans le fuseau horaire configuré.	`2025-05-13 10:36:37`
`system.phone`	Numéro de l’interlocuteur au format local. À privilégier à l’oral.	`06 12 34 56 78`
`system.phoneE164`	Numéro de l’interlocuteur au format E.164. À privilégier pour les recherches en base ou les appels API.	`+33612345678`
`system.threadId`	Identifiant du fil de conversation.	—
`system.timeHHMM`	Heure actuelle au format HHMM, pratique pour les comparaisons d’horaires.	`1036`
`system.year`	Année en cours.	`2025`

Exemple d'objet system complet

{
  "system": {
    "agentDid": "+33199001234",
    "agentId": "b8d9637f-ba51-4aa2-84a4-80692f7bbd17",
    "callId": "40387944-5065-483f-942c-68bae81e70ec",
    "conversationType": "call",
    "customerId": "1e1a79ee-c6ec-4b07-89f0-9a414daaa9de",
    "date": "2025-05-13",
    "dayOfWeek": "tuesday",
    "phone": "06 12 34 56 78",
    "phoneE164": "+33612345678",
    "now": "2025-05-13 10:36:37",
    "timeHHMM": "1036",
    "year": "2025"
  }
}

Contexte d’entrée

Le contexte d’entrée regroupe les données que vous transmettez à l’agent pour un appel donné. Chaque clé devient une variable utilisable dans le prompt, par exemple {{ client_id }}. Le contexte d’entrée est aussi transmis à l’action pré-appel, qui peut s’en servir pour interroger vos systèmes.

API
Campagne (Excel / CSV)
En-têtes SIP

Lors de la création d’un appel sortant via l’API, passez un objet de contexte dans la requête. Il est injecté au démarrage de l’appel.

Lancer des appels sortants

Voir la référence de l’API

Pour une campagne d’appels sortants, chaque colonne du fichier devient une variable, avec la valeur de la ligne correspondant au contact appelé.

Les noms de colonnes ne doivent contenir ni espaces ni caractères spéciaux. Séparez les mots par des underscores (_), par exemple date_rdv.

Pour un appel entrant via une connexion SIP, Volubile ajoute au contexte l’en-tête User-to-User et toutes les en-têtes personnalisées commençant par X-Volubile-.Chaque en-tête est convertie en variable :

le préfixe X-Volubile- est supprimé ;
la clé est passée en minuscules ;
les tirets (-) sont remplacés par des underscores (_).

User-to-User: 6796
X-Volubile-code: ABC123
X-Volubile-client-id: CL-45678
X-Volubile-client-segment: premium

{
  "user_to_user": "6796",
  "code": "ABC123",
  "client_id": "CL-45678",
  "client_segment": "premium"
}

Tester avec un contexte d’entrée

Pour vérifier le rendu de votre prompt sans lancer de vrai appel, simulez un contexte d’entrée : cliquez sur l’icône crayon en bas du panneau Variables & actions. Dans la fenêtre Input context, saisissez un objet JSON avec les valeurs que vous enverriez via l’API, Excel ou SIP, puis cliquez sur Save. Ces valeurs sont utilisées lors de vos tests avec le bouton Test.

{
  "prenom": "Camille",
  "client_id": "CL-45678",
  "date_rdv": "2025-06-02"
}

Fenêtre Input context avec un éditeur JSON vide et les boutons Cancel et Save

Action pré-appel

Avant chaque appel entrant ou sortant, une action pré-appel peut enrichir le contexte. Elle a accès aux variables système et au contexte d’entrée, et son retour est injecté dans le contexte de l’appel pour être utilisable dans le prompt.

Utilisez system.phoneE164 ou un identifiant transmis dans le contexte d’entrée (par exemple client_id) pour retrouver la fiche du client dans votre CRM avant même qu’il ne parle.

Écrire un prompt dynamique avec Jinja

Les prompts Volubile utilisent la syntaxe Jinja, qui combine du texte statique avec trois types de délimiteurs :

Délimiteur	Rôle	Exemple
`{{ ... }}`	Insérer une variable	`Bonjour {{ prenom }}`
`{% ... %}`	Ajouter de la logique	`{% if system.timeHHMM > "1800" %}Bonsoir{% endif %}`
`{# ... #}`	Commenter (non envoyé au modèle)	`{# Note interne #}`

Accéder aux données

{{ prenom }}                     {# Valeur simple #}
{{ client.adresse.ville }}       {# Propriété imbriquée #}
{{ client['adresse']['ville'] }} {# Syntaxe équivalente #}
{{ produits[0].nom }}            {# Élément d'une liste #}

Gérer les variables absentes

Une variable peut manquer selon la source de l’appel. Testez sa présence avant de l’utiliser :

{% if system.phone is defined %}
Vous me confirmez que votre numéro est bien le {{ system.phone }} ?
{% else %}
Pouvez-vous me donner votre numéro ?
{% endif %}

Adapter le prompt au canal

Un même agent peut fonctionner en vocal et en chat. Utilisez system.conversationType pour adapter ses consignes :

{% if system.conversationType == "chat" %}
Gardez des réponses concises et faciles à lire à l'écran.
{% else %}
Gardez des réponses naturelles à l'oreille, adaptées à une conversation parlée.
{% endif %}

Les conditions imbriquées permettent de gérer des scénarios complexes, mais gardez une structure lisible pour faciliter la maintenance.

Documentation Jinja

Référence complète de la syntaxe Jinja

Découverte du produit

Téléphonie

Insérer une variable ou une action

D’où viennent les variables

Variables système

Contexte d’entrée

Lancer des appels sortants

Tester avec un contexte d’entrée

Action pré-appel

Écrire un prompt dynamique avec Jinja

Accéder aux données

Gérer les variables absentes

Adapter le prompt au canal

Documentation Jinja

​Insérer une variable ou une action

​D’où viennent les variables

​Variables système

​Contexte d’entrée

Lancer des appels sortants

​Tester avec un contexte d’entrée

​Action pré-appel

​Écrire un prompt dynamique avec Jinja

​Accéder aux données

​Gérer les variables absentes

​Adapter le prompt au canal

Documentation Jinja

Insérer une variable ou une action

D’où viennent les variables

Variables système

Contexte d’entrée

Tester avec un contexte d’entrée

Action pré-appel

Écrire un prompt dynamique avec Jinja

Accéder aux données

Gérer les variables absentes

Adapter le prompt au canal