Wixzel Voice के साथ AI लीड-क्वालिफ़िकेशन कैंपेन चलाएँ

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

• एक SIP ट्रंक और उस पर रजिस्टर किया हुआ आउटगोइंग नंबर। Twilio गाइड और SIP ट्रंक docs दोनों बताते हैं।
• क्रेडिट वाली Wixzel Voice API की, और npm install wixzel-voice के साथ Node.js 20 या बाद का वर्शन।
• लिस्ट की हर लीड को कॉल करने की सहमति, जहाँ कानून इसकी माँग करता है। नीचे का नियमों वाला स्टेप बताता है कि स्वीकार्य उपयोग नीति (Acceptable Use Policy) क्या माँगती है।

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

1. 01कॉल करने वाला एजेंट लिखें

   एजेंट ही स्क्रिप्ट है। मर्ज फ़ील्ड हर कॉल को व्यक्तिगत बनाते हैं:

   agent.mjsकॉपी करें

   import { WixzelVoice } from 'wixzel-voice';
   
   const client = new WixzelVoice({ apiKey: process.env.WIXZEL_API_KEY });
   
   const agent = await client.agents.create({
     name: 'Demo follow-up',
     outbound_phone_number_id: process.env.NUMBER_ID,
     system_prompt: [
       'You are calling {{name}} from {{company}}, who asked for a demo of Acme Scheduling.',
       'Ask three questions, one at a time: how many staff take bookings,',
       'what they use for bookings today, and when they would want to switch.',
       'Keep replies short. If they are not interested, thank them and end the call.',
       'If they ask not to be called again, confirm that you have noted it and end the call.',
       'Finish by thanking them and saying a person will follow up by email.',
     ].join('\n'),
     opening_message: 'Hi {{name}}, this is an automated assistant calling for Acme about the demo you requested. Is now a good time?',
     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);

   {{name}} लीड से भरता है, और लीड के fields की हर key भी एक मर्ज फ़ील्ड बन जाती है, इसलिए {{company}} नीचे के अपलोड से आता है। शुरुआती लाइन बताती है कि कॉल करने वाला ऑटोमेटेड है; जहाँ कानून यह बताना ज़रूरी करता है, वहाँ इसकी सही जगह यही है। कैंपेन के लिए outbound_phone_number_id ज़रूरी है: यही वह कॉलर ID है जो हर कॉल पर दिखता है।

2. 02लीड अपलोड करें

   बाकी बिल्ड एक ही स्क्रिप्ट, campaign.mjs, है। यह अपलोड से शुरू होती है:

   campaign.mjs, part 1कॉपी करें

   import { WixzelVoice } from 'wixzel-voice';
   
   const client = new WixzelVoice({ apiKey: process.env.WIXZEL_API_KEY });
   
   // From your CRM or a CSV: only people you have consent to call.
   const rows = [
     { name: 'Priya Nair', phone_number: '+14155550111', fields: { company: 'Northside Physio' } },
     { name: 'Sam Carter', phone_number: '+14155550112', fields: { company: 'Carter Auto' } },
   ];
   
   const upload = await client.leads.bulkCreate({ leads: rows });
   console.log('created', upload.created_count, 'failed', upload.failed_count);
   for (const e of upload.errors) console.log('row', e.index, e.phone_number, e.error);
   
   const leadIds = upload.data.map((lead) => lead.id);

   एक रिक्वेस्ट में 1,000 तक लीड जा सकती हैं। हर पंक्ति अलग से जाँची जाती है, इसलिए यह मानने के बजाय कि पूरी लिस्ट पहुँच गई, failed_count और errors देखें। बल्क अपलोड पर कोई webhook नहीं चलता।

3. 03एक साथ चलने वाली कॉल की सीमा के हिसाब से कैंपेन चलाएँ

   एक कैंपेन यानी एक एजेंट और लीड की एक लिस्ट। कैंपेन बनाने से कोई डायल नहीं होता; start से होता है, और हर कॉल कनेक्ट होने पर क्रेडिट खर्च होता है।

   अभी कैंपेन अपनी कॉल कतार में रखने के बजाय तेज़ी से एक के बाद एक करता है, और हर कॉल अकाउंट की एक साथ चलने वाली कॉल की सीमा में गिनी जाती है, जो डिफ़ॉल्ट रूप से पाँच है। सीमा से ऊपर की लीड अपनी बारी का इंतज़ार करने के बजाय फ़ेल कॉल के रूप में दर्ज होती है। इसलिए लिस्ट को ऐसे बैच में चलाएँ जो आपकी सीमा से बड़े न हों, और पिछला बैच खत्म होने पर अगला शुरू करें:

   campaign.mjs, part 2कॉपी करें

   const LIMIT = 5; // your account's concurrent-call limit, minus any calls you expect meanwhile
   const DONE = new Set(['completed', 'failed', 'busy', 'no-answer', 'canceled']);
   const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
   
   async function finishedCalls(campaignId) {
     let finished = 0;
     for await (const call of await client.calls.list({ campaign_id: campaignId, limit: 100 })) {
       if (DONE.has(call.status)) finished++;
     }
     return finished;
   }
   
   const campaignIds = [];
   for (let i = 0; i < leadIds.length; i += LIMIT) {
     const batch = leadIds.slice(i, i + LIMIT);
     const campaign = await client.campaigns.create({
       name: 'Demo follow-up ' + (i / LIMIT + 1),
       agent_id: process.env.AGENT_ID,
       lead_ids: batch,
     });
     await client.campaigns.start(campaign.id);
     campaignIds.push(campaign.id);
   
     const giveUpAt = Date.now() + 30 * 60 * 1000;
     while ((await finishedCalls(campaign.id)) < batch.length && Date.now() < giveUpAt) {
       await sleep(15000);
     }
   }

   start कैंपेन को status: "running" के साथ लौटाता है। किसी बैच को जल्दी रोकने के लिए client.campaigns.pause(campaign.id) उसे रोकता है और चल रही कॉल काट देता है, जिसके बाद कैंपेन status: "stopped" दिखाता है। रुके हुए कैंपेन को फिर से शुरू करने पर उसकी हर लीड दोबारा डायल होती है, जिन्हें पहले कॉल हो चुकी है वे भी, इसलिए आगे बढ़ने के लिए उन लीड से नया कैंपेन बनाएँ जिन तक अभी नहीं पहुँचे। create पर scheduled_at देने से कैंपेन start के बजाय तय समय पर शुरू होता है।

4. 04हर कॉल वापस पढ़ें

   हर कॉल एक रिकॉर्ड है, जिसमें स्टेटस, खर्च और ट्रांसक्रिप्ट है, और lead_id से अपनी लीड से जुड़ा है:

   campaign.mjs, part 3कॉपी करें

   for (const campaignId of campaignIds) {
     for await (const call of await client.calls.list({ campaign_id: campaignId, limit: 100 })) {
       const detail = await client.calls.retrieve(call.id);
       const answers = detail.transcript
         .filter((line) => line.role === 'user')
         .map((line) => line.content)
         .join(' / ');
       console.log(call.lead_id, call.status, call.duration_seconds, call.failure_code, answers);
     }
   }

   status बताता है कि कॉल कनेक्ट हुई या नहीं, failure_code बताता है कि क्यों नहीं हुई (17 बिज़ी, 19 जवाब नहीं मिला, 21 कैरियर ने रिजेक्ट किया) और cost_micros बताता है कि खर्च कितना हुआ। जो लीड डायल होने से पहले ही रिजेक्ट हुई, एक साथ चलने वाली कॉल की सीमा या क्रेडिट की कमी की वजह से, वह बिना failure_code के failed दिखती है।

   क्वालिफ़िकेशन का फ़ैसला आपका है। Wixzel Voice बातचीत रिकॉर्ड करता है; ट्रांसक्रिप्ट में आपके तीनों सवालों के जवाब होते हैं, इसलिए उसे अपने नियमों या अपने मॉडल से स्कोर करें और नतीजा अपने CRM में लिखें। summary फ़ील्ड खाली हो सकती है, इसलिए उस पर निर्भर न रहें। पोलिंग के बजाय कॉल खत्म होते ही प्रतिक्रिया देने के लिए callCompleted webhook सब्सक्राइब करें, जिसमें कॉल के स्टेटस और अवधि के साथ लीड और कैंपेन की ids होती हैं।

5. 05कॉलिंग के नियमों के भीतर रहें

   स्वीकार्य उपयोग नीति ये ज़िम्मेदारियाँ कॉल करने वाले पर डालती है, यानी आप पर। यह उसका सारांश है, कानूनी सलाह नहीं।

   सिर्फ़ उन लोगों को कॉल करें जिनकी सहमति आपके पास है, जहाँ कानून इसकी माँग करता है। अमेरिका में इसका आम तौर पर मतलब है TCPA के तहत मोबाइल नंबरों पर मार्केटिंग कॉल के लिए पहले से ली गई स्पष्ट लिखित सहमति; भारत में TRAI के customer preference नियम; UK और EU में PECR और GDPR।

   हर अपलोड से पहले राष्ट्रीय और राज्य स्तर की do-not-call रजिस्ट्री और अपनी suppression list जाँचें। जब कोई दोबारा कॉल न करने को कहे, तो उसे तुरंत और हमेशा के लिए हटा दें: एजेंट विनम्रता से कॉल खत्म कर सकता है, लेकिन लीड हटाना आपके कोड का काम है।

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

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

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

• कैंपेन अपनी लीड को तेज़ी से एक के बाद एक डायल करता है और एक साथ चलने वाली कॉल की सीमा (डिफ़ॉल्ट रूप से हर अकाउंट पर पाँच) के पीछे कतार नहीं लगाता; उससे ऊपर की लीड फ़ेल दर्ज होती हैं। अपनी सीमा के हिसाब से बैच बनाएँ, या ज़्यादा सीमा माँगें।
• रुके हुए कैंपेन को फिर से शुरू करने पर उसकी हर लीड दोबारा डायल होती है। जिन लीड तक अभी नहीं पहुँचे, उनसे नया कैंपेन बनाकर आगे बढ़ें।
• हर कैंपेन में 10,000 तक लीड हो सकती हैं, और एक अकाउंट में डिफ़ॉल्ट रूप से 500 तक कैंपेन, जो माँगने पर बढ़ाए जाते हैं।
• Wixzel Voice कॉल और उसका ट्रांसक्रिप्ट रिकॉर्ड करता है। कौन क्वालिफ़ाई हुआ यह तय करना, और अपनी do-not-call लिस्ट रखना, आपके कोड का काम है।
• Wixzel Voice के व्यवहार में बदलाव तारीख वाले Wixzel-Version हेडर के पीछे आते हैं।