Wixzel Voice से अपनी वेबसाइट पर बोलने वाला AI मैस्कट लगाएँ

शुरू करने से पहले आपको क्या चाहिए?

• क्रेडिट वाला Wixzel Voice अकाउंट। विजेट से होने वाली कॉल असली क्रेडिट से चुकाई जाती हैं, फ़्री टेस्ट मिनट से नहीं; न्यूनतम रिचार्ज $5 है।
• एक API की, जिसमें agents:write और calls:write स्कोप हों, और जो आपके सर्वर पर रहे। नीचे का सब कुछ कंसोल में भी किया जा सकता है, एजेंट के मैस्कट टैब पर।
• HTTPS पर चलने वाली एक वेबसाइट, जिसमें आप script टैग जोड़ सकें। ब्राउज़र पेज को माइक्रोफ़ोन सिर्फ़ HTTPS पर देते हैं।

इसे Wixzel Voice पर स्टेप-बाय-स्टेप कैसे बनाएँ?

1. 01अपनी वेबसाइट से एजेंट बनाएँ

   इसे अपनी साइट और एक भूमिका दें। role receptionist, support, sales, guide या आपके अपने शब्द हो सकते हैं:

   shellकॉपी करें

   curl https://api.voice.wixzel.com/v1/agents/generate \
     -H "Authorization: Bearer $WIXZEL_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{ "website_url": "https://smiledental.example", "role": "receptionist" }'

   make-agent.mjs (TypeScript SDK)कॉपी करें

   import { WixzelVoice, waitForAgent } from 'wixzel-voice';
   
   const client = new WixzelVoice({ apiKey: process.env.WIXZEL_API_KEY });
   
   let agent = await client.agents.generate({
     website_url: 'https://smiledental.example',
     role: 'receptionist',
   });
   agent = await waitForAgent(client.agents, agent); // until the mascot is ready or failed
   console.log(agent.id, agent.name, agent.mascot.status, agent.knowledge_base_id);

   यह तुरंत एक ऐसा एजेंट लौटाता है जो पहले से बात कर सकता है, और साथ में mascot.status: "building"। बैकग्राउंड में यह आपके पेज पढ़ता है, निर्देश और शुरुआती लाइन लिखता है, जो पढ़ा उससे एक नॉलेज बेस बनाता है, और आपके ब्रांड के रंग में एक मैस्कट बनाता है। mascot.status के ready होने तक GET /v1/agents/{id} पोल करें, आमतौर पर एक मिनट से कम लगता है; SDK में waitForAgent पोलिंग करता है। बिल्ड फ़ेल होने पर भी एजेंट अपने पुराने रूप के साथ काम करता रहता है।

   एजेंट Gemini Live पर शुरू होता है। किसी भी दूसरे एजेंट की तरह PATCH /v1/agents/{id} से उसका इंजन, आवाज़ या निर्देश बदलें; उसका मैस्कट वैसा ही रहता है।

2. 02विजेट चालू करें, और तय करें कि कौन कॉल कर सकता है

   जब तक आप चालू न करें, शेयरिंग बंद रहती है। जिन origins से आपकी साइट चलती है उनकी लिस्ट दें; विजेट कहीं और कॉल शुरू नहीं करेगा:

   shellकॉपी करें

   curl -X PATCH https://api.voice.wixzel.com/v1/agents/AGENT_ID/mascot \
     -H "Authorization: Bearer $WIXZEL_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "welcome_message": "Hi! I am Molly from Smile Dental. Tap Call to talk to me.",
       "sharing": {
         "embed": true,
         "embed_origins": ["https://smiledental.example", "https://www.smiledental.example"],
         "caller_info": "contact",
         "max_call_seconds": 300,
         "daily_minutes": 60,
         "calls_per_visitor_daily": 3,
         "max_concurrent_calls": 2
       }
     }'

   caller_info वह जानकारी है जो विज़िटर कॉल से पहले देता है: none (डिफ़ॉल्ट) कुछ नहीं माँगता, contact नाम और फ़ोन नंबर या ईमेल माँगता है, और google Google साइन-इन माँगता है। Google साइन-इन से आपको पता चलता है कि वे कौन हैं, और इससे उनके लिए कभी Wixzel अकाउंट नहीं बनता; आपकी साइट पर यह voice.wixzel.com पर एक छोटी विंडो में खुलता है, जो नतीजा सिर्फ़ embed_origins में दिए किसी origin को ही वापस देती है।

   चार सीमाएँ सार्वजनिक कॉल को बजट के भीतर रखती हैं: सबसे लंबी कॉल, सबके लिए मिलाकर रोज़ के सार्वजनिक मिनट (UTC आधी रात तक), एक विज़िटर रोज़ कितनी कॉल कर सकता है, और एक साथ कितनी कॉल। ऊपर की वैल्यू डिफ़ॉल्ट हैं। साथ में voice.wixzel.com/m?id=… पर एक शेयर पेज पाने के लिए "link": true जोड़ें।

   रिस्पॉन्स में mascot.public_id होता है, जैसे m_4fT9qLx2Bv8K। script टैग में यही id जाती है।

