Tonalités DTMF

Vue d'ensemble

La multifréquence à deux tons (DTMF) est une forme de signalisation utilisée par les systèmes téléphoniques pour transmettre les chiffres. 0-9 et le * et # caractères. En général, l'appelant appuie sur ces touches du clavier de son téléphone, qui émet alors une tonalité composée de deux fréquences jouées simultanément (d'où le terme de double tonalité).

Le DTMF est utilisé à la fois pour composer une destination sur un téléphone fixe et pour envoyer un signal à l'extrémité distante une fois que l'appel a été pris. Il est généralement utilisé pour mettre en œuvre un système de réponse vocale interactive (IVR) ou pour saisir des informations telles qu'un code PIN ou un code d'appel de conférence. L'API Voice de Vonage prend en charge la collecte d'informations auprès des appelants à l'aide de la fonction input dans un NCCO ainsi que l'envoi de tonalités DTMF au cours d'un appel.

Collecte des données

Vous pouvez recueillir des informations auprès de votre interlocuteur en utilisant la fonction input au sein de votre BCN. Vous pouvez collecter un nombre spécifique de chiffres, définir un délai d'attente ou attendre que l'utilisateur ait appuyé sur la touche # avant de continuer (voir le action d'entrée). Une fois l'action terminée, Vonage enverra un webhook à votre site Web. event_url contenant les touches qui ont été pressées. Si vous renvoyez un nouveau NCCO en réponse à cet événement, Vonage remplacera le NCCO existant, en ignorant toutes les actions définies après l'élément input.

Exemple de NCCO

[
  {
    "action": "talk",
    "text": "Please enter a digit",
    "bargeIn": true
  },
  {
    "eventUrl": [
      "https://api.example.com/callbacks/events"
    ],
    "action": "input",
    "type": [ "dtmf" ],
    "dtmf": {
      "maxDigits": 1,
      "submitOnHash": true,
      "timeOut": 5
    }
  }
]

Les Guide de référence du NCCO contient des informations sur tous les paramètres possibles qui peuvent être utilisés en conjonction avec le DTMF input Action du NCCO.

Envoi de DTMF

Il existe deux façons d'envoyer des tonalités DTMF lors d'un appel :

  1. Pour un appel sortant effectué soit par créer un appel ou par l'intermédiaire d'un connect vous pouvez définir l'action dtmfAnswer dans le point de terminaison du téléphone. Cela signifie que lorsque l'appel est pris, Vonage enverra automatiquement la chaîne de tonalités définie.

  2. Vous pouvez également envoyer des chiffres DTMF à un appel à tout moment en envoyant une requête PUT à l'adresse suivante API RESTen spécifiant une chaîne de digits.

Vous pouvez utiliser des chiffres 0-9, *et #. A p indique une pause de 500ms si vous souhaitez ajouter un délai dans l'envoi des chiffres.

Dépannage

Le DTMF peut être envoyé sur les réseaux téléphoniques numériques de plusieurs manières, appelées In-Band et Out-of-Band, avec In-Band les tonalités sont jouées dans le canal audio de l'appel et seront entendues par les parties à l'appel. Avec la signalisation hors bande, les tonalités sont envoyées dans un canal de signalisation séparé et peuvent ne pas être entendues par un appelant qui écoute à l'autre bout du fil. Cela signifie que si vous testez l'envoi de DTMF en appelant votre propre téléphone, il se peut que vous n'entendiez pas les tonalités dans votre écouteur.

La fonction DTMF peut également poser des problèmes spécifiques aux opérateurs locaux. Si vous rencontrez des difficultés dans l'utilisation de la DTMF, veuillez contacter soutien avec les détails de votre problème.