Tons DTMF

Visão geral

O Dual Tone Multi Frequency (DTMF) é um tipo de sinalização utilizado por sistemas telefônicos para transmitir os dígitos 0-9 e o * e # caracteres. Normalmente, quem liga pressiona essas teclas no teclado do telefone, e o aparelho gera então um tom composto por duas frequências reproduzidas simultaneamente (daí o nome “Dual Tone”).

O DTMF é utilizado tanto para discar um número em um telefone fixo quanto para enviar sinais ao destinatário assim que a chamada é atendida. Normalmente, isso é usado para implementar um sistema de Resposta Interativa de Voz (IVR) ou para inserir informações como um número PIN ou o código de acesso a uma teleconferência. A Voice API da Vonage oferece suporte tanto à coleta de informações dos chamadores usando o input ação em um NCCO, bem como o envio de tons DTMF durante uma chamada.

Coleta de sugestões

Você pode coletar informações do usuário que está ligando usando o input ação dentro do seu NCCO. Você pode coletar um número específico de dígitos, definir um tempo limite ou aguardar até que o usuário pressione o # tecla antes de continuar (consulte o ação de entrada). Assim que a ação for concluída, a Vonage enviará um webhook para o seu event_url contendo as teclas que foram pressionadas. Se você retornar um novo NCCO em resposta a esse evento, a Vonage substituirá o NCCO existente, ignorando quaisquer ações definidas após o input.

Exemplo 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
    }
  }
]

O Guia de Referência da NCCO contém informações sobre todos os parâmetros possíveis que podem ser utilizados em conjunto com o DTMF input Ação da NCCO.

Envio de DTMF

Existem duas maneiras de enviar tons DTMF durante uma chamada:

  1. Para uma chamada efetuada por meio de criar chamada ponto de extremidade ou por meio de um connect ação, você pode definir o dtmfAnswer parâmetro no terminal telefônico. Isso significa que, quando a chamada for atendida, a Vonage enviará automaticamente a sequência de tons definida.

  2. Você também pode enviar dígitos DTMF para uma chamada a qualquer momento, enviando uma solicitação PUT para o API REST, especificando uma sequência de digits.

Você pode usar algarismos 0-9, *, e #. A p indica uma pausa de 500 ms, caso seja necessário adicionar um atraso no envio dos dígitos.

Solução de problemas

O DTMF pode ser transmitido por redes telefônicas digitais de várias maneiras, conhecidas como “na banda” e “fora da banda”; na modalidade “na banda”, os tons são reproduzidos no canal de áudio da chamada e serão ouvidos pelas partes envolvidas na chamada. Na sinalização fora de banda, os tons são enviados por um canal de sinalização separado e podem não ser ouvidos pela pessoa que está do outro lado da linha. Isso significa que, se você estiver testando o envio de DTMF ligando para o seu próprio telefone, talvez não ouça os tons no fone de ouvido.

O DTMF também pode apresentar problemas específicos relacionados às operadoras locais. Caso tenha dificuldades ao usar o DTMF, entre em contato com apoio com detalhes sobre o seu problema.