> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# कीपैड टच टोन चलाएं

## खास जानकारी

कीपैड टच टोन टूल ElevenLabs एजेंट्स को फोन कॉल के दौरान DTMF (ड्यूल-टोन मल्टी-फ्रीक्वेंसी) टोन चलाने देता है; ये वे टोन हैं जो आपके कीपैड पर नंबर दबाने पर बजते हैं। इससे एजेंट्स ऑटोमेटेड फोन सिस्टम्स के साथ इंटरैक्ट कर सकते हैं, वॉइस मेनू नेविगेट कर सकते हैं, एक्सटेंशन दर्ज कर सकते हैं, PIN कोड इनपुट कर सकते हैं और ऐसे अन्य टच-टोन ऑपरेशन कर सकते हैं जिनके लिए आम तौर पर किसी व्यक्ति को अपने फोन कीपैड पर कुंजियां दबानी पड़ती हैं।

यह सिस्टम टूल मानक DTMF टोन (0-9, \*, #) के साथ-साथ समय नियंत्रित करने के लिए पॉज़ कमांड्स भी सपोर्ट करता है। यह Twilio और SIP ट्रंकिंग, दोनों फोन इंटीग्रेशंस के साथ सहजता से काम करता है और टेलीफोनी इन्फ्रास्ट्रक्चर के लिए अपने-आप उपयुक्त ऑडियो टोन जनरेट करता है।

कॉलर्स से कीपैड अंक लेने के लिए, [DTMF इनपुट](/docs/hi/eleven-agents/customization/multimodal-input#dtmf-input) देखें।

## कार्यप्रणाली

* **मानक DTMF टोन**: सभी मानक कीपैड कैरेक्टर्स (0-9, \*, #) सपोर्ट करता है
* **पॉज़ नियंत्रण**: सटीक टाइमिंग के लिए पॉज़ कमांड्स शामिल हैं (w = 0.5s, W = 1.0s)
* **मल्टी-प्रोवाइडर सपोर्ट**: Twilio और SIP ट्रंकिंग, दोनों इंटीग्रेशंस के साथ काम करता है

इस सिस्टम टूल का इस्तेमाल फोन मेनू नेविगेट करने, एक्सटेंशन दर्ज करने और कोड इनपुट करने के लिए किया जा सकता है।
LLM बातचीत के संदर्भ के आधार पर तय करता है कि कब और कौन-से टोन चलाने हैं।

डिफ़ॉल्ट टूल विवरण बातचीत संचालित करने वाले LLM को बताता है कि उसके पास ये टोन चलाने की सुविधा है,
और हम आपके एजेंट के सिस्टम प्रॉम्प्ट को अपडेट करके यह बताने की सलाह देते हैं कि एजेंट को यह टूल कब कॉल करना चाहिए।

**पैरामीटर्स**:

* `reason` (string, वैकल्पिक): DTMF टोन चलाने का कारण (जैसे, "एक्सटेंशन पर जाना", "PIN दर्ज करना")
* `dtmf_tones` (string, आवश्यक): चलाने के लिए DTMF सीक्वेंस। मान्य कैरेक्टर: 0-9, \*, #, w (0.5s का पॉज़), W (1s का पॉज़)

**फ़ंक्शन कॉल फ़ॉर्मैट**:

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

## आउट-ऑफ़-बैंड DTMF

डिफ़ॉल्ट रूप से, DTMF टोन वॉइस स्ट्रीम में इन-बैंड ऑडियो सिग्नल के रूप में भेजे जाते हैं। हालांकि, कुछ IVR (इंटरैक्टिव वॉइस रिस्पॉन्स) सिस्टम ऑडियो कंप्रेशन, नेटवर्क स्थितियों या सिस्टम कॉन्फ़िगरेशन की वजह से इन इन-बैंड टोन्स को विश्वसनीय रूप से पहचान नहीं पाते।

आउट-ऑफ़-बैंड DTMF (RFC 4733), टोन को ऑडियो की जगह अलग RTP पैकेट्स के रूप में भेजता है। यह तरीका उन SIP ट्रंकिंग इम्प्लीमेंटेशंस के लिए ज़्यादा विश्वसनीय है जिनमें रिसीवर IVR सिस्टम्स मानक इन-बैंड DTMF पहचानने में मुश्किल महसूस करते हैं।

आउट-ऑफ़-बैंड DTMF चालू करने के लिए:

1. अपने एजेंट के टूल कॉन्फ़िगरेशन पर जाएं
2. **कीपैड टच टोन चलाएं** टूल चुनें
3. **आउट-ऑफ़-बैंड DTMF (RFC 4733) इस्तेमाल करें** चेकबॉक्स चुनें

> **Note**
>
> आउट-ऑफ़-बैंड DTMF केवल SIP ट्रंकिंग कॉल्स के लिए उपलब्ध है। Twilio
> Native इंटीग्रेशन कॉल्स के लिए इस सेटिंग को अनदेखा कर दिया जाएगा।

## समर्थित कैरेक्टर्स

टूल इन DTMF कैरेक्टर्स और कमांड्स को सपोर्ट करता है:

* **अंक**: `0`, `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`
* **विशेष टोन**: `*` (स्टार), `#` (पाउंड/हैश)
* **पॉज़ कमांड्स**:
  * `w` - छोटा पॉज़ (0.5 सेकंड)
  * `W` - लंबा पॉज़ (1.0 सेकंड)

## API इम्प्लीमेंटेशन

API के ज़रिए एजेंट बनाते या अपडेट करते समय, आप `play_keypad_touch_tone` सिस्टम टूल कॉन्फ़िगर कर सकते हैं। इस टूल को चालू करने के अलावा किसी अतिरिक्त कॉन्फ़िगरेशन पैरामीटर की ज़रूरत नहीं है।

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

```javascript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient({
  apiKey: "YOUR_API_KEY",
});

await elevenlabs.conversationalAi.agents.create({
  conversationConfig: {
    agent: {
      firstMessage: "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.",
        builtInTools: {
          playKeypadTouchTone: {
            type: "system",
            name: "play_keypad_touch_tone",
            description: "Play DTMF tones to interact with automated phone systems.", // Optional custom description
            params: {
              systemToolType: "play_keypad_touch_tone",
            },
          },
        },
      },
    },
  },
});
```

> **Note**
>
> यह टूल केवल Twilio या SIP ट्रंकिंग से संचालित सक्रिय फोन कॉल्स के दौरान काम करता है। फोन बातचीत के संदर्भ के बाहर
> कॉल किए जाने पर यह एक त्रुटि लौटाएगा।