DTMF para integrações de telefonia

Pode ativar e configurar o DTMF (sinalização multifrequência de tom duplo) para integrações de telefonia. Quando ativada, as teclas do teclado do utilizador final são convertidas em texto normal e processadas como entrada do utilizador final pelo agente. Esta conversão pode ser tão simples como os carateres associados a teclas premidas no telefone (12*34#) ou pode usar expressões regulares (regex) para sequências mais complicadas.

Regras de correspondência

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

Pode associar padrões DTMF a intenções e entidades individuais para acionar uma correspondência com sequências de entrada do utilizador final. Quando ativa o DTMF globalmente, as entidades do sistema são ativadas por predefinição.

Regra de entidade do sistema

As regras de entidade do sistema são ativadas por predefinição quando ativa o DTMF.

Introduza o 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 (consoante a região) 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

Definições

Esta secção descreve as definições adicionais que pode configurar quando ativa o DTMF.

Algarismo final

Esta definição controla a tecla que termina imediatamente a entrada DTMF, sem esperar por mais entradas. É comum usar # para esta definição. O dígito final não está incluído na entrada do utilizador final convertida. Por exemplo, se o dígito final for # e a entrada for 123#, a entrada do utilizador final convertida fornecida ao processamento do agente é 123.

Duração do limite de tempo entre dígitos

Um utilizador final pode pausar enquanto introduz uma sequência de teclas. Se esta duração da pausa for superior à duração do limite de tempo entre dígitos, o Dialogflow anula o processamento de DTMF para a sequência.

Se o Dialogflow anular o processamento de DTMF, fornece a sequência não convertida capturada até esse ponto ao agente como entrada do utilizador final. É improvável que esta entrada corresponda a parâmetros de intenção ou formulário, pelo que o Dialogflow irá provavelmente invocar um evento de não correspondência.

Quando usa a consola, este campo está em segundos.

Duração do limite de tempo de deteção de fim de conversa

Depois de ser encontrada uma correspondência para uma sequência de teclas, o Dialogflow continua a processar as teclas. A duração do limite de tempo de deteção de fim de frase é a duração que o Dialogflow aguarda para receber mais introduções depois de encontrar uma correspondência antes de terminar a deteção. Este comportamento processa cenários em que a sequência tem um comprimento variável, como números ilimitados.

Se o utilizador final pausar a introdução durante mais tempo do que o tempo definido na duração do limite de tempo de deteção de fim de entrada, o Dialogflow anula o processamento de DTMF e converte a sequência correspondente atual como faria normalmente.

Ative o DTMF

Pode ativar o DTMF ao nível do agente, da página ou do parâmetro. O DTMF vai ser aplicado a tudo dentro desse âmbito. Esta secção descreve a ativação do DTMF para um agente como exemplo. Também pode ativar o DTMF através das Definições da página (páginas), das Definições do fluxo (fluxos) ou selecionando um parâmetro e visualizando o menu de definições. Em todos os casos, as definições de DTMF encontram-se na parte inferior da página.

  1. Aceda a Definições do agente e selecione o separador Voz e IVR.

  2. Aceda à parte inferior da página e clique na caixa de verificação Ativar DTMF.

  3. Defina os valores para Finish digit, Interdigit timeout duration e Enpointing timeout duration. O DTMF está agora ativado para tudo o que estiver no âmbito desse agente. Se forem definidas num nível inferior, estas definições substituem agora as definições de nível superior. Quaisquer intenções ou tipos de entidades ativos dos espaços ativos nesse âmbito podem ser acionados se tiverem padrões DTMF definidos.

Adicione um padrão DTMF a uma intenção

  1. No menu de navegação do lado esquerdo, selecione o separador Gerir e clique em Intenções.

  2. Selecione uma intenção na lista apresentada e aceda à caixa Padrão DTMF.

  3. Introduza uma sequência DTMF. Pode usar padrões de regex em casos de padrões DTMF mais complexos.

  4. Clique em Guardar para guardar as alterações.

Adicione um padrão DTMF a uma entidade

  1. No menu de navegação do lado esquerdo, selecione o separador Gerir e clique em Tipos de entidades.

  2. Selecione um tipo de entidade na lista apresentada. Aceda à coluna Padrão DTMF na tabela Entidades.

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

  4. Clique em Guardar para guardar as alterações.

Use DTMF no simulador

Pode testar a configuração de DTMF no simulador da consola.

  1. Na consola do Dialogflow, clique em Testar agente no canto superior direito do ecrã.

  2. No painel apresentado, clique no símbolo + junto à caixa de introdução de texto Falar com um agente. Selecione DTMF.

  3. Introduza o padrão DTMF que quer testar e o dígito final do DTMF. Certifique-se de que a caixa Enviar nova entrada DTMF está selecionada e, de seguida, clique em Enviar. A resposta à entrada DTMF aparece no simulador.