Tonos DTMF

Visión general

Dual Tone Multi Frequency (DTMF), es una forma de señalización utilizada por los sistemas telefónicos para transmitir los dígitos 0-9 y el * y # caracteres. Normalmente, la persona que llama pulsa estos botones en el teclado del teléfono y éste genera un tono compuesto por dos frecuencias que se reproducen simultáneamente (de ahí lo de Dual Tone).

El DTMF se utiliza tanto para marcar un destino en un teléfono fijo como para señalar al extremo remoto una vez contestada la llamada. Por lo general, se utiliza para implementar un sistema de respuesta de voz interactiva (IVR) o para ingresar información como un número PIN o un pin de llamada en conferencia. Voice API de Vonage admite tanto la recopilación de información de las personas que llaman mediante la función input en una OCN, así como el envío de tonos DTMF dentro de una llamada.

Recopilación de datos

Puede obtener información de la persona que llama utilizando la función input dentro de su OCN. Puede recopilar un número específico de dígitos, establecer un valor de tiempo de espera o esperar hasta que el usuario haya pulsado la tecla # antes de continuar (véase la acción de entrada). Una vez completada la acción, Vonage enviará un webhook a tu event_url que contiene las teclas que se presionaron. Si devuelve una nueva OCNC en respuesta a este evento, Vonage reemplazará la OCNC existente, ignorando cualquier acción definida después del evento input.

Ejemplo de OCN

[
  {
    "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
    }
  }
]

En Guía de referencia de las OCNN contiene información sobre todos los parámetros posibles que pueden utilizarse junto con el DTMF input Acción de la OCNC.

Envío DTMF

Hay dos formas de enviar tonos DTMF a una llamada:

1. Para una llamada saliente realizada a través de crear llamada o a través de un connect puede establecer la acción dtmfAnswer dentro del punto final del teléfono. Esto significa que cuando se responda la llamada, Vonage enviará automáticamente la cadena de tonos definida.

2. También puede enviar dígitos DTMF a una llamada en cualquier momento realizando una solicitud PUT a la aplicación API RESTespecificando una cadena de digits.

Puede utilizar dígitos 0-9, *y #. A p indica una pausa de 500ms si necesitas añadir un retardo en el envío de los dígitos.

Solución de problemas

DTMF puede enviarse a través de redes telefónicas digitales de varias maneras, conocidas como en banda y fuera de banda. Con la señalización en banda, los tonos se reproducen en el canal de audio de la llamada y serán oídos por los interlocutores. Con la señalización fuera de banda, los tonos se envían en un canal de señalización separado y puede que no los oiga la persona que llama desde el otro extremo. Esto significa que si está probando el envío de DTMF llamando a su propio teléfono, es posible que no oiga los tonos en su auricular.

DTMF también puede presentar problemas específicos de las operadoras locales. Si tiene dificultades para utilizar DTMF, póngase en contacto con soporte con los detalles de su problema.