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 está habilitado, 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 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 las secuencias de entrada del usuario final. Cuando habilitas DTMF de forma global, las entidades del sistema se habilitan de forma predeterminada.

Regla de entidad del sistema

Las reglas deentidades del sistema están habilitadas de forma predeterminada cuando habilitas DTMF.

Escribe el nombre 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) 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 punto representado por la clave “*” 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 DTMF.

Dígito de finalización

Este parámetro de configuración controla la pulsación de teclas 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 convertida del usuario final que se proporciona al procesamiento del agente es 123.

Inhabilitar 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 de DTMF.

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 la duración de esta pausa es mayor que la duración del tiempo de espera entre dígitos, Dialogflow anula el procesamiento de DTMF para la secuencia.

Si Dialogflow anula el procesamiento de DTMF, proporciona la secuencia no convertida 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 está en segundos.

Duración del tiempo de espera de finalización

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 finalización es el tiempo 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 es de longitud variable, como números no delimitados.

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

Habilitar DTMF

Puedes habilitar DTMF a nivel del agente, la página o el parámetro. DTMF se aplicará a todo lo que esté dentro de ese alcance. En esta sección, se describe cómo habilitar 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 Voz y IVR.

  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 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 DTMF está habilitado para todo lo que esté dentro del alcance de ese agente. Si se establece 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 los espacios activos dentro de ese alcance se pueden activar si tienen patrones de DTMF definidos.

Agrega 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 Intents.

  2. Selecciona un intent 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.

Usa 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 en la esquina superior derecha de la pantalla.

  2. En el panel que aparece, haz clic en el símbolo + junto a la casilla de entrada de texto Hablar con el 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 Enviar nueva entrada de DTMF esté marcada y, luego, haz clic en Enviar. La respuesta a la entrada de DTMF aparecerá en el simulador.