Aperçu
Les contrôles DTMF (Dual-Tone Multi-Frequency) permettent à vos agents IA d’envoyer et de capturer des tonalités de clavier téléphonique pendant les conversations. Cela permet aux agents de naviguer dans les systèmes IVR, d’interagir avec les systèmes téléphoniques existants et de collecter des saisies structurées des appelants via les touches du clavier - transformant votre agent d’un système vocal uniquement en un système d’automatisation téléphonique complet. Les capacités DTMF sont essentielles pour intégrer les agents IA avec l’infrastructure téléphonique commerciale existante, permettant des transferts transparents à travers des menus IVR complexes et la collecte de saisies numériques précises comme les numéros de compte, codes PIN ou sélections de menu.Qu’est-ce que le DTMF ?
Comprendre la technologie DTMF
Le DTMF est le signal généré lorsque vous appuyez sur des touches d’un clavier téléphonique. Chaque touche produit deux tonalités simultanées à différentes fréquences - une haute et une basse - créant un son unique que les systèmes peuvent décoder pour identifier quelle touche a été pressée. Touches disponibles :- Chiffres : 0-9 (saisie numérique)
- Étoile : * (souvent utilisé comme “retour” ou “annuler”)
- Dièse/Hash : # (souvent utilisé comme “confirmer” ou “entrée”)
- Naviguer dans les menus IVR (“Appuyez sur 1 pour les ventes, 2 pour le support”)
- Entrer des numéros de compte ou des codes PIN
- Confirmer ou annuler des actions
Capacités DTMF
Deux fonctions principales
Envoi de tonalités
Capture de tonalités
Cas d’usage de l’envoi de tonalités
Navigation IVR
Navigation IVR
Authentification
Authentification
Intégration système
Intégration système
Cas d’usage de la capture de tonalités
Sélection de menu
Sélection de menu
Collecte d'informations
Collecte d'informations
Saisie clavier
Saisie clavier
Configuration des contrôles DTMF
Accès aux paramètres DTMF
Accéder à la configuration DTMF
Configurer les paramètres


Bouton DTMF global
Activer le DTMF pendant les appels Permettre à l’agent d’envoyer des tonalités de clavier et de collecter des chiffres des appelants. Quand activer :- L’agent doit naviguer dans les systèmes IVR
- L’agent doit collecter des saisies numériques structurées
- L’intégration nécessite une interaction DTMF
Configuration de l’envoi de tonalités
Envoi de tonalités
Configurez votre agent pour envoyer des tonalités DTMF aux systèmes externes. Bouton : Permettre à l’agent d’envoyer des tonalités de clavier Paramètres :- Délai entre les tonalités (secondes) : 3 secondes (par défaut)
- Durée de la tonalité (ms) : 120 ms (par défaut)
- Écart entre les tonalités (ms) : 70 ms (par défaut)
Paramètres d’envoi de tonalités
Délai entre les tonalités (secondes)
Délai entre les tonalités (secondes)
- Augmenter (4-5s) : Systèmes IVR lents/anciens manquant des tonalités
- Diminuer (1-2s) : Systèmes modernes rapides, réduire le temps de navigation total
Durée de la tonalité (ms)
Durée de la tonalité (ms)
- Augmenter (150-200ms) : Systèmes IVR ne détectant pas les tonalités de manière fiable
- Diminuer (80-100ms) : Accélérer les interactions, réduire la latence
Écart entre les tonalités (ms)
Écart entre les tonalités (ms)
- Augmenter (100-150ms) : IVR traitant les tonalités rapides comme une seule saisie
- Diminuer (40-50ms) : Accélérer les séquences de plusieurs chiffres
Paramètres recommandés par cas d’usage
IVR modernes rapides
IVR modernes rapides
- Délai : 1-2 secondes
- Durée de tonalité : 100ms
- Écart entre les tonalités : 50ms
IVR standards (par défaut)
IVR standards (par défaut)
- Délai : 3 secondes (par défaut)
- Durée de tonalité : 120ms (par défaut)
- Écart entre les tonalités : 70ms (par défaut)
IVR lents/problématiques
IVR lents/problématiques
- Délai : 4-5 secondes
- Durée de tonalité : 150ms
- Écart entre les tonalités : 100ms
Configuration de la capture de tonalités
Modes de capture
Choisissez comment votre agent reçoit et interprète les saisies DTMF des appelants.Menu (touche unique)
Collecteur (multi-chiffres)
Mode Menu
Pour les sélections de menu de type IVR Le mode Menu capture une pression de touche unique et l’envoie immédiatement à l’agent.

