É possível ativar e configurar a sinalização de multifrequência de dois tons (DTMF, na sigla em inglês)
para integrações
de telefonia. Quando essa opção está ativada, os pressionamentos de tecla do telefone do usuário final são convertidos em texto normal e processados pelo agente como entrada do usuário final. Essa conversão pode ser tão simples quanto os caracteres
associados a pressionamentos de tecla de telefone (12*34#
) ou usar
expressões regulares (Regex) para
sequências mais complicadas.
Regras correspondentes
As configurações do DTMF têm três regras de correspondência diferentes:
- Corresponder a uma intent.
- Corresponder 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 MMDDAAYY | 20231001 -> 01-10-2023, 01-10-2023 -> 01-10-2023 |
sys.zip-code |
qualquer sequência de dígitos | 94043 |
sys.number |
Sequência de dígitos com ponto representado pela chave "*" | 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
Esta seção descreve as outras configurações que podem ser definidas ao ativar o DTMF.
Dígito final
Essa configuração controla o pressionamento de tecla que encerra imediatamente a entrada do DTMF,
sem aguardar mais entradas. É comum usar #
para essa 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 do usuário final convertida fornecida para o processamento do agente será 123
.
Duração do tempo limite com vários dígitos
Um usuário final pode pausar enquanto insere uma sequência de pressionamentos de tecla. Se essa duração da pausa for maior que a duração do tempo limite entre dígitos, o Dialogflow cancelará o processamento de DTMF da sequência.
Se o Dialogflow cancelar o processamento do DTMF, ele fornecerá ao agente a sequência não convertida capturada até esse ponto como entrada do usuário final. É improvável que essa entrada corresponda a nenhum parâmetro de intent ou formulário. Por isso, o Dialogflow provavelmente invocará um evento sem correspondência.
Ao usar o console, este campo aparece em segundos.
Duração do tempo limite do endpoint
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 do endpoint é o tempo que o Dialogflow aguardará por mais entradas após uma correspondência ser feita antes de finalizar a detecção. Esse comportamento processa cenários em que a sequência tem um tamanho variável, como números ilimitados.
Se o usuário final pausar a entrada por mais tempo que o definido na duração do tempo limite do endpoint, o Dialogflow cancelará o processamento do DTMF e converterá a sequência atualmente correspondente, como faria normalmente.
Ativar DTMF
O DTMF pode ser ativado no nível de agente, página ou parâmetro. O DTMF será aplicado a tudo dentro desse escopo. Nesta seção, descrevemos a ativação do DTMF para um agente como exemplo. Também é possível ativar o DTMF usando as Configurações de página (páginas), Configurações de fluxo (fluxos) ou selecionando um parâmetro e visualizando o menu de configurações. Em todos os casos, as configurações do DTMF estão na parte inferior da página.
Acesse Configurações do agente e selecione a guia Voz e URA.
Vá até a parte inferior da página e clique na caixa de seleção Ativar DTMF.
Defina os valores de Concluir dígito, Duração do tempo limite entre dígitos e Duração do tempo limite de vinculação. O DTMF agora está ativado para tudo no escopo do agente. Se definidas em um nível inferior, essas configurações agora substituem as de nível superior. Quaisquer intents ativas ou tipos de entidade dos slots ativos nesse escopo poderão ser acionados se tiverem padrões de DTMF definidos.
Adicionar um padrão de DTMF a uma intent
No menu de navegação à esquerda, selecione a guia Manage e clique em Intents.
Selecione uma intent na lista e acesse a caixa Padrão de DTMF.
Insira uma sequência de DTMF. Use padrões de regex em casos de padrões de 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. Use padrões de regex em casos de padrões de DTMF mais complexos.
Clique em Salvar.
Usar o DTMF no simulador
É possível testar a configuração do DTMF no simulador do console.
No Console do Dialogflow, clique em Agente de teste no canto superior direito da tela.
No painel que aparecer, clique no símbolo + ao lado da caixa de entrada de texto Falar com o agente. Selecione DTMF.
Insira o padrão do DTMF que você quer testar e o dígito de fim do DTMF. Verifique se a caixa Send new DTMF input está marcada e clique em Send. A resposta à entrada do DTMF vai aparecer no simulador.