DTMF para integrações de telefonia

É possível ativar e configurar a DTMF (sinalização de multifrequência de tons duplos) para integrações de telefonia. Quando ativadas, as teclas pressionadas pelo usuário final são convertidas em texto normal e processadas como entrada do usuário final pelo agente. Essa conversão pode ser tão simples quanto os caracteres associados às teclas do telefone (12*34#) ou você pode usar expressões regulares (Regex) para sequências mais complicadas.

Regras de correspondência

As configurações de DTMF têm três regras de correspondência diferentes:

É possível associar padrões DTMF a intents e entidades individuais para acionar uma correspondência com sequências de entrada do usuário final. Quando você ativa a DTMF globalmente, as entidades do sistema são ativadas por padrão.

Regra de entidade do sistema

As regras de entidade do sistema são ativadas por padrão quando você ativa o DTMF.

Digite um nome Padrão DTMF Exemplo
sys.percentage Qualquer número inteiro 29 -> 29%
sys.temperature Qualquer número inteiro 30 -> 30C ou 30F
sys.phone-number Qualquer sequência de dígitos. 4081111111
sys.date (dependendo da localidade) AAAAMMDD (en-us) ou MMDDAAAA 20231001 -> 2023-10-01, 10-01-2023 -> 10-01-2023
sys.zip-code Qualquer sequência de dígitos. 94043
sys.number sequência de dígitos com ponto representado pela tecla "*" 123 -> 123, 123*45 -> 123.45
sys.cardinal Qualquer sequência de dígitos. 12345
sys.number-integer Qualquer sequência de dígitos. 12345
sys.number-sequence Qualquer sequência de dígitos. 12345
sys.ordinal Qualquer sequência de dígitos. 12345

Configurações

Nesta seção, descrevemos as configurações adicionais que podem ser definidas ao ativar o DTMF.

Dígito final

Essa configuração controla a tecla que encerra imediatamente a entrada DTMF, sem esperar por mais entradas. É comum usar # para essa configuração. O dígito de finalização não é incluído na entrada convertida do usuário final. Por exemplo, se o dígito de término for # e a entrada for 123#, a entrada convertida do usuário final fornecida ao processamento do agente será 123.

Desativar a detecção de fala

Com essa configuração ativada, o agente ignora as entradas de fala e usa o modo de entrada somente DTMF.

Duração do tempo limite entre dígitos

Um usuário final pode pausar ao inserir uma sequência de pressionamentos de teclas. Se essa duração de pausa for maior que a duração do tempo limite entre dígitos, o Dialogflow vai interromper o processamento de DTMF para a sequência.

Se o Dialogflow cancelar o processamento de DTMF, ele vai fornecer a sequência não convertida capturada até esse ponto ao agente como entrada do usuário final. É improvável que essa entrada corresponda a qualquer intent ou parâmetro de formulário. Portanto, o Dialogflow provavelmente invocará um evento sem correspondência.

Ao usar o console, esse campo é em segundos.

Duração do tempo limite do endpointing

Depois que uma correspondência para uma sequência de pressionamento de tecla é feita, o Dialogflow continua a processar pressionamentos de tecla. A duração do tempo limite de endpointing é o tempo que o Dialogflow vai esperar por mais entradas após uma correspondência antes de encerrar a detecção. Esse comportamento lida com cenários em que a sequência tem um comprimento variável, como números ilimitados.

Se o usuário final pausar a entrada por mais tempo do que o definido na duração do tempo limite de endpoint, o Dialogflow vai cancelar o processamento de DTMF e converter a sequência correspondente atual como faria normalmente.

Ativar DTMF

É possível ativar a DTMF no nível do agente, da página ou do parâmetro. O DTMF será aplicado a tudo dentro desse escopo. Esta seção descreve como ativar a DTMF para um agente como exemplo. Também é possível ativar o DTMF usando as Configurações da página (páginas), as Configurações do fluxo (fluxos) ou selecionando um parâmetro e acessando o menu de configurações. Em todos os casos, as configurações de DTMF estão na parte de baixo da página.

  1. Acesse Configurações do agente e selecione a guia Fala e URA.

  2. Vá até a parte de baixo da página e marque a caixa de seleção Ativar DTMF.

  3. Defina os valores para Dígito de término, Duração do tempo limite entre dígitos e Duração do tempo limite de endpoint. A DTMF agora está ativada para tudo no escopo desse agente. Se definidas em um nível inferior, essas configurações agora substituem as configurações de nível superior. Todas as intents ou tipos de entidade ativos dos slots ativos nesse escopo poderão ser acionados se tiverem padrões de DTMF definidos.

Adicionar um padrão DTMF a uma intent

  1. No menu de navegação à esquerda, selecione a guia Gerenciar e clique em Intents.

  2. Selecione uma intent na lista que aparece e acesse a caixa Padrão de DTMF.

  3. Insira uma sequência DTMF. É possível usar padrões de regex em casos de padrões de DTMF mais complexos.

  4. Clique em Salvar.

Adicionar um padrão DTMF a uma entidade

  1. No menu de navegação à esquerda, selecione a guia Gerenciar e clique em Tipos de entidade.

  2. Selecione um tipo de entidade na lista que aparece. Acesse a coluna Padrão DTMF na tabela Entidades.

  3. Defina um padrão de DTMF para cada entidade na tabela. É possível usar padrões de regex em casos de padrões de DTMF mais complexos.

  4. Clique em Salvar.

Usar DTMF no simulador

É possível testar a configuração de DTMF no simulador do console.

  1. No console do Dialogflow, clique em Testar agente no canto superior direito da tela.

  2. No painel que aparece, clique no símbolo + ao lado da caixa de entrada de texto Falar com o agente. Selecione DTMF.

  3. Insira o padrão de DTMF que você quer testar e o dígito de finalização de DTMF. Verifique se a caixa Enviar nova entrada DTMF está marcada e clique em Enviar. A resposta à entrada DTMF vai aparecer no simulador.