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:
- Coincidir con un intent
- Coincidir con una entidad personalizada
- Coincidencia con un tipo de entidad del sistema
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 están habilitadas 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 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 usas la consola, este campo se expresa 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.
Ve a Configuración del agente y selecciona la pestaña IVR y voz.
Ve a la parte inferior de la página y haz clic en la casilla de verificación Habilitar DTMF.
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 activo o tipo de entidad 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
En el menú de navegación de la izquierda, selecciona la pestaña Administrar y haz clic en Intents.
Selecciona un intent de la lista que aparece y ve a la casilla Patrón DTMF.
Ingresa una secuencia DTMF. Puedes usar patrones de regex en casos de patrones de DTMF más complejos.
Haz clic en Guardar para guardar los cambios.
Agrega un patrón DTMF a una entidad
En el menú de navegación de la izquierda, selecciona la pestaña Administrar y haz clic en Tipos de entidades.
Selecciona un tipo de entidad de la lista que aparece. Ve a la columna Patrón DTMF en la tabla Entidades.
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.
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.
En la consola de Dialogflow, haz clic en Test Agent en la esquina superior derecha de la pantalla.
En el panel que aparece, haz clic en el símbolo + junto al cuadro de entrada de texto Hablar con un agente. Selecciona DTMF.
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.