DTMF para integraciones de telefonía

Puedes habilitar y configurar DTMF (señalización multifrecuencia de dos tonos) para las integraciones de telefonía. Cuando se habilita, las pulsaciones de teclas telefónicas del usuario final se convierten en texto normal y el agente las procesa como entrada del usuario final. Esta conversión puede ser tan simple como los caracteres asociados a las pulsaciones de teclas telefónicas (12*34#), o bien puedes usar expresiones regulares (regex) para secuencias más complicadas.

Reglas de coincidencia

La configuración de DTMF tiene tres reglas de coincidencia diferentes:

Puedes asociar patrones de DTMF con intents y entidades individuales para activar una coincidencia con secuencias de entrada del usuario final. Cuando habilitas el DTMF de forma global, las entidades del sistema se habilitan de forma predeterminada.

Regla de entidad del sistema

Las reglas de entidad del sistema se habilitan de forma predeterminada cuando habilitas DTMF.

Nombre del tipo Patrón de DTMF Ejemplo
sys.percentage Cualquier número entero 29 -> 29%
sys.temperature Cualquier número entero 30 -> 30C o 30F
sys.phone-number cualquier secuencia de dígitos 4081111111
sys.date (según la configuración regional) AAAAMMDD (en-us) o MMDDAAAA 20231001 -> 2023-10-01, 10-01-2023 -> 10-01-2023
sys.zip-code cualquier secuencia de dígitos 94043
sys.number Secuencia de dígitos con período representada por la tecla "*" 123 -> 123, 123*45 -> 123.45
sys.cardinal cualquier secuencia de dígitos 12345
sys.number-integer cualquier secuencia de dígitos 12345
sys.number-sequence cualquier secuencia de dígitos 12345
sys.ordinal cualquier secuencia de dígitos 12345

Configuración

En esta sección, se describen los parámetros de configuración adicionales que puedes establecer cuando habilitas DTMF.

Dígito final

Este parámetro de configuración controla la presión de tecla que finalizará de inmediato la entrada de DTMF, sin esperar más entradas. Es común usar # para este parámetro de configuración. El dígito de finalización no se incluye en la entrada convertida del usuario final. Por ejemplo, si el dígito de finalización es # y la entrada es 123#, la entrada del usuario final convertida que se proporciona al procesamiento del agente es 123.

Inhabilita la detección de voz

Con este parámetro de configuración habilitado, el agente ignora las entradas de voz y usa el modo de entrada solo con DTMF.

Duración del tiempo de espera entre dígitos

Es posible que un usuario final haga una pausa mientras ingresa una secuencia de pulsaciones de teclas. Si la duración de esta pausa es mayor que la duración del tiempo de espera entre dígitos, Dialogflow aborta el procesamiento de DTMF para la secuencia.

Si Dialogflow anula el procesamiento de DTMF, proporciona la secuencia sin convertir capturada hasta ese punto al agente como entrada del usuario final. Es poco probable que esta entrada coincida con algún intent o parámetro de formulario, por lo que es probable que Dialogflow invoque un evento de no coincidencia.

Cuando se usa la consola, este campo se expresa en segundos.

Duración del tiempo de espera del extremo

Después de que se encuentra una coincidencia para una secuencia de pulsaciones de teclas, Dialogflow sigue procesando las pulsaciones de teclas. La duración del tiempo de espera de la finalización es el tiempo que Dialogflow esperará más entrada después de que se realice una coincidencia antes de finalizar la detección. Este comportamiento controla situaciones en las que la secuencia tiene una longitud variable, como números no acotados.

Si el usuario final pausa la entrada durante más tiempo del establecido en la duración del tiempo de espera de la detección de extremos, Dialogflow anula el procesamiento de DTMF y convierte la secuencia que coincide actualmente como lo haría normalmente.

Habilita DTMF

Puedes habilitar DTMF a nivel del agente, la página o el parámetro. Los DTMF se aplicarán a todo lo que se encuentre dentro de ese alcance. En esta sección, se describe cómo habilitar el DTMF para un agente como ejemplo. También puedes habilitar DTMF con Configuración de la página (páginas), Configuración del flujo (flujos) o seleccionando un parámetro y viendo el menú de configuración. En todos los casos, la configuración de DTMF se encuentra en la parte inferior de la página.

  1. Ve a Configuración del agente y selecciona la pestaña IVR y voz.

  2. Ve a la parte inferior de la página y haz clic en la casilla de verificación Habilitar DTMF.

  3. Establece los valores para Finalizar dígitos, Duración del tiempo de espera entre dígitos y Duración del tiempo de espera de punto final. Ahora, el DTMF está habilitado para todo lo que se encuentra dentro del alcance de ese agente. Si se establecen en un nivel inferior, estos parámetros de configuración ahora anulan cualquier parámetro de configuración de nivel superior. Cualquier intent o tipo de entidad activos de las ranuras activas dentro de ese alcance se pueden activar si tienen patrones de DTMF definidos.

Cómo agregar un patrón de DTMF a un intent

  1. En el menú de navegación de la izquierda, selecciona la pestaña Administrar y haz clic en Intenciones.

  2. Selecciona una intención de la lista que aparece y ve al cuadro Patrón de DTMF.

  3. Ingresa una secuencia de DTMF. Puedes usar patrones de regex en casos de patrones de DTMF más complejos.

  4. Haz clic en Guardar para guardar los cambios.

Agrega un patrón de DTMF a una entidad

  1. En el menú de navegación de la izquierda, selecciona la pestaña Administrar y haz clic en Tipos de entidades.

  2. Selecciona un tipo de entidad de la lista que aparece. Ve a la columna Patrón de DTMF en la tabla Entidades.

  3. Establece un patrón de DTMF para cada entidad de la tabla. Puedes usar patrones de regex en casos de patrones de DTMF más complejos.

  4. Haz clic en Guardar para guardar los cambios.

Cómo usar DTMF en el simulador

Puedes probar tu configuración de DTMF en el simulador de la consola.

  1. En la consola de Dialogflow, haz clic en Test Agent en la esquina superior derecha de la pantalla.

  2. En el panel emergente, haz clic en el símbolo + junto al cuadro de entrada de texto Hablar con un agente. Selecciona DTMF.

  3. Ingresa el patrón de DTMF que deseas probar y el dígito de finalización de DTMF. Asegúrate de que la casilla de verificación Send new DTMF input esté marcada y, luego, haz clic en Send. La respuesta a la entrada de DTMF aparecerá en el simulador.