DTMF para integraciones de telefonía

Puedes habilitar y configurar DTMF (señalización multifrecuencia de doble tono) para las integraciones telefónicas. Cuando se habilita, las pulsaciones de teclas del teléfono del usuario final se convierten en texto normal y el agente las procesa como una entrada del usuario final. Esta conversión puede ser tan simple como los caracteres asociados con la pulsación 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 a intents y entidades individuales para activar una coincidencia con secuencias de entrada del usuario final. Cuando habilitas DTMF a nivel global, las entidades del sistema están habilitadas de forma predeterminada.

Regla de entidad del sistema

Las reglas de entidad del sistema están habilitadas 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 -> 30 °C o 30 °C
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 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

Configuración

En esta sección, se describen las configuraciones adicionales que puedes establecer cuando habilitas DTMF.

Dígito de finalización

Esta configuración controla la pulsación de teclas que finalizará inmediatamente la entrada de DTMF, sin esperar más entradas. Es común usar # para este parámetro de configuración. 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 procesamiento del agente es 123.

Duración del tiempo de espera de los interdígitos

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

Si Dialogflow anula 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 sin coincidencias.

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

Duración del tiempo de espera de los extremos

Después de que se realiza una coincidencia para una secuencia de pulsación de teclas, Dialogflow continúa procesando estas pulsaciones. La duración del tiempo de espera del extremo es el tiempo que Dialogflow esperará a recibir más entradas después de que se establezca 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 delimitados.

Si el usuario final pausa la entrada por el tiempo establecido en la duración del tiempo de espera de la terminal, Dialogflow anula el procesamiento de DTMF y convierte la secuencia que coincide en ese momento 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 a modo de ejemplo. También puedes habilitar DTMF usando Configuración de la página (páginas), Configuración de 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 e IVR.

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

  3. Configura los valores de Dígito de finalización, Duración del tiempo de espera de interdígitos y Duración del tiempo de espera de establecimiento. DTMF ahora está habilitado para todo 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 activo o tipo de entidad de las ranuras activas dentro de ese permiso podría activarse 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 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 en la tabla. Puedes usar patrones de regex en casos de patrones 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 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 el agente. Selecciona DTMF.

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