É 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 ativados, os pressionamentos de tecla de telefone do usuário final são convertidos em texto normal e processados como entrada do usuário final pelo agente. Essa conversão pode ser tão simples quanto os caracteres
associados a pressionamentos de tecla no telefone (12*34#
). Também é possível 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 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 |
Um número inteiro | 29 -> 29% |
sys.temperature |
Um número inteiro | 30 -> 30C ou 30F |
sys.phone-number |
qualquer sequência de dígitos | 4081111111 |
sys.date |
(dependendo da localidade) AAAAMMDD (pt-BR) ou MMDDYYY | 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
Nesta seção, descrevemos as configurações adicionais 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 esperar 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 convertido
fornecida ao processamento do agente será 123
.
Duração do tempo limite entre 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 DTMF da sequência.
Se o Dialogflow cancelar o processamento do DTMF, ele fornecerá a sequência não convertida capturada até esse ponto para o agente como entrada do usuário final. É improvável que essa entrada corresponda a parâmetros de intent ou formulário. Portanto, o Dialogflow provavelmente invocará um evento sem correspondência.
Ao usar o console, esse campo aparece em segundos.
Duração do tempo limite de endpoint
Depois que uma correspondência para uma sequência de pressionamento de tecla é feita, o Dialogflow continua processando as teclas. A duração do tempo limite do endpoint é o tempo que o Dialogflow aguardará 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 tamanho variável, como números ilimitados.
Se o usuário final pausar a entrada por mais do que o tempo 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
É 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 a ativação do DTMF para um agente como um exemplo. Também é possível ativar o DTMF usando 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 podem ser encontradas na parte inferior da página.
Acesse Configurações do agente e selecione a guia Fala e URA.
Vá para a parte inferior da página e marque a caixa de seleção Ativar DTMF.
Defina os valores de Dígito final, Duração do tempo limite entre dígitos e Duração do tempo limite do início. O DTMF agora está ativado para tudo no escopo desse agente. Se definidas em um nível inferior, essas configurações agora substituem todas as configurações de nível superior. Quaisquer intents ou tipos de entidade ativos dos slots ativos dentro desse escopo poderão ser acionados se tiverem padrões DTMF definidos.
Adicionar um padrão DTMF a uma intent
No menu de navegação à esquerda, selecione a guia Manage e clique em Intents.
Selecione uma intent na lista exibida e acesse a caixa Padrão DTMF.
Insira uma sequência DTMF. É possível 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 DTMF para cada entidade na tabela. É possível usar padrões de regex em casos de padrões DTMF mais complexos.
Clique em Salvar.
Usar DTMF no simulador
Teste 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 aparece, clique no símbolo + ao lado da caixa de entrada de texto Talk to agent. Selecione DTMF.
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 do DTMF vai aparecer no simulador.