Variable

Mémorise une valeur sous un nom, pour la réutiliser plus loin dans le plan en écrivant ce nom entre doubles accolades. C'est la base des modules avancés.

En bref

Sorties	une seule, sans étiquette
Champs	Nom, Type, puis Valeur ou Éléments (un par ligne)
Types proposés	Texte et Tableau, Texte par défaut
Variables disponibles d'office	8, sans avoir rien à configurer
Durée de vie	l'appel en cours, et lui seul
Casse du nom	sans importance : `{{DATETIME}}` et `{{datetime}}` désignent la même chose

Le texte d'aide affiché dans la fenêtre est : « Définit une variable, réutilisable via {{nom}} dans les autres modules. »

Comment ça marche

Ce qu'est une variable

Une variable est une étiquette collée sur une valeur. Vous lui donnez un nom, par exemple langue, et une valeur, par exemple fr. Partout ailleurs dans le plan, écrire {{langue}} revient à écrire fr.

L'intérêt n'est pas d'économiser de la frappe : c'est que la valeur peut changer d'un appel à l'autre. Le numéro de l'appelant, ce qu'il a composé au clavier, le nom trouvé dans votre Odoo sont des variables. Vous construisez un plan unique qui se comporte différemment selon ce qu'il découvre en chemin.

Une variable vit le temps d'un appel. Deux appels simultanés ont chacun les leurs, sans se gêner, et rien n'est conservé d'un appel au suivant.

Où l'écrire

Partout où un champ accepte du texte : l'URL et le corps d'une Requête API, les Args d'une Requête Odoo, le destinataire et le texte d'une Notification, le texte d'un Caller ID, les opérandes d'une Condition (Si), l'expression d'un Switch / Case, le message d'un Débogage, la destination d'un Appeler. Le champ Valeur de ce module l'accepte aussi : une variable peut se construire à partir d'une autre.

Un nom inconnu n'est pas signalé : il est remplacé par du vide, sans le moindre avertissement. C'est l'explication la plus fréquente d'un message qui arrive à moitié écrit.

Les variables disponibles sans rien configurer

Nom	Ce qu'elle contient
`caller`	le numéro de l'appelant, tel qu'il nous est transmis
`caller_name`	le nom de l'appelant, quand l'opérateur le transmet
`callee`	le numéro composé à l'intérieur de l'installation
`did`	le numéro d'appel qui a reçu l'appel
`tenant`	le nom court de votre installation
`domain`	le domaine SIP de votre installation
`datetime`	la date et l'heure, dans le fuseau de votre installation
`datetime_utc`	la même date et heure, en temps universel

S'y ajoutent, au fil du plan : celles que vous posez avec ce module, celle d'une Saisie DTMF, les six d'Odoo, résolution contact, et les extractions d'une Requête API ou d'une Requête Odoo.

Une neuvième variable, caller_e164, contient les écritures possibles du numéro de l'appelant. Elle sert au filtre d'une Requête Odoo et n'a guère d'usage ailleurs.

Ce qu'il faut saisir

Champ	Ce qui est attendu	Si vous le laissez vide
Nom	un nom court, en lettres non accentuées, chiffres et tiret bas	la variable n'est pas créée, le module ne fait rien et l'appel poursuit son chemin
Type	Texte pour une valeur unique, Tableau pour une liste	Texte
Valeur	le contenu, qui peut lui-même contenir `{{une_autre}}`	la variable existe, avec une valeur vide
Éléments (un par ligne)	une valeur par ligne, en Tableau	la liste est vide ; les lignes blanches sont ignorées

La marche à suivre

Posez le module Variable et reliez le nœud précédent à son entrée.
Ouvrez-le et saisissez le Nom, par exemple langue. Retenez-le tel quel, il vous servira ailleurs.
Choisissez le Type. Texte dans la grande majorité des cas ; Tableau si vous voulez une liste à tester plus loin avec l'opérateur « est dans (tableau) » d'une Condition (Si).
Renseignez la Valeur, ou les Éléments un par ligne.
Cliquez sur Sauver.
Reliez la sortie du module à la suite du plan : une sortie qui ne mène nulle part raccroche l'appel.
Plus loin dans le plan, insérez {{langue}} là où vous en avez besoin, de préférence en la copiant depuis le panneau Variables disponibles.
Posez un module Débogage juste après, avec pour message langue={{langue}}. Vous lirez la valeur réelle au lieu de la supposer.
Cliquez sur Sauver, puis sur Appliquer les modifications dans le bandeau du haut.
Appelez votre numéro, puis ouvrez le Journal de débogage du plan et vérifiez la valeur écrite.

Si ça ne marche pas

Ma variable s'affiche vide plus loin dans le plan. Deux causes, dans cet ordre. L'appel n'est pas passé par le module qui la pose, parce qu'il a pris une autre branche. Ou le nom écrit entre accolades ne correspond pas à celui du module, à une lettre près. Un nom inconnu est remplacé par du vide, sans erreur.

J'ai mis un accent ou un tiret dans le nom, et rien ne sort. Seuls les lettres non accentuées, les chiffres et le tiret bas sont reconnus. Renommez la variable, puis corrigez tous les endroits qui l'utilisent.

Ma liste s'affiche sur une seule ligne, séparée par des virgules. C'est le comportement attendu : un Tableau inséré dans un texte est restitué avec des virgules. Un tableau sert à être testé, avec l'opérateur « est dans (tableau) » d'une Condition (Si), plutôt qu'à être affiché.

L'appel se coupe juste après le module. Sa sortie unique n'est reliée à rien. Un module dont la sortie retenue ne mène nulle part termine l'appel.

La valeur est correcte à l'écran mais pas au téléphone. Le plan enregistré n'est pas encore en service. Cliquez sur Appliquer les modifications dans le bandeau du haut, puis rappelez.

Comment le plan d'appel se construit, expliqué en images

Voir la page Plans de numérotation