DTMF para integrações de telefonia

É possível ativar e configurar a sinalização de multifrequência (DTMF, na sigla em inglês) para telefonia integrações. Quando ativado, as teclas pressionadas pelo usuário final no telefone 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 associado a pressionamentos de tecla (12*34#) ou você pode usar expressões regulares (Regex) para mais sequências complicadas.

Regras de correspondência

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

Você pode associar padrões DTMF a padrões intents e entidades para acionar uma correspondência 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 da 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 (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 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

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 esperar por 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 de finalização 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 de interdigitação

Um usuário final pode pausar enquanto insere uma sequência de pressionamentos de tecla. Se a duração da pausa for maior que o tempo limite entre dígitos, o Dialogflow interromperá o processamento DTMF para a sequência.

Se o Dialogflow cancelar o processamento do DTMF, ele fornecerá os valores capturada até aquele ponto para o agente como entrada do usuário final. Esta entrada é provavelmente não corresponderá a parâmetros de intents ou formulários, provavelmente vai invocar evento sem correspondência.

Ao usar o console, esse campo é em segundos.

Duração do tempo limite de endpoint

Depois que uma correspondência para uma sequência de pressionamentos de tecla é feita, o Dialogflow continua processando pressionamentos de tecla. A duração do tempo limite de finalização é o período em que o Dialogflow vai esperar por mais entradas depois de uma correspondência ser feita 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 tempo definido no tempo limite de endpoint, o Dialogflow abortará o processamento de DTMF e converterá a sequência correspondente normalmente.

Ativar DTMF

É possível ativar o DTMF no nível do agente, da página ou do parâmetro. O DTMF será aplicada a tudo dentro desse escopo. Esta seção descreve a ativação do DTMF de 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 visualizando o menu de configurações. Em todos os casos, as configurações do DTMF podem ser encontradas na parte inferior da página.

  1. Acesse Configurações do agente e selecione a guia Speech and IVR.

  2. Vá para a parte inferior da página e marque a caixa de seleção Ativar DTMF.

  3. Defina os valores para Dígito final, Duração do tempo limite entre dígitos e Definição da duração do tempo limite. O DTMF agora está ativado para tudo dentro do escopo desse agente. Se definidas em um nível inferior, essas configurações agora substituem configurações de nível superior. Quaisquer intents ou tipos de entidade ativos dos slots ativos dentro desse escopo podem ser acionados se tiverem padrões 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 DTMF.

  3. Digite uma sequência DTMF. Você pode usar padrões de regex em casos de e complexos de DTMF.

  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 o padrão DTMF coluna na tabela Entidades.

  3. Defina um padrão DTMF para cada entidade na tabela. Você pode usar padrões de regex em casos de e complexos de DTMF.

  4. Clique em Salvar.

Usar DTMF no simulador

Teste a configuração do DTMF no simulador do console.

  1. No console do Dialogflow, clique em Test Agent 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 agente. Selecione DTMF.

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