- L’agent propose des options de menu
- Le client appuie sur une touche unique (0-9, *, #)
- L’agent reçoit le chiffre immédiatement
- L’agent répond en fonction de la touche pressée
- Capture la pression d’une touche unique
- Traite immédiatement
- Aucune touche de terminaison requise
- Touche d’effacement non disponible
Mode Collecteur
Pour collecter des séquences comme les numéros de compte, codes PIN, numéros de téléphone Le mode Collecteur met en mémoire tampon plusieurs chiffres jusqu’à ce que l’utilisateur appuie sur la touche de terminaison ou que le délai expire.

- L’agent demande une saisie multi-chiffres
- Le client entre plusieurs chiffres
- Appuie sur la touche de terminaison (généralement #) lorsque terminé
- L’agent reçoit la chaîne de chiffres complète
- Chiffres minimum : 1 (par défaut)
- Chiffres maximum : 25 (par défaut)
- Délai (ms) : 6000ms (6 secondes, par défaut)
- Touche de terminaison : # (Dièse)
- Touche d’effacement : * (Étoile)
Paramètres du mode Collecteur
Chiffres minimum
Chiffres minimum
- Numéro de compte (10 chiffres) : Définir à 10
- Code PIN (4 chiffres) : Définir à 4
- Saisie flexible : Définir à 1 (toute longueur acceptée)
- Si le client appuie sur # avant d’atteindre le minimum → Erreur, invite à ressaisir
- Si le client atteint le minimum → Peut appuyer sur # pour soumettre tôt
Chiffres maximum
Chiffres maximum
- Numéro de téléphone : Définir à 10 (format US)
- Numéro de compte : Définir à la longueur attendue
- Longueur variable : Définir plus haut que le maximum attendu
- Lorsque le nombre maximum de chiffres est entré → Soumet automatiquement sans nécessiter #
- Les tonalités après le max sont ignorées
Délai (ms)
Délai (ms)
- Le compteur démarre après chaque pression de chiffre
- Se réinitialise avec chaque nouveau chiffre
- Si le délai est atteint → Traiter comme complet ou inviter à continuer
- Saisie rapide (PIN) : 3000-4000ms (3-4 secondes)
- Saisie longue (numéro de compte) : 6000-8000ms (6-8 secondes)
- Système patient : 10000ms+ (10+ secondes)
Touche de terminaison
Touche de terminaison
Touche d'effacement
Touche d'effacement
Paramètres collecteur recommandés par cas d’usage
Collecte de numéro de compte (10 chiffres)
Collecte de numéro de compte (10 chiffres)
- Chiffres minimum : 10
- Chiffres maximum : 10
- Touche de terminaison : # (optionnel, auto-soumet à 10)
- Délai : 6000ms (6 secondes)
- Touche d’effacement : *
Collecte de code PIN (4-6 chiffres)
Collecte de code PIN (4-6 chiffres)
- Chiffres minimum : 4
- Chiffres maximum : 6
- Touche de terminaison : #
- Délai : 4000ms (4 secondes)
- Touche d’effacement : *
Numéro de téléphone (format variable)
Numéro de téléphone (format variable)
- Chiffres minimum : 7
- Chiffres maximum : 15
- Touche de terminaison : #
- Délai : 6000ms (6 secondes)
- Touche d’effacement : *
Saisie numérique flexible (par défaut)
Saisie numérique flexible (par défaut)
- Chiffres minimum : 1 (par défaut)
- Chiffres maximum : 25 (par défaut)
- Touche de terminaison : #
- Délai : 6000ms (6 secondes, par défaut)
- Touche d’effacement : *
Utilisation du DTMF dans les instructions
Inviter à la saisie DTMF
Exemple de sélection de menu :Gestion des réponses DTMF
Traitement automatique : Lorsque la capture DTMF est activée, l’agent reçoit automatiquement les chiffres collectés et peut y répondre. Aucune configuration supplémentaire nécessaire. Avancé : Utilisation de l’outil wait_for_dtmf_input Pour un contrôle explicite dans vos instructions d’agent, vous pouvez appeler l’outilwait_for_dtmf_input. Il retourne :
Retour à la voix
Offrir une alternative vocale :Test de la configuration DTMF
Plan de test
Tester l'envoi de tonalités (Navigation IVR)
- Configurez l’agent avec une action de transfert vers un numéro de téléphone avec IVR
- Ajoutez des instructions pour naviguer dans l’IVR en utilisant les tonalités DTMF
- Démarrez l’appel test
- Déclenchez l’action de transfert
- Surveillez l’agent naviguant dans l’IVR (vérifiez les journaux pour les tonalités envoyées)
- Vérifiez que l’agent atteint la destination correcte
- Tonalités envoyées aux intervalles corrects
- L’IVR reconnaît toutes les tonalités
- La navigation se termine avec succès
- Aucune tonalité perdue ou mal interprétée
Tester le mode Menu (Capture de touche unique)
- Configurez le DTMF en mode Menu
- Ajoutez des options de menu aux instructions
- Démarrez l’appel test
- Écoutez les options de menu
- Appuyez sur une touche unique (1, 2, 3, etc.)
- Vérifiez que l’agent reconnaît et répond de manière appropriée
| Touche | Action attendue |
|---|---|
| 1 | Acheminer vers l’option 1 |
| 2 | Acheminer vers l’option 2 |
| 9 | Acheminer vers l’option 9 |
| * | Gérer la touche étoile |
| # | Gérer la touche dièse |
| Invalide | Gestion d’erreur |
Tester le mode Collecteur (Multi-chiffres)
- Configurez le DTMF en mode Collecteur
- Définissez les chiffres min/max appropriés, touche de terminaison
- Démarrez l’appel test
- Invitez l’agent à collecter des chiffres
- Entrez diverses séquences de chiffres :
- Exactement le minimum de chiffres + #
- Entre min et max chiffres + #
- Exactement le maximum de chiffres (auto-soumission)
- Utilisez la touche d’effacement (*) pour corriger les erreurs
- Laissez la saisie expirer
- Vérifiez que l’agent reçoit la bonne chaîne de chiffres
- L’application du minimum de chiffres fonctionne
- L’auto-soumission du maximum de chiffres fonctionne
- La touche de terminaison finalise correctement la saisie
- La touche d’effacement supprime correctement le dernier chiffre
- La gestion du délai est appropriée
Tester les cas limites
- Appuyer sur # immédiatement (sans chiffres)
- Devrait rejeter si min > 0
- Entrer des chiffres partiels, attendre le délai
- Vérifier la gestion appropriée
- Entrer des chiffres très rapidement
- Vérifier que tous sont capturés correctement
- Appuyer sur * sur un tampon vide (devrait ignorer)
- Appuyer sur * plusieurs fois (supprime plusieurs chiffres)
- Entrer des chiffres, tout effacer, entrer une nouvelle séquence
- Appuyer sur des touches en mauvais mode (ex : # en mode Menu)
- Maintenir une touche trop longtemps
- Appuyer sur plusieurs touches simultanément
Tester l'intégration avec les instructions
- L’agent invite correctement à la saisie DTMF
- L’agent attend la saisie (ne continue pas à parler)
- L’agent confirme la réception de la saisie
- L’agent traite correctement la valeur capturée
- L’agent gère les saisies invalides avec élégance
- L’agent offre un retour vocal lorsque approprié
Problèmes de test courants
Tonalités non détectées
Tonalités non détectées
- Support DTMF pas activé globalement
- Durée de tonalité trop courte pour la détection
- Problèmes de réseau/codec dégradant les tonalités
- Instructions ne gérant pas la variable DTMF
- Vérifier que le bouton Support DTMF est SUR
- Augmenter la durée de tonalité à 150-200ms
- Tester depuis un autre téléphone/réseau
- Vérifier les journaux pour confirmer que l’outil
wait_for_dtmf_inputest enregistré et invoqué - Vérifier que
session.userdata.last_dtmf_inputest rempli dans les journaux worker
Mauvais chiffres capturés
Mauvais chiffres capturés
- Écart entre tonalités trop court (tonalités se mélangeant)
- Bruit de fond créant de fausses tonalités
- Client appuyant sur les touches trop rapidement
- Augmenter l’écart entre tonalités à 100-150ms
- Tester dans un environnement calme
- Augmenter le délai pour ralentir la saisie du client
- Ajouter validation et confirmation dans les instructions
Échec de la navigation IVR
Échec de la navigation IVR
Touche d'effacement ne fonctionne pas
Touche d'effacement ne fonctionne pas
- Touche d’effacement pas configurée correctement
- Touche d’effacement pressée en mode Menu (non applicable)
- * assigné comme touche de terminaison (conflit)
- Vérifier que la touche d’effacement est définie à * en mode Collecteur
- S’assurer que le mode est Collecteur (la touche d’effacement ne fonctionne qu’en mode Collecteur)
- Ne pas utiliser * à la fois comme touche d’effacement et de terminaison
Bonnes pratiques
Toujours offrir un retour vocal
Toujours offrir un retour vocal
- Téléphones mobiles dans des zones à mauvais signal
- Applications VoIP sans clavier
- Besoins d’accessibilité
- Préférence pour l’interaction vocale
Confirmer la saisie reçue
Confirmer la saisie reçue
Instructions claires pour les invites DTMF
Instructions claires pour les invites DTMF
- Quoi entrer (numéro de compte, PIN, sélection)
- Combien de chiffres (si longueur fixe)
- Touche de terminaison (si applicable)
- Méthode alternative (voix)
Commencer avec un timing conservateur
Commencer avec un timing conservateur
- Commencer avec les valeurs par défaut recommandées
- Déployer sur un petit groupe de test
- Surveiller les erreurs DTMF dans les journaux
- Ajuster le timing en fonction des échecs réels
- Déployer les paramètres optimisés
- Définir un timing très rapide sans tester
- Supposer que tous les IVR se comportent de la même manière
- Optimiser pour la vitesse au détriment de la fiabilité
Gérer les nouvelles tentatives avec élégance
Gérer les nouvelles tentatives avec élégance
- Abandonner après un seul échec
- Répéter exactement les mêmes instructions (pas utile)
- Rester bloqué dans une boucle de nouvelle tentative infinie