Puedes habilitar y configurar DTMF (señalización de varias frecuencias de dos tonos) para las integraciones de telefonía. Cuando está habilitada, las pulsaciones de las teclas del teléfono del usuario final se convierten en texto normal y el agente las procesa como entradas del usuario final. Esta conversión puede ser tan simple como los caracteres asociados a la pulsación de teclas del teléfono (12*34#), o bien puedes usar expresiones regulares (Regex) para secuencias más complicadas.
Reglas de coincidencia
La configuración de DTMF tiene tres reglas de coincidencia diferentes:
- Hacer coincidir con un intent.
- Hacer coincidir con una entidad personalizada.
- Haz coincidir 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 DTMF a nivel global, las entidades del sistema se habilitan de forma predeterminada.
Regla de entidad del sistema
Las reglas de la 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 % a 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 -> 1/10/2023, 1/10/2023 -> 1/10/2023 |
sys.zip-code |
cualquier secuencia de dígitos | 94043 |
sys.number |
secuencia de dígitos con el 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 las opciones de configuración adicionales que puedes establecer cuando habilitas DTMF.
Finalizar dígito
Esta 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 final no se incluye en la entrada del usuario final convertida. Por ejemplo, si el dígito de finalización 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 entre dígitos
Un usuario final podría 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 anula el procesamiento de DTMF de la secuencia.
Si Dialogflow anula el procesamiento de DTMF, proporciona al agente la secuencia no convertida 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 Dialogflow probablemente invocará un evento sin coincidencias.
Cuando se usa la consola, este campo se expresa en segundos.
Duración del tiempo de espera del extremo
Después de que se detecta una coincidencia para una secuencia de pulsación de teclas, Dialogflow continúa procesando las pulsaciones de teclas. La duración del tiempo de espera del extremo 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 no delimitados.
Si el usuario final pausa la entrada durante el tiempo establecido en la duración del tiempo de espera del extremo, Dialogflow anula el procesamiento de DTMF y convierte la secuencia coincidente en este 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 con la Configuración de la página (páginas), la Configuración de flujo (flujos), o bien seleccionando un parámetro y visualizando 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.
Configura 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 entrada. DTMF ahora está habilitado para todo lo que esté dentro del alcance de ese agente. Si se establece en un nivel inferior, esta configuración ahora anulará 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.
Cómo agregar 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 al cuadro Patrón de DTMF.
Ingresa una secuencia de 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 de 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.
Cómo usar DTMF en el simulador
Puedes probar tu configuración de DTMF en el simulador de la consola.
En la consola de Dialogflow, haz clic en Agente de prueba en la esquina superior derecha de la pantalla.
En el panel que aparece, haz clic en el símbolo + junto a la casilla de entrada de texto Talk to agent. Selecciona DTMF.
Ingresa el patrón DTMF que quieres probar y el dígito de finalización de DTMF. Asegúrate de que la casilla Enviar entrada de DTMF nueva esté marcada y, luego, haz clic en Enviar. La respuesta a la entrada de DTMF aparecerá en el simulador.