Vonage इंटीग्रेशन

WebSocket कनेक्टर का उपयोग करके ElevenAgents को Vonage वॉइस कॉल के साथ इंटीग्रेट करें।

परिचय

WebSocket कनेक्टर एप्लिकेशन का उपयोग करके 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

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

  • API Key: API कीज़ Developers पेज के API Keys टैब में मिलती हैं, जिसका लिंक साइडबार में है।
  • Agent ID: ElevenAgents डैशबोर्ड में एजेंट ढूंढें। एजेंट चुनने के बाद, सेटिंग्स बटन पर क्लिक करें और “Copy Agent ID” चुनें।
2

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

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

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

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

.env
ELEVENLABS_API_KEY = YOUR_API_KEY;
ELEVENLABS_AGENT_ID = YOUR_AGENT_ID;

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

3

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

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

ngrok http 6000

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

4

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

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

node elevenlabs-agent-ws-connector.cjs
5

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

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

  • सैंपल ऐप इस्तेमाल करें: PROCESSOR_SERVER को अपने कनेक्टर के होस्टनेम पर सेट करके सैंपल Vonage ऐप कॉन्फ़िगर करें।
  • मौजूदा ऐप अपडेट करें: कनेक्टर के WebSocket URI (wss://...) को टार्गेट करने वाला connect एक्शन शामिल करने के लिए अपना Nexmo Call Control Object बदलें, जिसमें content-type: audio/l16;rate=16000 हो। peer_uuid और webhook_url जैसे ज़रूरी क्वेरी पैरामीटर्स पास करें।
6

6. टेस्ट करें

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

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

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