ForHosting KIT · Áudio e voz

Consulta de frequências DTMF do teclado telefônico

Um tom DTMF representa uma tecla telefônica reproduzindo duas frequências ao mesmo tempo: uma vem de uma linha de baixa frequência e outra de uma coluna de alta frequência.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

Informe qualquer dígito de 0 a 9, asterisco ou cerquilha para receber o par padrão exato em hertz. A consulta é determinística e imediata, ideal para conferir softwares de telefonia, geradores, decodificadores, documentação e dados de teste sem procurar manualmente em uma matriz de teclado.

Como uma tecla se transforma em duas frequências

A sinalização multifrequencial de dois tons, conhecida como DTMF, organiza o teclado telefônico como uma matriz de frequências. Cada linha horizontal tem uma frequência baixa e cada coluna vertical tem uma frequência alta. Ao pressionar uma tecla, as frequências da linha e da coluna são combinadas, criando um par característico para aquela posição. Por exemplo, as teclas 1, 2 e 3 compartilham a mesma frequência baixa da linha, mas usam frequências altas diferentes. Esta consulta retorna os dois componentes separadamente e também como um par ordenado, sempre com a frequência baixa primeiro. Essa estrutura atende tanto quem lê uma especificação quanto o código que configura um oscilador, detector ou teste automatizado. O resultado informa frequências em hertz; ele não sintetiza um arquivo de áudio, estima a duração do tom nem analisa uma gravação. Como a tabela é definida pelo plano conhecido do teclado DTMF, a mesma tecla aceita sempre produz a mesma saída, sem arredondamento, acesso à rede ou cálculo dependente do dispositivo.

Quais caracteres do teclado são aceitos

A entrada deve conter exatamente um caractere de um teclado telefônico comum de 12 teclas: os dígitos de 0 a 9, asterisco ou cerquilha. O caractere é interpretado literalmente; portanto, envie números como texto ao chamar a API. Espaços, palavras, sequências com vários caracteres, sinais negativos e sinais de pontuação diferentes dos dois símbolos do teclado geram um erro de entrada. Algumas especificações técnicas de DTMF também descrevem uma quarta coluna formada pelas teclas de controle A, B, C e D. Elas foram usadas em equipamentos militares e de controle de rede especializados, mas não fazem parte do teclado telefônico padrão atendido por esta capacidade e, por isso, são rejeitadas intencionalmente. Um conjunto restrito evita suposições erradas sobre o layout utilizado. Ao criar um formulário, você pode apresentar as opções declaradas em um seletor. Em uma integração por código, valide ou converta explicitamente a tecla desejada em texto antes do envio, em vez de depender de uma conversão numérica automática.

Como usar o resultado em projetos de telefonia

As frequências baixa e alta retornadas funcionam como dados de referência sempre que um software precisa corresponder a um teclado telefônico. Um gerador de tons pode usar o par para configurar dois osciladores antes de aplicar seus próprios parâmetros de amplitude, taxa de amostragem e duração. Um teste de decodificador pode rotular um par conhecido com a tecla que deve ser reconhecida. Equipes de qualidade podem transformar a resposta em dados de teste estáveis para menus de resposta audível interativa, discadores, softphones, gateways e dispositivos embarcados. A consulta também ajuda a explicar confusões entre teclas vizinhas: as teclas da mesma linha compartilham o componente baixo, enquanto as da mesma coluna compartilham o componente alto. Esta capacidade não avalia diferença de nível, tolerância, cadência, intensidade do sinal nem a conformidade de um áudio gravado com uma norma de telecomunicações; essas questões exigem medições do sinal real. Ela fornece somente a identidade nominal das frequências. Execute no navegador para uma verificação ocasional ou use a API por US$ 0,002 por solicitação quando um fluxo precisar de uma resposta JSON pequena e previsível.

Configurar um gerador de tons DTMF

Obtenha as frequências nominais baixa e alta dos osciladores para a tecla que seu aplicativo precisa emitir.

Criar dados de teste para decodificadores

Monte valores esperados claros que relacionem um caractere do teclado ao seu par padrão de frequências.

Conferir documentação de telefonia

Confirme um par de frequências ao revisar fluxos IVR, discadores, configurações de gateways ou notas técnicas.

Quais caracteres você pode informar?

Informe exatamente um dígito de 0 a 9, asterisco ou cerquilha.

Por que as teclas DTMF A, B, C e D são rejeitadas?

Elas pertencem a uma quarta coluna DTMF especializada e não aparecem no teclado telefônico comum de 12 teclas atendido aqui.

Esta ferramenta gera um tom audível?

Não. Ela retorna o par nominal de frequências como dados; não sintetiza, reproduz nem baixa áudio.

Ela pode analisar uma gravação de tons de teclado?

Não. A análise de áudio exige um decodificador que meça as frequências do sinal. Esta capacidade apenas consulta o par de uma tecla conhecida.

Quanto custa uma solicitação da API?

Cada solicitação da API custa US$ 0,002. A mesma consulta determinística também pode ser executada no seu navegador.

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

POSThttps://api.kit.forhosting.com/audio/dtmf-tone-lookup

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/audio/dtmf-tone-lookup \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key":"5"}'
{
  "key": "5"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "audio.dtmf_tone_lookup",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

max_mb200
max_minutes180
HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →