Descripción General
Los controles DTMF (Tono Multifrecuencia de Doble Tono) permiten que tus agentes de IA tanto envíen como capturen tonos de teclado telefónico durante las conversaciones. Esto permite que los agentes naveguen sistemas IVR, interactúen con sistemas telefónicos heredados y recopilen entrada estructurada de las personas que llaman a través de presiones de teclas - transformando tu agente de solo voz a un sistema de automatización telefónica con todas las características. Las capacidades DTMF son esenciales para integrar agentes de IA con la infraestructura telefónica empresarial existente, permitiendo transferencias sin problemas a través de menús IVR complejos y recopilando entrada numérica precisa como números de cuenta, códigos PIN o selecciones de menú.¿Qué es DTMF?
Comprendiendo la Tecnología DTMF
DTMF es la señal generada cuando presionas teclas en un teclado telefónico. Cada tecla produce dos tonos simultáneos a diferentes frecuencias - uno alto y uno bajo - creando un sonido único que los sistemas pueden decodificar para identificar qué tecla se presionó. Teclas disponibles:- Dígitos: 0-9 (entrada numérica)
- Asterisco: * (a menudo usado como “atrás” o “cancelar”)
- Almohadilla/Hash: # (a menudo usado como “confirmar” o “enter”)
- Navegar menús IVR (“Presione 1 para Ventas, 2 para Soporte”)
- Ingresar números de cuenta o PINs
- Confirmar o cancelar acciones
Capacidades DTMF
Dos Funciones Principales
Envío de Tonos
Captura de Tonos
Casos de Uso de Envío de Tonos
Navegación IVR
Navegación IVR
Autenticación
Autenticación
Integración de Sistemas
Integración de Sistemas
Casos de Uso de Captura de Tonos
Selección de Menú
Selección de Menú
Recopilación de Información
Recopilación de Información
Entrada por Teclado
Entrada por Teclado
Configurando Controles DTMF
Accediendo a Configuraciones DTMF
Navega a Configuración DTMF


Alternador Global DTMF
Habilitar DTMF durante llamadas Permite que el agente envíe tonos de teclado y recopile dígitos de las personas que llaman. Cuándo habilitar:- El agente necesita navegar sistemas IVR
- El agente necesita recopilar entrada numérica estructurada
- La integración requiere interacción DTMF
Configuración de Envío de Tonos
Envío de Tonos
Configura tu agente para enviar tonos DTMF a sistemas externos. Alternador: Permite que el agente envíe tonos de teclado Parámetros:- Tiempo de espera entre tonos (segundos): 3 segundos (predeterminado)
- Duración de tono (ms): 120 ms (predeterminado)
- Espacio entre tonos (ms): 70 ms (predeterminado)
Parámetros de Envío de Tonos
Tiempo de espera entre tonos (segundos)
Tiempo de espera entre tonos (segundos)
- Aumentar (4-5s): Sistemas IVR lentos/heredados perdiendo tonos
- Disminuir (1-2s): Sistemas modernos rápidos, reducir tiempo total de navegación
Duración de tono (ms)
Duración de tono (ms)
- Aumentar (150-200ms): Sistemas IVR no detectando tonos confiablemente
- Disminuir (80-100ms): Acelerar interacciones, reducir latencia
Espacio entre tonos (ms)
Espacio entre tonos (ms)
- Aumentar (100-150ms): IVR tratando tonos rápidos como entrada única
- Disminuir (40-50ms): Acelerar secuencias de múltiples dígitos
Configuraciones Recomendadas por Caso de Uso
IVRs Modernos Rápidos
IVRs Modernos Rápidos
- Tiempo de espera: 1-2 segundos
- Duración de Tono: 100ms
- Espacio entre tonos: 50ms
IVRs Estándar (Predeterminado)
IVRs Estándar (Predeterminado)
- Tiempo de espera: 3 segundos (predeterminado)
- Duración de Tono: 120ms (predeterminado)
- Espacio entre tonos: 70ms (predeterminado)
IVRs Lentos/Problemáticos
IVRs Lentos/Problemáticos
- Tiempo de espera: 4-5 segundos
- Duración de Tono: 150ms
- Espacio entre tonos: 100ms
Configuración de Captura de Tonos
Modos de Captura
Elige cómo tu agente recibe e interpreta entrada DTMF de las personas que llaman.Menú (tecla única)
Recopilador (múltiples dígitos)
Modo Menú
Para selecciones de menú estilo IVR El modo Menú captura una presión de tecla única y la envía inmediatamente al agente.

