DTMF para integraciones de telefonía

Puedes habilitar y configurar la señalización multifrecuencia de tono dual (DTMF) para las integraciones de telefonía. Cuando está habilitada, las pulsaciones de teclas del teléfono del usuario final se convierten en texto normal y el agente las procesa como entrada del usuario final. Esta conversión puede ser tan sencilla como los caracteres asociados a las pulsaciones de teclas del teléfono (12*34#) o puedes usar expresiones regulares (regex) para secuencias más complejas.

Reglas de coincidencia

Los ajustes de DTMF tienen tres reglas de coincidencia diferentes:

Puedes asociar patrones de DTMF a intenciones y entidades concretas para activar una coincidencia con secuencias de entrada del usuario final. Si habilitas DTMF de forma global, las entidades del sistema se habilitarán de forma predeterminada.

Regla de entidad del sistema

Las reglas de entidad del sistema se habilitan de forma predeterminada al habilitar DTMF.

Escribe el nombre Patrón 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) AAAA-MM-DD (en-us) o MM-DD-AAAA 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 un punto representado 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

Ajustes

En esta sección se describen los ajustes adicionales que puede configurar al habilitar DTMF.

Dígito final

Este ajuste controla la pulsación de teclas que finalizará inmediatamente la entrada de DTMF, sin esperar a que se introduzca más información. Es habitual usar # para este ajuste. El dígito final no se incluye en la entrada del usuario final convertida. Por ejemplo, si el dígito final es # y la entrada es 123#, la entrada del usuario final convertida que se proporciona al agente es 123.

Duración del tiempo de espera entre dígitos

Un usuario final puede hacer una pausa mientras introduce 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 de la secuencia.

Si Dialogflow aborta el procesamiento de DTMF, proporciona al agente la secuencia sin convertir capturada hasta ese momento como entrada del usuario final. Es poco probable que esta entrada coincida con ningú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 de la finalización

Después de que se encuentre una coincidencia para una secuencia de pulsaciones de teclas, Dialogflow sigue procesando las pulsaciones de teclas. Duración del tiempo de espera de finalización es el tiempo que Dialogflow esperará a que se introduzcan más datos después de que se haya encontrado una coincidencia antes de finalizar la detección. Este comportamiento gestiona los casos en los que la secuencia tiene una longitud variable, como los números ilimitados.

Si el usuario final pausa la entrada durante más tiempo del establecido en endpointing timeout duration, Dialogflow aborta el procesamiento de DTMF y convierte la secuencia coincidente actual como lo haría normalmente.

Habilitar DTMF

Puedes habilitar DTMF a nivel de agente, página o parámetro. El DTMF se aplicará a todo lo que esté dentro de ese ámbito. En esta sección se describe cómo habilitar DTMF para un agente como ejemplo. También puedes habilitar DTMF mediante Configuración de página (páginas) o Configuración de flujo (flujos), o bien seleccionando un parámetro y consultando el menú de configuración. En todos los casos, los ajustes de DTMF se encuentran en la parte inferior de la página.

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

  2. Ve a la parte inferior de la página y marca la casilla Habilitar DTMF.

  3. Define los valores de Dígito de finalización, Duración del tiempo de espera entre dígitos y Duración del tiempo de espera de finalización. Ahora, el DTMF está habilitado para todo lo que esté dentro del ámbito de ese agente. Si se definen en un nivel inferior, estos ajustes ahora anulan los ajustes de nivel superior. Cualquier intent o tipo de entidad activos de los slots activos de ese ámbito se pueden activar si tienen patrones de DTMF definidos.

Añadir un patrón de DTMF a una intención

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

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

  3. Introduce 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.

Añadir un patrón de DTMF a una entidad

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

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

  3. Define 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.

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 Probar agente, situado en la esquina superior derecha de la pantalla.

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

  3. Introduce el patrón de DTMF que quieras probar y el dígito de finalización de DTMF. Asegúrate de que la casilla Enviar nueva entrada DTMF esté marcada y, a continuación, haz clic en Enviar. La respuesta a la entrada DTMF aparecerá en el simulador.