Reproducir tonos del teclado

Información general

La herramienta de tonos del teclado permite a los agentes de ElevenLabs reproducir tonos DTMF (multifrecuencia de doble tono) durante las llamadas telefónicas; son los tonos que se reproducen al pulsar números en el teclado. Esto permite a los agentes interactuar con sistemas telefónicos automatizados, navegar por menús de voz, introducir extensiones, códigos PIN y realizar otras operaciones de tonos que normalmente requerirían que una persona pulsara teclas en el teclado de su teléfono.

Esta herramienta del sistema admite tonos DTMF estándar (0-9, *, #), así como comandos de pausa para controlar la temporización. Funciona sin problemas con las integraciones telefónicas de Twilio y SIP trunking, generando automáticamente los tonos de audio adecuados para la infraestructura de telefonía subyacente.

Para recopilar en su lugar los dígitos del teclado de quienes llaman, consulta la entrada DTMF.

Funcionalidad

• Tonos DTMF estándar: admite todos los caracteres estándar del teclado (0-9, *, #)
• Control de pausas: incluye comandos de pausa para una temporización precisa (w = 0,5 s, W = 1,0 s)
• Compatibilidad con varios proveedores: funciona con integraciones de Twilio y SIP trunking

Esta herramienta del sistema se puede utilizar para navegar por menús telefónicos, introducir extensiones y códigos. El LLM determina cuándo y qué tonos reproducir según el contexto de la conversación.

La descripción predeterminada de la herramienta explica al LLM que gestiona la conversación que puede reproducir estos tonos, y recomendamos actualizar el prompt del sistema de tu agente para indicar cuándo debe llamar a esta herramienta.

Parámetros:

• reason (cadena, opcional): El motivo para reproducir los tonos DTMF (p. ej., “navegar a una extensión”, “introducir PIN”)
• dtmf_tones (cadena, obligatorio): La secuencia DTMF que se va a reproducir. Caracteres válidos: 0-9, *, #, w (pausa de 0,5 s), W (pausa de 1 s)

Formato de llamada de función:

{
  "type": "function",
  "function": {
    "name": "play_keypad_touch_tone",
    "arguments": "{"reason": "Navigating to customer service", "dtmf_tones": "2"}"
  }
}

DTMF fuera de banda

De forma predeterminada, los tonos DTMF se envían como señales de audio en banda dentro del flujo de voz. Sin embargo, algunos sistemas IVR (respuesta de voz interactiva) pueden no detectar de forma fiable estos tonos en banda debido a la compresión de audio, las condiciones de red o la configuración del sistema.

El DTMF fuera de banda (RFC 4733) envía los tonos como paquetes RTP independientes en lugar de audio. Este método es más fiable para implementaciones de SIP trunking en las que los sistemas IVR del destinatario tienen dificultades para detectar DTMF estándar en banda.

Para activar DTMF fuera de banda:

1. Ve a la configuración de herramientas de tu agente
2. Selecciona la herramienta Reproducir tonos del teclado
3. Marca la casilla Usar DTMF fuera de banda (RFC 4733)

Caracteres compatibles

La herramienta admite los siguientes caracteres y comandos DTMF:

• Dígitos: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
• Tonos especiales: * (asterisco), # (almohadilla)
• Comandos de pausa:
  • w - Pausa corta (0,5 segundos)
  • W - Pausa larga (1,0 segundo)

Implementación de la API

Puedes configurar la herramienta del sistema play_keypad_touch_tone al crear o actualizar un agente mediante la API. Esta herramienta no requiere parámetros de configuración adicionales aparte de activarla.

from elevenlabs import AgentConfig, ConversationalConfig, ElevenLabs
elevenlabs = ElevenLabs(api_key="YOUR_API_KEY")
response = elevenlabs.conversational_ai.agents.create(
    conversation_config=ConversationalConfig(
        agent=AgentConfig(
            first_message="Hi, I can help you navigate phone systems. How can I assist you today?",
            prompt={
                "prompt": "You are a helpful assistant that can interact with phone systems.",
                "built_in_tools": {
                    "play_keypad_touch_tone": {
                        "type": "system",
                        "name": "play_keypad_touch_tone",
                        # Optional custom description
                        "description": "Play DTMF tones to interact with automated phone systems.",
                        "params": {"system_tool_type": "play_keypad_touch_tone"},
                    }
                },
            },
        ),
    ),
)