Saisie DTMF
Lit les touches composées par l'appelant et range le résultat dans une variable : un code client, un numéro de dossier, une référence à vérifier ensuite.
En bref
| Sorties | une seule, empruntée que l'appelant ait composé ou non |
| Champs | Variable (résultat), Message (optionnel), Nombre de chiffres, Timeout (s) |
| Nombre de chiffres | de 1 à 20, 1 par défaut |
| Timeout | 3, 5, 10, 15, 20 ou 30 secondes, 5 par défaut |
| Effet sur l'appel | le module décroche l'appel s'il ne l'était pas encore |
Le texte d'aide affiché dans la fenêtre est : « Lit les touches DTMF de l'appelant et stocke la valeur saisie dans une variable (utilisable via {{nom}}). »
Comment ça marche
DTMF est le nom technique des tonalités qu'émet un clavier téléphonique. Le module écoute ces tonalités, assemble les chiffres composés et les range dans une variable que vous nommez.
Il joue d'abord l'annonce que vous avez choisie. L'appelant peut composer pendant l'annonce : elle s'arrête au premier chiffre. La saisie se termine quand le nombre de chiffres attendu est atteint, ou quand le délai s'écoule.
Puis, dans tous les cas, l'appel poursuit par la sortie unique du module. Une saisie absente n'est pas une erreur : elle donne une variable vide, qu'il vous appartient de tester plus loin, avec une Condition (Si) ou un Switch / Case.
Ce qu'il faut saisir
| Champ | Ce qui est attendu | Si vous le laissez vide |
|---|---|---|
| Variable (résultat) | le nom sous lequel ranger la saisie, en lettres non accentuées, chiffres et tiret bas | la saisie est lue mais n'est rangée nulle part, et le module ne sert à rien |
| Message (optionnel) | l'annonce qui invite à composer, choisie parmi vos sons ; une entrée en tête de liste permet de n'en jouer aucune | une seconde de silence, puis l'attente, sans un mot pour l'appelant |
| Nombre de chiffres | de 1 à 20 | 1 |
| Timeout (s) | 3, 5, 10, 15, 20 ou 30 secondes | 5 |
La marche à suivre
- Posez le module Saisie DTMF et reliez le nœud précédent à son entrée.
- Ouvrez-le et nommez la Variable (résultat), par exemple
dossier. - Choisissez le Message (optionnel) parmi vos annonces. Elle doit dire à l'appelant quoi composer et combien de chiffres.
- Réglez le Nombre de chiffres sur la longueur réelle de ce que vous attendez.
- Réglez le Timeout (s). Cinq secondes suffisent pour un code court, davantage pour une référence longue à chercher sur un document.
- Cliquez sur Sauver, puis reliez la sortie unique à la suite du plan.
- Posez un module Débogage juste après, avec pour message
dossier={{dossier}}, pour lire ce qui a réellement été composé. - Traitez la saisie vide : une Condition (Si) avec l'opérateur « est vide » sur
{{dossier}}vous permet de rejouer l'annonce ou de basculer vers un humain. - Cliquez sur Sauver, puis sur Appliquer les modifications dans le bandeau du haut.
- Appelez votre numéro, composez un code, puis ouvrez le Journal de débogage du plan et comparez la valeur écrite à ce que vous avez tapé.
Si ça ne marche pas
La variable est vide alors que l'appelant a composé quelque chose. Vérifiez d'abord que le champ Variable (résultat) porte bien un nom, et que ce nom est écrit à l'identique entre accolades plus loin. Vérifiez ensuite le délai : trop court, il expire avant que l'appelant ait fini de composer.
Un code composé uniquement de zéros n'est jamais enregistré. C'est une limite connue du module : une saisie qui ne contient que des zéros ne se distingue pas d'une absence de saisie, et la variable reste vide. Un zéro en tête d'un code plus long, lui, est bien conservé. Évitez les codes entièrement composés de zéros.
L'appelant n'entend rien et ne sait pas quoi faire. Aucun Message (optionnel) n'est choisi : le module attend après une seconde de silence. Choisissez une annonce, et énoncez-y le nombre de chiffres attendu.
La saisie traîne alors que j'ai indiqué six chiffres. L'appelant en a composé moins. Le module attend alors tout le délai avant de continuer. Réduisez le Timeout (s), ou annoncez plus clairement la longueur attendue.
L'appel se coupe après la saisie. La sortie unique n'est reliée à rien. Un module dont la sortie retenue ne mène nulle part termine l'appel, même quand la saisie s'est bien passée.
Comment le plan d'appel se construit, expliqué en images
Voir la page Plans de numérotation