- El agente presenta opciones de menú
- El cliente presiona tecla única (0-9, *, #)
- El agente recibe dígito inmediatamente
- El agente responde según la tecla presionada
- Captura presión de tecla única
- Procesa inmediatamente
- No se requiere tecla de terminación
- Tecla de borrado no disponible
Modo Recopilador
Para recopilar secuencias como números de cuenta, PINs, números telefónicos El modo Recopilador almacena múltiples dígitos hasta que el usuario presiona la tecla de terminación o expira el tiempo de espera.

- El agente solicita entrada de múltiples dígitos
- El cliente ingresa múltiples dígitos
- Presiona tecla de terminación (usualmente #) cuando complete
- El agente recibe cadena de dígitos completa
- Dígitos mínimos: 1 (predeterminado)
- Dígitos máximos: 25 (predeterminado)
- Tiempo de espera (ms): 6000ms (6 segundos, predeterminado)
- Tecla de terminación: # (Almohadilla)
- Tecla de borrar entrada: * (Asterisco)
Parámetros del Modo Recopilador
Dígitos mínimos
Dígitos mínimos
- Número de cuenta (10 dígitos): Establecer a 10
- PIN (4 dígitos): Establecer a 4
- Entrada flexible: Establecer a 1 (cualquier longitud aceptada)
- Si el cliente presiona # antes de alcanzar el mínimo → Error, solicitar re-ingresar
- Si el cliente alcanza el mínimo → Puede presionar # para enviar anticipadamente
Dígitos máximos
Dígitos máximos
- Número telefónico: Establecer a 10 (formato US)
- Número de cuenta: Establecer a longitud esperada
- Longitud variable: Establecer más alto que el máximo esperado
- Cuando se ingresan dígitos máximos → Envía automáticamente sin requerir #
- Tonos después del máximo son ignorados
Tiempo de espera (ms)
Tiempo de espera (ms)
- El temporizador comienza después de cada presión de dígito
- Se reinicia con cada nuevo dígito
- Si se alcanza el tiempo de espera → Tratar como completo o solicitar más
- Entrada rápida (PIN): 3000-4000ms (3-4 segundos)
- Entrada larga (número de cuenta): 6000-8000ms (6-8 segundos)
- Sistema paciente: 10000ms+ (10+ segundos)
Tecla de terminación
Tecla de terminación
Tecla de borrar entrada
Tecla de borrar entrada
Configuraciones de Recopilador Recomendadas por Caso de Uso
Recopilación de Número de Cuenta (10 dígitos)
Recopilación de Número de Cuenta (10 dígitos)
- Dígitos mínimos: 10
- Dígitos máximos: 10
- Tecla de terminación: # (opcional, auto-envía a los 10)
- Tiempo de espera: 6000ms (6 segundos)
- Tecla de borrar entrada: *
Recopilación de PIN (4-6 dígitos)
Recopilación de PIN (4-6 dígitos)
- Dígitos mínimos: 4
- Dígitos máximos: 6
- Tecla de terminación: #
- Tiempo de espera: 4000ms (4 segundos)
- Tecla de borrar entrada: *
Número Telefónico (Formato Variable)
Número Telefónico (Formato Variable)
- Dígitos mínimos: 7
- Dígitos máximos: 15
- Tecla de terminación: #
- Tiempo de espera: 6000ms (6 segundos)
- Tecla de borrar entrada: *
Entrada Numérica Flexible (Predeterminado)
Entrada Numérica Flexible (Predeterminado)
- Dígitos mínimos: 1 (predeterminado)
- Dígitos máximos: 25 (predeterminado)
- Tecla de terminación: #
- Tiempo de espera: 6000ms (6 segundos, predeterminado)
- Tecla de borrar entrada: *
Usando DTMF en Instrucciones
Solicitando Entrada DTMF
Ejemplo de selección de menú:Manejando Respuestas DTMF
Procesamiento automático: Cuando la captura DTMF está habilitada, el agente recibe automáticamente dígitos recopilados y puede responder a ellos. No se necesita configuración adicional. Avanzado: Usando la herramienta wait_for_dtmf_input Para control explícito en las instrucciones de tu agente, puedes llamar a la herramientawait_for_dtmf_input. Devuelve:
Respaldo a Voz
Ofreciendo alternativa de voz:Probando Configuración DTMF
Plan de Prueba
Probar Envío de Tonos (Navegación IVR)
- Configura agente con acción de transferencia a número telefónico con IVR
- Agrega instrucciones para navegar IVR usando tonos DTMF
- Inicia llamada de prueba
- Activa acción de transferencia
- Monitorea agente navegando IVR (verifica registros para tonos enviados)
- Verifica que el agente alcanza el destino correcto
- Tonos enviados en intervalos correctos
- IVR reconoce todos los tonos
- La navegación se completa exitosamente
- Sin tonos perdidos o mal interpretados
Probar Modo Menú (Captura de Tecla Única)
- Configura DTMF en modo Menú
- Agrega opciones de menú a instrucciones
- Inicia llamada de prueba
- Escucha opciones de menú
- Presiona tecla única (1, 2, 3, etc.)
- Verifica que el agente reconoce y responde apropiadamente
| Tecla | Acción Esperada |
|---|---|
| 1 | Enrutar a opción 1 |
| 2 | Enrutar a opción 2 |
| 9 | Enrutar a opción 9 |
| * | Manejar tecla asterisco |
| # | Manejar tecla almohadilla |
| Inválida | Manejo de error |
Probar Modo Recopilador (Múltiples Dígitos)
- Configura DTMF en modo Recopilador
- Establece dígitos min/max apropiados, tecla de terminación
- Inicia llamada de prueba
- Solicita al agente recopilar dígitos
- Ingresa varias secuencias de dígitos:
- Exactamente dígitos mínimos + #
- Entre dígitos min y max + #
- Exactamente dígitos máximos (auto-envío)
- Usa tecla de borrado (*) para corregir errores
- Deja que la entrada expire
- Verifica que el agente recibe cadena de dígitos correcta
- Funciona la aplicación de dígitos mínimos
- Funciona el auto-envío de dígitos máximos
- La tecla de terminación finaliza apropiadamente la entrada
- La tecla de borrado borra correctamente el último dígito
- Manejo de tiempo de espera apropiado
Probar Casos Extremos
- Presiona # inmediatamente (sin dígitos)
- Debe rechazar si min > 0
- Ingresa dígitos parciales, espera tiempo de espera
- Verifica manejo apropiado
- Ingresa dígitos muy rápidamente
- Verifica que todos se capturan correctamente
- Presiona * en buffer vacío (debe ignorar)
- Presiona * múltiples veces (borra múltiples dígitos)
- Ingresa dígitos, borra todos, ingresa nueva secuencia
- Presiona teclas en modo incorrecto (ej., # en modo Menú)
- Mantén tecla presionada mucho tiempo
- Presiona múltiples teclas simultáneamente
Probar Integración con Instrucciones
- El agente solicita apropiadamente entrada DTMF
- El agente espera entrada (no continúa hablando)
- El agente confirma recepción de entrada
- El agente procesa correctamente el valor capturado
- El agente maneja entrada inválida elegantemente
- El agente ofrece respaldo de voz cuando sea apropiado
Problemas Comunes de Prueba
Tonos No Detectados
Tonos No Detectados
- Soporte DTMF no habilitado globalmente
- Duración de tono demasiado corta para detección
- Problemas de red/codec degradando tonos
- Instrucciones no manejando variable DTMF
- Verifica que el alternador Soporte DTMF esté ENCENDIDO
- Aumenta duración de tono a 150-200ms
- Prueba desde teléfono/red diferente
- Verifica registros para confirmar que la herramienta
wait_for_dtmf_inputesté registrada e invocada - Verifica que
session.userdata.last_dtmf_inputse esté poblando en registros de worker
Dígitos Incorrectos Capturados
Dígitos Incorrectos Capturados
- Espacio entre tonos demasiado corto (tonos mezclándose)
- Ruido de fondo creando tonos falsos
- Cliente presionando teclas demasiado rápidamente
- Aumenta espacio entre tonos a 100-150ms
- Prueba en entorno silencioso
- Aumenta tiempo de espera para ralentizar entrada del cliente
- Agrega validación y confirmación en instrucciones
Navegación IVR Fallando
Navegación IVR Fallando
Tecla de Borrado No Funciona
Tecla de Borrado No Funciona
- Tecla de borrado no configurada apropiadamente
- Tecla de borrado presionada en modo Menú (no aplicable)
- * asignado como tecla de terminación (conflicto)
- Verifica que la tecla de borrado esté establecida a * en modo Recopilador
- Asegura que el modo sea Recopilador (la tecla de borrado solo funciona en Recopilador)
- No uses * como tecla de borrado y terminación
Mejores Prácticas
Siempre Ofrece Respaldo de Voz
Siempre Ofrece Respaldo de Voz
- Teléfonos móviles en áreas de señal pobre
- Apps VoIP sin teclado
- Necesidades de accesibilidad
- Preferencia por interacción de voz
Confirma Entrada Recibida
Confirma Entrada Recibida
Instrucciones Claras para Avisos DTMF
Instrucciones Claras para Avisos DTMF
- Qué ingresar (número de cuenta, PIN, selección)
- Cuántos dígitos (si longitud fija)
- Tecla de terminación (si aplica)
- Método alternativo (voz)
Comienza con Tiempo Conservador
Comienza con Tiempo Conservador
- Comienza con predeterminados recomendados
- Despliega a grupo de prueba pequeño
- Monitorea errores DTMF en registros
- Ajusta tiempo según fallos reales
- Despliega configuraciones optimizadas
- Establezcas tiempo muy rápido sin probar
- Asumas que todos los IVRs se comportan igual
- Optimices para velocidad sobre confiabilidad
Maneja Reintentos Elegantemente
Maneja Reintentos Elegantemente
- Te rindas después de un solo fallo
- Repitas exactamente las mismas instrucciones (no es útil)
- Te quedes atascado en bucle de reintento infinito