Wixzel Voice के साथ Node.js में Twilio AI रिसेप्शनिस्ट बनाएँ

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

• Elastic SIP Trunking वाला Twilio अकाउंट, और एक Twilio फ़ोन नंबर।
• Wixzel Voice API की (wv_live_…) और अकाउंट पर क्रेडिट। न्यूनतम रिचार्ज $5 है।
• Node.js 20 या उसके बाद का वर्शन।

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

1. 01Twilio पर Elastic SIP ट्रंक बनाएँ

   Twilio कंसोल में Elastic SIP Trunking खोलें और एक ट्रंक बनाएँ। Termination में एक Termination SIP URI चुनें, जैसे your-clinic.pstn.twilio.com। यही hostname उस ट्रंक का host है जिसे आप अगले स्टेप में कनेक्ट करेंगे।

   Twilio कंसोल खुला रखें। API से दो पते मिलने के बाद आपको उन्हें भरने के लिए यहाँ वापस आना है।

2. 02SDK इंस्टॉल करें और ट्रंक कनेक्ट करें

   SDK इंस्टॉल करें और अपनी API की एनवायरनमेंट में रखें:

   shellकॉपी करें

   npm install wixzel-voice
   export WIXZEL_API_KEY="wv_live_..."

   trunk.mjsकॉपी करें

   import { WixzelVoice } from 'wixzel-voice';
   
   const client = new WixzelVoice({ apiKey: process.env.WIXZEL_API_KEY });
   
   const trunk = await client.sipTrunks.create({
     name: 'Twilio',
     host: 'your-clinic.pstn.twilio.com', // your Termination SIP URI
     port: 5060,
     transport: 'udp',
   });
   
   console.log('TRUNK_ID', trunk.id);
   console.log('Allowlist at Twilio:', trunk.platform_ip);
   console.log('Origination URI:', trunk.origination_uri);

   यहाँ कोई username या password नहीं है, क्योंकि Twilio सोर्स IP से ऑथराइज़ करता है, जो अगला स्टेप है। इसके बजाय Twilio Credential List इस्तेमाल करने के लिए उसका username और password दें। पासवर्ड एन्क्रिप्ट करके रखा जाता है और API उसे फिर कभी नहीं लौटाता।

3. 03Twilio को Wixzel Voice की ओर पॉइंट करें, दोनों दिशाओं में

   Twilio आउटगोइंग और इनकमिंग को अलग-अलग कॉन्फ़िगर करता है, और कोई भी हिस्सा छूट जाए तो वह बिना कुछ बताए फ़ेल होता है।

   Termination में, फिर Authentication में, ऊपर प्रिंट हुआ platform_ip एक IP Access Control List में जोड़ें। इसके बिना Twilio लगभग एक सेकंड में hangup cause 21 के साथ कॉल रिजेक्ट कर देता है।

   Origination में एक Origination SIP URI जोड़ें, जो ऊपर प्रिंट हुए origination_uri पर सेट हो। इसके बिना आपका नंबर कभी एजेंट तक नहीं पहुँचता और किसी भी लॉग में कुछ नहीं दिखता, क्योंकि कॉल Twilio से बाहर ही नहीं निकलती।

   आखिर में, Numbers में अपना Twilio नंबर इस ट्रंक से जोड़ें।

4. 04रिसेप्शनिस्ट बनाएँ

   एजेंट यानी निर्देश (prompt), एक शुरुआती लाइन और एक वॉइस इंजन। appointment_booking_enabled उसे कॉल के दौरान अपॉइंटमेंट देखने, बुक करने और कैंसल करने देता है; निर्देश उसे बताते हैं कि वह कौन-से दिन, घंटे और कितनी लंबाई के स्लॉट ऑफ़र कर सकता है।

   agent.mjsकॉपी करें

   import { WixzelVoice } from 'wixzel-voice';
   
   const client = new WixzelVoice({ apiKey: process.env.WIXZEL_API_KEY });
   
   const agent = await client.agents.create({
     name: 'Reception',
     system_prompt: [
       'You are the receptionist for Riverside Dental, answering the phone.',
       'Keep every reply to one or two short sentences, and never read out lists.',
       'You can book, move and cancel check-ups and cleanings.',
       'Offer appointments Monday to Friday, 09:00 to 17:00, 30 minutes each.',
       'Before booking, ask for the full name of the caller and repeat the day and time back.',
       'For a dental emergency, tell the caller to hang up and ring the emergency number.',
       'If you cannot help, take a message and promise a callback.',
     ].join('\n'),
     opening_message: 'Riverside Dental, this is the automated assistant. How can I help?',
     appointment_booking_enabled: true,
     voice: {
       stt: { model: 'deepgram/nova-3', language: 'en-US' },
       llm: { model: 'openrouter/gpt-4o-mini' },
       tts: { model: 'elevenlabs/eleven_flash_v2_5' },
     },
   });
   
   console.log('AGENT_ID', agent.id);

   यह classic इंजन है: Deepgram Nova-3, GPT-4o-mini और ElevenLabs Flash v2.5, अंग्रेज़ी के लिए सबसे सस्ती भरोसेमंद जोड़ी, $0.0867 प्रति मिनट। बोलने वाली आवाज़ चुनने के लिए tts ब्लॉक में एक voice जोड़ें; client.engines.voices('classic') बताता है कि यह कौन-सी आवाज़ें इस्तेमाल कर सकता है।

   शुरुआती लाइन बताती है कि कॉलर एक ऑटोमेटेड असिस्टेंट से बात कर रहा है। जहाँ कानून इसकी, या कॉल रिकॉर्ड होने की सूचना की, माँग करता है, वहाँ इसकी सही जगह शुरुआती लाइन ही है।

