Toetstoon afspelen

Overzicht

Met de keypad touch tone-tool kunnen ElevenLabs-agents tijdens telefoongesprekken DTMF-tonen (Dual-Tone Multi-Frequency) afspelen. Dit zijn de tonen die worden afgespeeld wanneer je nummers op je toetsenblok indrukt. Hiermee kunnen agents communiceren met geautomatiseerde telefoonsystemen, spraakmenu’s doorlopen, extensies invoeren, pincodes invoeren en andere toetsbewerkingen uitvoeren waarvoor een menselijke beller normaal gesproken toetsen op het toetsenblok van de telefoon moet indrukken.

Deze systeemtool ondersteunt standaard-DTMF-tonen (0-9, *, #) en pauzecommando’s voor timingcontrole. De tool werkt naadloos met telefoonintegraties voor zowel Twilio als SIP trunking en genereert automatisch de juiste audiotonen voor de onderliggende telefonie-infrastructuur.

Zie DTMF-invoer als je in plaats daarvan toetsenblokcijfers van bellers wilt verzamelen.

Functionaliteit

• Standaard-DTMF-tonen: Ondersteunt alle standaardtekens op het toetsenblok (0-9, *, #)
• Pauzeregeling: Bevat pauzecommando’s voor nauwkeurige timing (w = 0,5 s, W = 1,0 s)
• Ondersteuning voor meerdere providers: Werkt met integraties voor zowel Twilio als SIP trunking

Deze systeemtool kan worden gebruikt om telefoonmenu’s te doorlopen, extensies in te voeren en codes in te voeren. De LLM bepaalt op basis van de gesprekscontext wanneer en welke tonen moeten worden afgespeeld.

De standaardtoolbeschrijving legt aan de LLM die het gesprek aanstuurt uit dat deze toegang heeft om deze tonen af te spelen, en we raden aan de systeemprompt van je agent bij te werken om uit te leggen wanneer de agent deze tool moet aanroepen.

Parameters:

• reason (string, optioneel): De reden voor het afspelen van de DTMF-tonen (bijv. “naar een extensie navigeren”, “pincode invoeren”)
• dtmf_tones (string, verplicht): De af te spelen DTMF-reeks. Geldige tekens: 0-9, *, #, w (pauze van 0,5 s), W (pauze van 1 s)

Indeling voor functieaanroepen:

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

DTMF buiten de audiostream

Standaard worden DTMF-tonen als in-band-audiosignalen binnen de spraakstream verzonden. Sommige IVR-systemen (Interactive Voice Response) detecteren deze in-band-tonen echter mogelijk niet betrouwbaar vanwege audiocompressie, netwerkomstandigheden of systeemconfiguratie.

DTMF buiten de audiostream (RFC 4733) verzendt tonen als afzonderlijke RTP-pakketten in plaats van audio. Deze methode is betrouwbaarder voor SIP-trunkingimplementaties waarbij IVR-systemen van ontvangers moeite hebben om standaard in-band-DTMF te detecteren.

DTMF buiten de audiostream inschakelen:

1. Ga naar de toolconfiguratie van je agent
2. Selecteer de tool Play keypad touch tone
3. Schakel het selectievakje Use out-of-band DTMF (RFC 4733) in

Ondersteunde tekens

De tool ondersteunt de volgende DTMF-tekens en -commando’s:

• Cijfers: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9
• Speciale tonen: * (ster), # (hekje)
• Pauzecommando’s:
  • w - Korte pauze (0,5 seconde)
  • W - Lange pauze (1,0 seconde)

API-implementatie

Je kunt de systeemtool play_keypad_touch_tone configureren wanneer je via de API een agent maakt of bijwerkt. Deze tool vereist geen aanvullende configuratieparameters behalve het inschakelen ervan.

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"},
                    }
                },
            },
        ),
    ),
)