É possível ativar e configurar o DTMF (sinalização multifrequência de dois tons)
para integrações de telefonia. Quando ativada, 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 a pressionamentos de tecla 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:
- Corresponde a uma intent.
- Corresponde a uma entidade personalizada.
- Corresponder a um tipo de entidade do sistema
É possível associar padrões de DTMF a intents e entidades individuais para acionar uma correspondência com sequências de entrada do usuário final. Quando você ativa o 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.
| Nome do tipo | 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 representada 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 de DTMF,
sem aguardar mais entradas. É comum usar # nesta configuração.
O dígito final não é incluído na entrada convertida do usuário final. Por exemplo, se o dígito final 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 for maior que o tempo limite entre dígitos, o Dialogflow vai interromper o processamento de DTMF da sequência.
Se o Dialogflow interromper 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 vai invocar um evento sem correspondência.
Ao usar o console, esse campo é em segundos.
Tempo limite de endpointing
Depois que uma correspondência para uma sequência de pressionamentos de tecla é feita, o Dialogflow continua processando os pressionamentos de tecla. A duração do tempo limite de endpoint é o período que o Dialogflow aguarda mais entradas depois de uma correspondência antes de encerrar a detecção. Esse comportamento processa 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 em duração do tempo limite de finalização, o Dialogflow vai interromper o processamento de DTMF e converter a sequência correspondente atual como faria normalmente.
Ativar DTMF
É possível ativar o 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 o DTMF para um agente como exemplo. Também é possível ativar o DTMF usando Configurações da página (páginas), 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.
Acesse Configurações do agente e selecione a guia Fala e URA.
Role até a parte de baixo da página e clique na caixa de seleção Ativar DTMF.
Defina os valores para Dígito de fim, Duração do tempo limite entre dígitos e Duração do tempo limite de ponto final. O DTMF agora está ativado para tudo no escopo desse agente. Se definidas em um nível inferior, essas configurações vão substituir as de nível superior. Qualquer intent ou tipo de entidade ativos dos slots ativos nesse escopo pode ser acionado se tiver padrões DTMF definidos.
Adicionar um padrão DTMF a uma intent
No menu de navegação à esquerda, selecione a guia Gerenciar e clique em Intenções.
Selecione uma intenção na lista que aparece e acesse a caixa Padrão DTMF.
Insira uma sequência DTMF. Você pode usar padrões de regex em casos de padrões DTMF mais complexos.
Clique em Salvar.
Adicionar um padrão DTMF a uma entidade
No menu de navegação à esquerda, selecione a guia Gerenciar e clique em Tipos de entidade.
Selecione um tipo de entidade na lista que aparece. Acesse a coluna Padrão DTMF na tabela Entidades.
Defina um padrão de DTMF para cada entidade na tabela. Você pode usar padrões de regex em casos de padrões DTMF mais complexos.
Clique em Salvar.
Usar DTMF no simulador
É possível testar a configuração de DTMF no simulador do console.
No console do Dialogflow, clique em Testar agente no canto superior direito da tela.
No painel que aparece, clique no símbolo + ao lado da caixa de entrada de texto Falar com um agente. Selecione DTMF.
Insira o padrão de DTMF que você quer testar e o dígito de fim do DTMF. Verifique se a caixa Enviar nova entrada DTMF está marcada e clique em Enviar. A resposta à entrada de DTMF vai aparecer no simulador.