अपने React ऐप में मिनटों में Santa वॉइस एजेंट जोड़ें
- प्रकाशित
सुनेंइस आर्टिकल को सुनें
इस छुट्टियों के मौसम में, अपने ऐप में सांता को जोड़ें।
ElevenLabs के Agents Platform और @elevenlabs/react SDK के साथ, आप सांता क्लॉज़ वॉइस एजेंट को कुछ ही मिनटों में अपने React ऐप में जोड़ सकते हैं। इस गाइड में हम:
- ElevenLabs डैशबोर्ड में सांता एजेंट बनाएं
- WebRTC का उपयोग करके उसे React कंपोनेंट में सेट अप करें
- एक आसान “Call Santa” बटन जोड़ें
1. साइन अप करें और Agents Platform खोलें
- साइन अप करें / लॉग इन करें ElevenLabs में।
- बाईं साइडबार में, सबसे ऊपर platform switcher खोलें।
- चुनें Agents Platform।
आपको “Build” सेक्शन के अंतर्गत Agents, Knowledge Base, Tools, और Voices वाली साइडबार दिखेगी।
2. अपना सांता एजेंट बनाएं
अब हम एक ऐसा एजेंट बनाएंगे जो सांता की तरह व्यवहार करे और सांता जैसी आवाज़ में बोले।
- साइडबार में Agents पर क्लिक करें।
- क्लिक करें + New Agent।
- चुनें Blank Agent और बिल्कुल शुरुआत से शुरू करें।
नाम रखें: Santa।
सिस्टम प्रॉम्प्ट
System Prompt फ़ील्ड में, यह पेस्ट करें:
पहला संदेश
First Message को यह सेट करें:
हो, हो, हो! मेरी दोस्त, आपको क्रिसमस की शुभकामनाएं। बताइए, आपका नाम क्या है?
कॉल शुरू होने पर यूज़र यही सुनेंगे।
आवाज़
Voice सेक्शन में:
- चुनें “Jerry B. – Santa Claus”
- वॉइस ID:
MDLAMJ0jxkpYkjXbmG4t
अब सांता की आवाज़ सच में सांता जैसी लगेगी।
सुरक्षा
इस उदाहरण के लिए, इसे खुला ही रखेंगे:
- Security में, यह पक्का करें कि Enable authentication बंद हो।
अपने पहले डेमो के लिए Enable Authentication को बंद रखना बिल्कुल ठीक है, ताकि कोई भी बिना किसी पाबंदी के एजेंट से कनेक्ट हो सके। इससे ऑनबोर्डिंग तेज़ होती है और यह क्विक प्रोटोटाइप, हैकाथॉन प्रोजेक्ट या इंटरनल शोकेस के लिए आदर्श है।
हालांकि, किसी भी प्रोडक्शन या बाहरी तौर पर उपलब्ध ऐप्लिकेशन के लिए, आपको अपने एजेंट को कभी भी खुला नहीं छोड़ना चाहिए। इसके बजाय, हर यूज़र सेशन के लिए सीमित अवधि और दायरे वाले एक्सेस टोकन जनरेट करने हेतु ElevenLabs Token Endpoint का इस्तेमाल करें। इससे आप पूरी तरह नियंत्रित कर सकते हैं कि कौन कनेक्ट कर सकता है, एक्सेस कितनी देर रहेगा और यूज़र कौन-से काम कर सकता है। ऑथेंटिकेशन चालू करने से आपका एजेंट अनधिकृत कॉल, दुरुपयोग या आपकी तय सीमाओं के बाहर इस्तेमाल से सुरक्षित रहता है — और लाइव होने से पहले इसकी पुरज़ोर सलाह दी जाती है।
3. अपना एजेंट ID लें
एजेंट पेज के सबसे ऊपर, आपको Agent ID फ़ील्ड दिखेगी।
इस वैल्यू को नोट कर लें — अगले चरण में हम इसे अपने React कंपोनेंट में पेस्ट करेंगे:
4. React SDK इंस्टॉल करें
अपने React / Next.js प्रोजेक्ट में ElevenLabs React SDK इंस्टॉल करें:
इसके बाद, हम वॉइस कॉल शुरू और बंद करने के लिए useConversation हुक का इस्तेमाल कर सकते हैं।
5. “Call Santa” बटन जोड़ें
एक नया कंपोनेंट बनाएं, जैसे CallSantaButton.tsx, और यह कोड पेस्ट करें:
अब बदलें "<AGENT_ID>" को डैशबोर्ड से कॉपी की गई असली Agent ID से।
फिर अपने UI में कहीं भी बटन रेंडर करें, उदाहरण के लिए:
6. आज़माएं
इसे अपने ब्राउज़र में खोलें और Start Call पर क्लिक करें:
- आपका ब्राउज़र माइक्रोफ़ोन की अनुमति मांगेगा।
- आपके सांता एजेंट के साथ एक WebRTC सेशन शुरू होगा।
- आप सुनेंगे:
“हो, हो, हो! मेरी दोस्त, आपको क्रिसमस की शुभकामनाएं। बताइए, आपका नाम क्या है?”
इसके बाद सांता आपका नाम, विशलिस्ट और इस साल आपने नाइस लिस्ट में बने रहने के लिए क्या किया है, इसके बारे में पूछेगा।
आगे क्या करें
बुनियादी सेटअप काम करने लगे, तो आप:
- सांता को ऑथ के पीछे सीमित कर सकते हैं एजेंट की Security सेटिंग्स का इस्तेमाल करके
- भाषाएं बदल सकते हैं यूज़र लोकेल पास करके और प्रॉम्प्ट को संभालने देकर
- UI को कस्टमाइज़ कर सकते हैं कस्टम बटन, ऐनिमेशन या पूरे “Call Santa” स्क्रीन के साथ
लेकिन मुख्य इंटीग्रेशन बस इतना है:
- एक एजेंट Agents Platform में
- एक
agentId - एक
useConversationहुक और एक बटन
अपने React ऐप में रियल-टाइम, बातचीत वाला सांता जादू लाने के लिए आपको बस इतना ही चाहिए।



