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, el agente convierte las pulsaciones de teclas del teléfono del usuario final en texto normal y las procesa como entrada del usuario final. Esta conversión puede ser tan simple como los caracteres asociados con las pulsaciones de teclas del teléfono (12*34#), o 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 la 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 DTMF Ejemplo
sys.percentage cualquier número entero 29 -> 29%
sys.temperature cualquier número entero 30 -> 30 °C o 30 °F
sys.phone-number cualquier secuencia de dígitos 4081111111
sys.date (según la configuración regional) AAAAMMDD (en-us) o MMDDYYY 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 punto 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 configurar cuando habilitas la DTMF.

Dígito final

Este parámetro de configuración controla la pulsación de tecla que finalizará de inmediato la entrada 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 final es # y la entrada es 123#, la entrada convertida del usuario final proporcionada al procesamiento del agente es 123.

Duración del tiempo de espera entre dígitos

Un usuario final puede hacer una pausa mientras ingresa una secuencia de pulsaciones de teclas. Si esta duración de 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 aborta el procesamiento de DTMF, proporciona la secuencia no convertida capturada hasta ese punto al agente como entrada del usuario final. Es probable que esta entrada no coincida con ningún intent o parámetro de formulario, por lo que es probable que Dialogflow invoque un evento de no coincidencia.

Cuando usas la consola, este campo se indica en segundos.

Duración del tiempo de espera de los extremos

Después de que se realiza una coincidencia para una secuencia de pulsaciones de teclas, Dialogflow continúa procesando las pulsaciones de teclas. La duración del tiempo de espera de la finalización de la conexión es la duración que Dialogflow esperará más entradas 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 ilimitados.

Si el usuario final pausa la entrada por más tiempo que el establecido en duración del tiempo de espera de finalización, Dialogflow aborta 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. La DTMF se aplicará a todo lo que esté dentro de ese alcance. En esta sección, se describe cómo habilitar la DTMF para un agente como ejemplo. También puedes habilitar la DTMF con la configuración de la página (páginas), la 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 de Finalizar dígitos, Duración del tiempo de espera entre dígitos y Duración del tiempo de espera de marcación. La DTMF ahora está habilitada para todo lo que esté dentro del alcance de ese agente. Si se establece en un nivel inferior, esta configuración ahora anula cualquier configuración de nivel superior. Cualquier intent o tipo de entidad activo de los horarios activos dentro de ese alcance podría activarse si tienen patrones de DTMF definidos.

Agrega un patrón DTMF a un intent

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

  2. Selecciona un intent de la lista que aparece y ve a la casilla Patrón DTMF.

  3. Ingresa una secuencia 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 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 DTMF en la tabla Entidades.

  3. Establece un patrón 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.

Usa DTMF en el simulador

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

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

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

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