> 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.

# Vonage इंटीग्रेशन

## परिचय

[WebSocket कनेक्टर एप्लिकेशन](https://github.com/nexmo-se/elevenlabs-agent-ws-connector) का उपयोग करके ElevenLabs Agents को Vonage Voice API या Video API कॉल से कनेक्ट करें। इससे PSTN कॉल, SIP ट्रंक्स और WebRTC क्लाइंट जैसे उपयोग के मामलों के लिए रीयल-टाइम, दो-तरफ़ा ऑडियो स्ट्रीमिंग सक्षम होती है।

## यह कैसे काम करता है

Node.js कनेक्टर Vonage और ElevenLabs को जोड़ता है:

1. Vonage एक सक्रिय कॉल के लिए कनेक्टर से WebSocket कनेक्शन शुरू करता है।
2. कनेक्टर ElevenLabs Agents एंडपॉइंट से WebSocket कनेक्शन स्थापित करता है।
3. ऑडियो रिले होता है: Vonage (L16) -> कनेक्टर -> ElevenLabs (base64) और इसके विपरीत।
4. कनेक्टर बातचीत के इवेंट्स (`user_transcript`, `agent_response`, `interruption`) मैनेज करता है।

## सेटअप

### 1. ElevenLabs क्रेडेंशियल्स पाएं

* **API Key**: API कीज़ [Developers पेज के API Keys टैब](https://elevenlabs.io/app/developers) में मिलती हैं, जिसका लिंक साइडबार में है।
* **Agent ID**: [ElevenAgents डैशबोर्ड](https://elevenlabs.io/app/agents/agents/) में एजेंट ढूंढें। एजेंट चुनने के बाद, सेटिंग्स बटन पर क्लिक करें और "Copy Agent ID" चुनें।

### 2. कनेक्टर कॉन्फ़िगर करें

रिपॉज़िटरी क्लोन करें और एनवायरनमेंट फ़ाइल सेट अप करें।

```bash
git clone https://github.com/nexmo-se/elevenlabs-agent-ws-connector.git
cd elevenlabs-agent-ws-connector
cp .env.example .env
```

अपनी क्रेडेंशियल्स को `.env` में जोड़ें:

**`.env`**

```bash title=".env"
ELEVENLABS_API_KEY = YOUR_API_KEY;
ELEVENLABS_AGENT_ID = YOUR_AGENT_ID;
```

डिपेंडेंसीज़ इंस्टॉल करें: `npm install`।

### 3. कनेक्टर एक्सपोज़ करें (लोकल डेवलपमेंट)

कनेक्टर के लिए एक पब्लिक URL बनाने हेतु ngrok या ऐसी ही किसी सर्विस का उपयोग करें (डिफ़ॉल्ट पोर्ट 6000)।

```bash
ngrok http 6000
```

पब्लिक `Forwarding` URL नोट करें (जैसे, `xxxxxxxx.ngrok-free.app`)। Vonage कॉन्फ़िगर करते समय \*\*`https://` शामिल न करें \*\*।

### 4. कनेक्टर चलाएं

एप्लिकेशन शुरू करें:

```bash
node elevenlabs-agent-ws-connector.cjs
```

### 5. Vonage वॉइस एप्लिकेशन कॉन्फ़िगर करें

आपके Vonage ऐप को कनेक्टर के WebSocket एंडपॉइंट (`wss://YOUR_CONNECTOR_HOSTNAME/socket`) से कनेक्ट होना चाहिए। यह चरण 3 का ngrok URL है।

* **सैंपल ऐप इस्तेमाल करें**: `PROCESSOR_SERVER` को अपने कनेक्टर के होस्टनेम पर सेट करके [सैंपल Vonage ऐप](https://github.com/nexmo-se/voice-to-ai-engines) कॉन्फ़िगर करें।
* **मौजूदा ऐप अपडेट करें**: कनेक्टर के WebSocket URI (`wss://...`) को टार्गेट करने वाला `connect` एक्शन शामिल करने के लिए अपना [Nexmo Call Control Object](https://developer.vonage.com/en/voice/voice-api/ncco-reference) बदलें, जिसमें `content-type: audio/l16;rate=16000` हो। `peer_uuid` और `webhook_url` जैसे ज़रूरी क्वेरी पैरामीटर्स पास करें।

### 6. टेस्ट करें

ElevenLabs एजेंट के साथ इंटरैक्ट करने के लिए अपने Vonage एप्लिकेशन से इनबाउंड या आउटबाउंड कॉल करें।

## क्लाउड डिप्लॉयमेंट

प्रोडक्शन के लिए, कनेक्टर को पब्लिक होस्टनेम वाले किसी स्थिर होस्टिंग प्रोवाइडर (जैसे, Vonage Cloud Runtime) पर डिप्लॉय करें।