5. 05अपना नंबर रिसेप्शनिस्ट तक रूट करें

   नंबर को ट्रंक पर रजिस्टर करें, और उस एजेंट को सेट करें जो इसका जवाब देगा:

   number.mjsकॉपी करें

   import { WixzelVoice } from 'wixzel-voice';
   
   const client = new WixzelVoice({ apiKey: process.env.WIXZEL_API_KEY });
   
   const number = await client.phoneNumbers.create({
     phone_number: '+14155550100', // your Twilio number, in E.164
     sip_trunk_id: process.env.TRUNK_ID,
     inbound_agent_id: process.env.AGENT_ID,
   });
   
   console.log('NUMBER_ID', number.id);

   जिस नंबर पर inbound_agent_id नहीं है, उस पर आने वाली कॉल रिजेक्ट हो जाती हैं। उसी एजेंट से कॉल भी करवाने के लिए, जैसे रिमाइंडर या टेस्ट कॉल, client.agents.update(agentId, { outbound_phone_number_id: number.id }) से इस नंबर को उसका कॉलर ID बनाएँ।

6. 06कॉल करें, फिर कॉल और बुकिंग पढ़ें

   किसी मोबाइल से अपने Twilio नंबर पर कॉल करें और एक स्लॉट बुक करें। फ़ोन रखते ही कॉल और अपॉइंटमेंट दोनों API में होते हैं:

   results.mjsकॉपी करें

   import { WixzelVoice } from 'wixzel-voice';
   
   const client = new WixzelVoice({ apiKey: process.env.WIXZEL_API_KEY });
   
   // Lists are newest first.
   const calls = await client.calls.list({ direction: 'inbound', limit: 1 });
   const latest = calls.data[0];
   if (latest) {
     const call = await client.calls.retrieve(latest.id);
     console.log(call.status, call.duration_seconds + 's', (call.cost_micros ?? 0) / 1e6, 'USD');
     for (const line of call.transcript) console.log(line.role + ': ' + line.content);
   }
   
   const appointments = await client.appointments.list({ limit: 5 });
   for (const a of appointments.data) {
     console.log(a.date_time, a.client_name, a.phone_number, a.status);
   }

   date_time हमेशा UTC में होता है। हर बुकिंग पर appointmentBooked webhook भी चलता है, जिससे आप बुकिंग होते ही उसे अपने कैलेंडर में कॉपी कर सकते हैं।

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

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

• रिसेप्शनिस्ट आपके कामकाज के घंटे अपने निर्देशों से जानता है। v1 API में availability endpoint नहीं है, इसलिए वह आपका असली कैलेंडर नहीं देख सकता: API से पहले से बुक किया गया समय रिजेक्ट होता है, लेकिन जो अपॉइंटमेंट आप कहीं और रखते हैं वे उसे नहीं दिखते।
• बुकिंग अकाउंट के टाइम ज़ोन में पढ़ी जाती हैं, जो बदला न गया हो तो UTC है, और v1 API अभी इसे बदल नहीं सकता। भरोसा करने से पहले अपनी पहली बुकिंग का date_time जाँचें, और अगर आपका बिज़नेस UTC पर नहीं है तो aqeel@wixzel.com पर लिखें।
• डिफ़ॉल्ट रूप से एक अकाउंट पर एक साथ पाँच कॉल लाइव हो सकती हैं। किसी कॉल के खत्म होने तक आगे की कॉल रिजेक्ट होती हैं, और माँगने पर यह सीमा बढ़ाई जाती है।
• आपका नंबर Twilio पर ही रहता है। Wixzel Voice नंबर न बेचता है, न पोर्ट करता है, न रखता है।
• Wixzel Voice के व्यवहार में बदलाव तारीख वाले Wixzel-Version हेडर के पीछे आते हैं।