3. 03एक script टैग पेस्ट करें

   जिस भी पेज पर मैस्कट दिखना चाहिए, वहाँ इसे closing body टैग से पहले जोड़ें:

   index.htmlकॉपी करें

   <script src="https://voice.wixzel.com/embed.js" data-mascot="m_4fT9qLx2Bv8K" async></script>

   मैस्कट अपने स्वागत संदेश के साथ नीचे दाएँ कोने में इंतज़ार करता है। विज़िटर Call बटन पर टैप करता है, माइक्रोफ़ोन की अनुमति देता है और बात करता है; मैस्कट सुनता है, सोचता है और एजेंट की आवाज़ के साथ मुँह हिलाता है। विजेट एक shadow root में चलता है, इसलिए आपकी CSS और उसकी CSS कभी आपस में नहीं टकरातीं।

4. 04इसे अपनी जगह पर लगाएँ, और एजेंट को अपने पेज पर काम करने दें

   इसे कोने के बजाय अपने किसी element के अंदर दिखाने के लिए, टैग से data-mascot हटा दें और script लोड होने के बाद WixzelMascot.mount कॉल करें।

   क्लाइंट टूल आपके पेज पर तब चलता है जब एजेंट उसे माँगता है, जैसे बुकिंग पेज खोलना। एजेंट के लिए टूल कंसोल में या POST /v1/tools से बनाएँ, फिर script लोड होने से पहले या बाद में रजिस्टर करें कि वह क्या करता है:

   index.htmlकॉपी करें

   <div id="talk"></div>
   <script>
     window.WixzelMascot = Object.assign(window.WixzelMascot || {}, {
       tools: {
         open_page: ({ path }) => {
           location.href = path;
           return { opened: path };
         },
       },
     });
   </script>
   <script
     src="https://voice.wixzel.com/embed.js"
     async
     onload="WixzelMascot.mount(document.getElementById('talk'), { mascot: 'm_4fT9qLx2Bv8K' })"
   ></script>

   हैंडलर जो भी लौटाता है, वह एजेंट को वापस जाता है, जो कॉलर को बताता है। Webhook टूल, जो आपके सर्वर को कॉल करते हैं, विजेट पर भी काम करते हैं।

5. 05देखें किसने कॉल किया, और किसी को ब्लॉक करें

   विजेट से होने वाली हर कॉल अपने कॉलर को रिकॉर्ड करती है। किसी एजेंट के कॉलर की लिस्ट देखें:

   shellकॉपी करें

   curl "https://api.voice.wixzel.com/v1/callers?agent_id=AGENT_ID&limit=20" \
     -H "Authorization: Bearer $WIXZEL_API_KEY"
   
   curl -X PATCH https://api.voice.wixzel.com/v1/callers/CALLER_ID \
     -H "Authorization: Bearer $WIXZEL_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{ "blocked": true }'

   हर कॉलर के साथ अनुमानित location (शहर, क्षेत्र और देश, IP पते से निकाला गया, जिसे सिर्फ़ hash के रूप में रखा जाता है), platform (ब्राउज़र, ऑपरेटिंग सिस्टम और डिवाइस), जिस page_url से कॉल किया गया, कॉलर ने आपको जो जानकारी दी, और call_count होता है। कॉलर के ब्राउज़र में रखी एक रैंडम id एक व्यक्ति की कॉल को एक साथ जोड़ती है; कोई fingerprinting नहीं होती, और विजेट कॉलर को बताता है कि आपके साथ क्या शेयर होता है।

   ब्लॉक किया गया कॉलर उस एजेंट को विजेट, शेयर लिंक, ऐप या फ़ोन से दोबारा कॉल नहीं कर सकता। हर कॉल ट्रांसक्रिप्ट और खर्च के साथ GET /v1/calls में भी है, जिसे caller_id से फ़िल्टर किया जा सकता है।

Wixzel Voice पर इस बिल्ड की लागत कितनी है?

इस बिल्ड पर Wixzel Voice की कौन-सी सीमाएँ लागू होती हैं?

• ऑडियो फ़ोन जैसा है, दोनों दिशाओं में 8 kHz पर G.711 µ-law।
• विजेट सिर्फ़ embed_origins में दिए origins से कॉल शुरू करता है, जो 20 तक हो सकते हैं।
• सार्वजनिक कॉल एजेंट पर तय सीमाओं के भीतर रहती हैं। daily_minutes पार होने के बाद UTC आधी रात तक कॉल रिजेक्ट होती हैं।
• विजेट कॉल फ़ोन कॉल और ऐप सेशन के साथ अकाउंट की एक साथ चलने वाली कॉल की सीमा में गिनी जाती हैं, जो डिफ़ॉल्ट रूप से पाँच है। max_concurrent_calls किसी व्यस्त पेज को सारी कॉल लेने से रोकता है।
• विजेट कॉल असली क्रेडिट इस्तेमाल करती हैं। फ़्री टेस्ट मिनट कंसोल से अपने एजेंट से बात करने के लिए हैं।
• वेब कॉल से किसी व्यक्ति तक ट्रांसफ़र नहीं होता; ट्रांसफ़र के लिए फ़ोन लाइन चाहिए।