ई-कॉमर्स वॉइस एआई: एक ऑर्डर और डिलीवरी एजेंट बनाएं

एक ऐसा वॉयस AI एजेंट बनाएं जो ई-कॉमर्स ऑर्डर लेता है और डिलीवरी शेड्यूल करता है। Pulse, Electron, Lightning v3.1, और Shopify APIs का उपयोग करके स्टेप-बाय-स्टेप गाइड, जिसमें एंटिटी एक्सट्रैक्शन (entity extraction), वेबहुक्स (webhooks), और एस्केलेशन लॉजिक (escalation logic) शामिल हैं।
ई-कॉमर्स ऑर्डर लेने और डिलीवरी शेड्यूलिंग के लिए काम करने वाले वॉइस AI स्टैक में छह परतें (layers) होती हैं: एक टेलीफोनी चैनल, स्पीच-टू-टेक्स्ट, एक लैंग्वेज मॉडल जो टूल्स को कॉल कर सकता है, टेक्स्ट-टू-स्पीच, एक कॉमर्स या ऑर्डर मैनेजमेंट API, और एक वेबहुक लूप जो फुलफिलमेंट में होने वाले बदलावों को वापस एजेंट तक लाता है। यह गाइड कॉल के लिए Twilio या Vonage, वॉइस पाइपलाइन के लिए Smallest AI के Pulse, Electron और Lightning v3.1, और ऑर्डर सिस्टम के रूप में Shopify Admin API का उपयोग करके उस स्टैक को शुरू से अंत तक तैयार करती है। यही पैटर्न WooCommerce या किसी कस्टम OMS पर भी लागू होता है।
आप क्या बनाएंगे और यह गाइड किसके लिए है
अंत तक, आपके पास एक ऐसा फोन एजेंट होगा जो:
ऑर्डर नंबर को कैप्चर और सत्यापित (verify) कर सके।
डिलीवरी पते की पुष्टि या उसे अपडेट कर सके।
दो या तीन डिलीवरी विंडो की पेशकश कर सके और किसी एक की पुष्टि कर सके।
आपके OMS या कैरियर सिस्टम में शेड्यूल लिख सके।
फुलफिलमेंट इवेंट आने पर स्टेटस अपडेट भेज सके।
आगे बात जारी न रखने की स्थिति में, संदर्भ (context) के साथ कॉल किसी इंसानी एजेंट को सौंप सके।
यह गाइड ई-कॉमर्स और कॉन्टैक्ट सेंटर इंजीनियरिंग लीड्स, और एंटरप्राइज कॉन्टैक्ट सेंटर प्रबंधकों के लिए लिखी गई है जो यह आकलन कर रहे हैं कि उनके ऑर्डर और डिलीवरी कतारों (queues) के लिए वॉइस ऑटोमेशन व्यावहारिक है या नहीं।
आवश्यक शर्तें
एक फ़ोन नंबर और वॉइस चैनल (Twilio, Vonage, या समान) जो कॉल ऑडियो स्ट्रीम कर सके और स्टेटस कॉलबैक भेज सके।
Pulse (STT), Electron (LLM), और Lightning v3.1 (TTS) के लिए एक Smallest AI API की (key)।
आपके ऑर्डर डेटा तक पहुंच: एक Shopify Admin API टोकन, या आपके OMS और कैरियर APIs के लिए क्रेडेंशियल।
कॉल-स्टेट और फुलफिलमेंट वेबहुक्स के लिए एक सार्वजनिक HTTPS एंडपॉइंट।
Redis या Postgres जैसा सेशन स्टोर।
Node.js 18 या उसके बाद का संस्करण।
सफल मार्ग (Happy path) और तीन विफलता मार्ग (Failure paths)
सफल मार्ग यह है: कॉलर ऑर्डर नंबर देता है, वेरिफिकेशन पास करता है, एक नई विंडो का अनुरोध करता है, एक चुनता है, पुष्टि करता है, और सारांश सुनता है। शुरुआत से ही इन विफलता मार्गों के लिए डिज़ाइन तैयार रखें:
गायब या अमान्य ऑर्डर नंबर। लुकअप में कुछ नहीं मिलता, या ASR कॉन्फिडेंस कम है।
असमर्थित डिलीवरी विंडो। अनुरोधित तिथि छुट्टी का दिन है, कटऑफ समय के बाद की है, या कैरियर की क्षमता से बाहर है।
बैकएंड त्रुटि या संघर्ष। OMS 409, टाइमआउट, या 5xx एरर लौटाता है।
प्रत्येक परत (layer) के लिए उपकरण चुनें
Consio जैसे पैकेज्ड Shopify ऐप्स मानक फोन सपोर्ट को कवर करते हैं। इसकी ऐप स्टोर लिस्टिंग में एक फ्री प्लान, 100 मिनट के लिए $30/माह, और 400 मिनट के लिए $60/माह दिखाया गया है, जिसका बिल USD में बनता है। जिन टीमों को कस्टम डिलीवरी-विंडो लॉजिक, अपने खुद के OMS, या एस्केलेशन पर नियंत्रण की आवश्यकता होती है, वे आमतौर पर इसके बजाय एक वॉइस इंफ्रास्ट्रक्चर लेयर पर निर्माण करती हैं। विकल्पों की अधिक जानकारी के लिए, वॉइस एजेंट प्लेटफॉर्म्स की इस तुलना को देखें।
परत (Layer) | इस निर्माण में भूमिका | उपकरण |
|---|---|---|
टेलीफोनी | इनबाउंड कॉल, मीडिया स्ट्रीमिंग, कॉल स्टेटस कॉलबैक | |
STT | ट्रांसक्रिप्ट्स, टाइमस्टैम्प्स, VAD इवेंट्स, PII/PCI रिडक्शन स्ट्रीमिंग | Pulse (WS /waves/v1/stt/live) |
डायलॉग और टूल्स | एंटीटी एक्सट्रैक्शन, टूल कॉलिंग, JSON मोड | Electron (/v1/chat/completions) |
TTS | बोली जाने वाली पुष्टियाँ और संकेत (prompts) | Lightning v3.1 (POST /waves/v1/tts, WSS /waves/v1/tts/live) |
ऑर्डर सिस्टम | लुकअप्स, फुलफिलमेंट, ट्रैकिंग | Shopify Admin API या आपका OMS |
ऑर्केस्ट्रेशन | एजेंट बिल्डर, वर्जनिंग, डिप्लॉयमेंट, कॉल एनालिटिक्स, वेबहुक्स | Atoms |
Atoms, Smallest AI का वॉइस एजेंट प्लेटफॉर्म है। यह वर्जनिंग, फोन डिप्लॉयमेंट, ट्रांसक्रिप्ट व कॉल मॉनिटरिंग और वेबहुक्स के साथ एजेंट बिल्डर को कवर करता है। यदि आप अपना खुद का ऑर्केस्ट्रेशन नहीं चलाना चाहते हैं, तो आप इस गाइड में दिए गए फ्लो को वहां कॉन्फ़िगर कर सकते हैं और बैकएंड टूल एंडपॉइंट्स को समान रख सकते हैं।
चरण 1: आर्किटेक्चर का नक्शा बनाएं
कोड लिखने से पहले इसे ड्रा करें। हर तीर एक ऐसी जगह है जहाँ कुछ विफल हो सकता है।

जिम्मेदारियाँ:
ASR ट्रांसक्रिप्ट्स, टाइमस्टैम्प्स और कॉन्फिडेंस मान उत्पन्न करता है।
डायलॉग मैनेजर एंटिटीज को एक्सट्रैक्ट करता है और अगली टूल कॉल चुनता है।
टूल लेयर एकमात्र ऐसा कोड है जिसे OMS को छूने की अनुमति है। यह इनपुट्स को सत्यापित करता है और संरचित (structured) परिणाम लौटाता है।
वेबहुक हैंडलर हस्ताक्षरों (signatures) को सत्यापित करता है, डुप्लिकेट इवेंट्स को हटाता है, और सेशन स्टेट को अपडेट करता है।
एस्केलेशन सर्विस कॉल ट्रांसफर करती है और ट्रांसक्रिप्ट के साथ निकाले गए पैरामीटर्स को आपके CRM या टिकटिंग सिस्टम को पास करती है।
चेकपॉइंट: आप हर बॉक्स के ओनर का नाम बता सकते हैं और यह भी कि इसके टाइम आउट होने पर क्या होता है। कॉल आईडी (Twilio के लिए, CallSid) द्वारा की-कीकृत एक सेशन रिकॉर्ड स्टोर करें जिसमें सत्यापित ऑर्डर आईडी, एक्सट्रैक्टेड एंटिटीज और इडेम्पोटेंसी (idempotency) कीज शामिल हों। आपको इसकी आवश्यकता रीट्राइज (retries) और आउट-ऑफ-ऑर्डर इवेंट्स के लिए होगी।
यदि आप STT, LLM, और TTS चेन का कम-लेटेंसी वाला विकल्प चाहते हैं, तो Hydra, WSS /waves/v1/s2s पर एक फुल-डुप्लेक्स स्पीच-टू-स्पीच मॉडल है जिसमें बार्ज-इन (barge-in) इन-बिल्ट है। इस गाइड की पाइपलाइन आपको प्रत्येक टूल कॉल पर स्पष्ट नियंत्रण देती है, जो तब महत्वपूर्ण होता है जब कोई कॉल किसी ऑर्डर सिस्टम में लिख रही हो। ऑर्डर स्टेटस फ्लो कैसे जुड़े होते हैं, इसकी पृष्ठभूमि के लिए, ऑर्डर स्टेटस वॉइस फ्लो का यह अवलोकन देखें।
चरण 2: बातचीत की स्क्रिप्ट लिखें
प्रॉम्प्ट्स से पहले स्क्रिप्ट लिखें। प्रत्येक टर्न को एक ही काम करना चाहिए।
स्क्रिप्ट A: इनबाउंड ऑर्डर स्टेटस और डिलीवरी बदलाव
टर्न | एजेंट | बैकएंड एक्शन |
|---|---|---|
1 | "कॉल करने के लिए धन्यवाद। कृपया अपना ऑर्डर नंबर कहें, केवल अंक।" | कोई नहीं |
2 | "मैंने 1 0 4 2 सुना। क्या यह सही है?" | निकाली गई आईडी को पढ़कर सुनाना |
3 | "सुरक्षा के लिए, कृपया मुझे ऑर्डर पर दिया गया ज़िप कोड बताएं।" |
|
4 | "आपका ऑर्डर ऑस्टिन में 18 मेपल स्ट्रीट पर शिप हो रहा है। यह सोमवार, दोपहर 1 बजे से शाम 5 बजे के लिए निर्धारित है। आप क्या करना चाहेंगे?" | फुलफिलमेंट स्टेट प्राप्त करना (fetch) |
5 | कॉलर: "क्या मुझे यह मंगलवार सुबह मिल सकता है?" |
|
6 | "मैं मंगलवार सुबह 10 बजे से दोपहर 12 बजे तक, या मंगलवार दोपहर 2 बजे से शाम 4 बजे तक की पेशकश कर सकता हूँ। कौन सा समय सही रहेगा?" | अधिकतम 3 विकल्प |
7 | "मंगलवार सुबह 10:00 बजे से दोपहर 12:00 बजे के बीच, सेंट्रल टाइम। आगे बढ़ने के लिए 'पुष्टि करें' कहें।" | कोई नहीं |
8 | "हो गया। आपको जल्द ही एक टेक्स्ट कन्फर्मेशन मिल जाएगा। कुछ और?" | इडेम्पोटेंसी की के साथ |
स्क्रिप्ट B: डिलीवरी विंडो के साथ नया फोन ऑर्डर
अभिवादन करें और ग्राहक का नाम और फोन नंबर पूछें (या कॉलर आईडी से मिलान करें)।
प्रत्येक आइटम और मात्रा की पुष्टि करें, एक बार में एक आइटम। आगे बढ़ने से पहले पूरी सूची पढ़कर सुनाएं।
डिलीवरी का पता एकत्र करें, फिर इसे सामान्यीकृत (normalized) रूप में पढ़कर सुनाएं।
दो या तीन डिलीवरी विंडो की पेशकश करें और एक की पुष्टि करें।
आवाज के माध्यम से कार्ड नंबर न लें। एसएमएस द्वारा एक सुरक्षित भुगतान लिंक भेजें, या PCI-अनुपालन भुगतान IVR पर स्थानांतरित करें।
ऑर्डर का सारांश पढ़कर सुनाएं और ऑर्डर बनाने से पहले "पुष्टि करें" के लिए कहें।
ऑर्डर का निर्माण केवल स्पष्ट पुष्टि वाले टर्न के बाद ही होना चाहिए। यह एकल नियम अधिकांश महंगी गलतियों को रोकता है।
पुष्टि के लिए SSML
पुष्टि को छोटा रखें और विंडो को स्पष्ट रूप से बताएं। अंकों और स्पष्ट समय के लिए say-as का उपयोग करें।
विशिष्ट टैग्स पर भरोसा करने से पहले Waves API संदर्भ में अपनी चुनी हुई आवाज के लिए SSML सपोर्ट की पुष्टि कर लें। यदि टैग को अनदेखा कर दिया जाता है, तो वही शब्द सामान्य टेक्स्ट के रूप में भी काम करते हैं।
चरण 3: एंटिटी एक्सट्रैक्शन नियम परिभाषित करें
सिर्फ प्रॉम्प्ट में ही नहीं, बल्कि कोड में भी हर एंटिटी को सत्यापित करें।
ऑर्डर आईडी। इसे उस प्रारूप में सामान्यीकृत करें जिसका उपयोग आपका स्टोर करता है। #1042 जैसा Shopify ऑर्डर नाम अपनी आंतरिक संख्यात्मक आईडी से भिन्न मान होता है। रिक्त स्थान हटाएं, बोले गए अंकों ("वन ओह फोर टू") को संख्याओं में बदलें, और हमेशा पढ़कर सुनाएं।
वेरिफिकेशन। किसी भी जानकारी का खुलासा करने या बदलाव करने से पहले एक दूसरे कारक की आवश्यकता रखें, जैसे कि शिपिंग ज़िप या अंतिम नाम। दो प्रयासों की अनुमति दें, फिर एस्केलेट करें।
पता। गली/सड़क, यूनिट, शहर, राज्य और ज़िप को अलग-अलग फ़ील्ड के रूप में एकत्र करें। पता सत्यापन सेवा के विरुद्ध सत्यापित करें। कच्चे ट्रांसक्रिप्ट के बजाय सामान्यीकृत परिणाम को पढ़कर सुनाएं।
डिलीवरी विंडो। ग्राहक के टाइमज़ोन में "मंगलवार सुबह" जैसे वाक्यांशों को एक निश्चित शुरुआत और समाप्ति समय में बदलें। ऑफ़सेट के साथ ISO 8601 मान स्टोर करें।
डिलीवरी बनाम पिकअप। यदि कॉलर कहता है "मैं खुद ले लूंगा," तो एक बार पूछें: "क्या आप अपने पते पर डिलीवरी चाहते हैं, या पिकअप?" कभी भी खुद से मानकर न चलें।
Pulse सेटिंग्स। संग्रहीत ट्रांसक्रिप्ट्स के लिए PII/PCI रिडक्शन चालू करें। टाइमस्टैम्प्स और VAD इवेंट्स का उपयोग यह पता लगाने के लिए करें कि एजेंट के प्रतिक्रिया देने से पहले कॉलर अभी भी बोल रहा है या नहीं।
चेकपॉइंट: अपेक्षित सामान्यीकृत आउटपुट के साथ सुनहरे परीक्षण इनपुट की एक तालिका (बोले गए ऑर्डर आईडी, अव्यवस्थित पते, सापेक्ष तिथियां)। आप परीक्षण में इसका पुनः उपयोग करेंगे।
चरण 4: Pulse पर कॉल ऑडियो स्ट्रीम करें
Pulse, WS /waves/v1/stt/live पर स्ट्रीमिंग और POST /waves/v1/stt/ पर बैच का समर्थन करता है, जिसमें मॉडल को model क्वेरी पैरामीटर द्वारा चुना जाता है। यह Node.js स्केच आपके टेलीफोनी स्ट्रीम से ऑडियो को आगे भेजता है। आने वाले JSON में फ़ील्ड के नाम उदाहरणात्मक हैं, इसलिए उन्हें दस्तावेज़ों में प्रतिक्रिया स्कीमा के साथ मैप करें।
उनके कॉन्फिडेंस मानों के साथ अंतिम ट्रांसक्रिप्ट्स को डायलॉग मैनेजर के पास भेजें। पूरे टर्न के दौरान कॉन्फिडेंस को साथ रखें, क्योंकि चरण 5 इस पर निर्भर करता है।
चरण 5: टूल्स के साथ Electron को कॉल करें
Electron, /v1/chat/completions पर OpenAI-संगत है, जिसमें क्लाइंट बेस URL https://api.smallest.ai/waves/v1 पर सेट है। यह टूल कॉलिंग, JSON मोड और स्ट्रीमिंग का समर्थन करता है, जिसमें विशिष्ट टाइम-टू-फर्स्ट-टोकन 300 ms से कम और 32K का संदर्भ विंडो होता है।
सिस्टम प्रॉम्प्ट में तीन नियम होने चाहिए: प्रत्येक टर्न में एक ही बात पूछें, स्पष्ट "पुष्टि" से पहले कभी भी schedule_delivery को कॉल न करें, और कॉन्फिडेंस कम होने या अनुरोध नीति से बाहर होने पर escalate_to_human को कॉल करें।
मॉडल द्वारा उत्पन्न टूल कॉल इस तरह दिखती है:
किसी भी ऐसे चरण के लिए JSON मोड (response_format: { type: "json_object" }) का उपयोग करें जहाँ आपको बोले गए उत्तर के बजाय एक संरचित एक्सट्रैक्शन की आवश्यकता हो।
चेकपॉइंट: किसी भी ऐसी टूल कॉल को अस्वीकार करें जो स्कीमा सत्यापन में विफल हो जाती है या जिसमें ASR कॉन्फिडेंस आपकी थ्रेसहोल्ड से कम हो (ऑर्डर आईडी के लिए 0.80 से शुरू करें और कॉल ऑडिट के आधार पर ट्यून करें)। एक बार पुनः पूछें, फिर एस्केलेट करें।
चरण 6: बैकएंड टूल फ़ंक्शंस का निर्माण करें
Shopify मूल रूप से ग्राहक-चयनित डिलीवरी विंडो फ़ील्ड प्रदान नहीं करता है। विंडो को अपने OMS या कैरियर सिस्टम में स्टोर करें, और इसे Shopify ऑर्डर पर एक मेटाफ़ील्ड या नोट एट्रिब्यूट के साथ मिरर करें ताकि मानव एजेंट इसे देख सकें।
जानने योग्य Shopify अवधारणाएं:
GET
/admin/api/{version}/orders/{order_id}/fulfillment_orders.jsonसेfulfillment_order_idमान प्राप्त होते हैं।POST
/admin/api/{version}/fulfillments.jsonएक फुलफिलमेंट बनाता है और ट्रैकिंग जोड़ता है।POST
/admin/api/{version}/fulfillments/{fulfillment_id}/update_tracking.jsonट्रैकिंग विवरण को अपडेट करता है।Shopify का
OrderFulfillmentStatusअनफुलफिल्ड से लेकर पूरी तरह से फुलफिल्ड तक की स्थितियों को एग्रीगेट करता है, जिसमें प्रगति पर और होल्ड पर रहना भी शामिल है। बदलाव की पेशकश करने से पहले इसे पढ़ें। एक शिप्ड (shipped) ऑर्डर आमतौर पर एक नई विंडो नहीं ले सकता।
जिस API संस्करण को आप लक्षित कर रहे हैं उसके लिए वर्तमान Shopify Admin API संदर्भ की जांच करें, क्योंकि Shopify अधिक फुलफिलमेंट कार्यों को GraphQL में स्थानांतरित कर रहा है।
इडेम्पोटेंसी की महत्वपूर्ण है। कॉलर्स अपनी बात दोहराते हैं और नेटवर्क पुनः प्रयास करते हैं, इसलिए एक ही पुष्टिकरण से कभी भी दो शेड्यूल नहीं बनने चाहिए।
टूल परिणाम को Electron को एक tool संदेश के रूप में लौटाएं, फिर मॉडल को प्रतिक्रिया तैयार करने दें। अंतिम बोली जाने वाली पुष्टि को टेम्पलेटेड रखें ताकि समय विंडो को कभी भी अलग तरीके से न कहा जाए।
चरण 7: Lightning v3.1 के साथ पुष्टि बोलें
Lightning v3.1 छोटे संकेतों के लिए POST /waves/v1/tts की पेशकश करता है, साथ ही POST /waves/v1/tts/live (SSE) और WSS /waves/v1/tts/live के माध्यम से स्ट्रीमिंग भी प्रदान करता है। निश्चित पुष्टिकरणों जिन्हें आप कैश कर सकते हैं, उनके लिए HTTP रूट का उपयोग करें, और गतिशील प्रतिक्रियाओं के लिए स्ट्रीमिंग ट्रांसपोर्ट का उपयोग करें जहाँ पहली ऑडियो का समय मायने रखता है।
यदि आप किसी ब्रांड की आवाज़ को क्लोन करने की योजना बना रहे हैं, तो Lightning v3.1 संदर्भ ऑडियो के 5 से 15 सेकंड से क्लोनिंग का समर्थन करता है। Lightning v3.1 Pro क्लोनिंग की पेशकश नहीं करता है। किसी भी आवाज़ को क्लोन करने से पहले वक्ता की स्पष्ट सहमति प्राप्त करें, और उसका रिकॉर्ड रखें।
चरण 8: वेबहुक्स और आउट-ऑफ-ऑर्डर इवेंट्स को संभालें
आपके सर्वर पर दो वेबहुक स्ट्रीम आती हैं: टेलीफोनी से कॉल स्टेटस, और Shopify या आपके कैरियर से फुलफिलमेंट इवेंट्स।
टेलीफोनी। यदि आप StatusCallback URL सेट करते हैं लेकिन StatusCallbackEvent को छोड़ देते हैं, तो Twilio केवल अंतिम completed इवेंट भेजता है, इसलिए उन इवेंट्स का अनुरोध करें जिनकी आपको आवश्यकता है। पेलोड में CallSid, CallStatus, CallbackSource, SequenceNumber, और CallDuration (पूरा होने पर) शामिल हैं। कॉलबैक आउट-ऑफ-ऑर्डर आ सकते हैं, इसलिए स्टेट को अपडेट करने से पहले SequenceNumber की तुलना करें।
फुलफिलमेंट। POST /admin/api/{version}/webhooks.json के माध्यम से सदस्यता लें (उदाहरण के लिए, fulfillments/create और fulfillments/update के लिए)। Shopify X-Shopify-Hmac-Sha256 हेडर के साथ प्रत्येक अनुरोध पर हस्ताक्षर करता है, जो कच्चे शरीर (raw body) का एक base64 HMAC-SHA256 है।
पार्स किए गए JSON के बजाय कच्चे शरीर (raw body) के विरुद्ध सत्यापित करें, अन्यथा वैध हस्ताक्षर भी विफल हो जाएंगे। तुरंत पावती दें और एक कतार (queue) के माध्यम से संसाधित करें, उन इवेंट्स के लिए एक डेड-लेटर कतार के साथ जो लगातार विफल हो रहे हैं।
एक वर्कर फिर सेशन रिकॉर्ड को अपडेट करता है और एक नोटिफिकेशन ट्रिगर करता है, जैसे कि एक एसएमएस जो कहता है "आपकी डिलीवरी विंडो की पुष्टि मंगलवार, सुबह 10 बजे से दोपहर 12 बजे के लिए हो गई है।" चूंकि Lightning बोली जाने वाली अपडेट्स का समर्थन करता है, इसलिए यही इवेंट एक आउटबाउंड वॉइस संदेश भी संचालित कर सकता है। उस पैटर्न के लिए डिलीवरी सूचनाएं पर यह गाइड देखें।
चरण 9: एस्केलेशन पथ का निर्माण करें
इनमें से कोई भी सच होने पर एस्केलेशन करें:
एक बार पुनः पूछने के बाद भी ASR कॉन्फिडेंस थ्रेसहोल्ड से नीचे रहता है।
ऑर्डर आईडी अस्पष्ट है या वेरिफिकेशन दो बार विफल हो जाता है।
अनुरोधित विंडो अनुपलब्ध है और कॉलर विकल्पों को अस्वीकार कर देता है।
पता सत्यापन विफल हो जाता है।
अनुरोध में भुगतान, रिफंड या प्राधिकरण शामिल है।
कॉलर किसी व्यक्ति से बात करने के लिए कहता है, या एजेंट लगातार दो बार गलत समझ गया है।
वार्म हैंडऑफ का उपयोग करें। कहें, "मैं आपको एक विशेषज्ञ से जोड़ रहा हूँ जो आपका ऑर्डर और हमने जो चर्चा की है उसे देख सकते हैं," फिर सारांश पास करें ताकि कॉलर को इसे कभी दोहराना न पड़े।
चरण 10: परीक्षण, निगरानी और उत्पादन तत्परता की जाँच करें
परीक्षण
चरण 3 की सुनहरी तालिका का उपयोग करके एंटिटी वैलिडेटर्स के लिए यूनिट परीक्षण।
ऑर्डर लुकअप और शेड्यूलिंग के लिए इंटीग्रेशन परीक्षण, जिसमें 409 और टाइमआउट प्रतिक्रियाएं शामिल हैं।
शोरगुल वाली परिस्थितियों और विभिन्न लहजों में रिकॉर्ड किए गए ऑडियो के साथ एंड-टू-एंड कॉल सिमुलेशन।
बोले गए ऑर्डर आईडी और पतों के लिए सुनहरे ट्रांसक्रिप्ट परीक्षण।
ट्रैक करने के लिए मेट्रिक्स
उत्तर दर (Answer rate) और कॉल पूर्णता दर (call completion rate)।
सफल शेड्यूलिंग दर।
औसत टूल-कॉल लेटेंसी।
इरादे (order status, scheduling, returns) के अनुसार समाधान दर।
एस्केलेशन दर और एस्केलेशन के कारण।
निगरानी। वेबहुक त्रुटि दरों, रीट्राय काउंट्स, डेड-लेटर कतार की गहराई, और शेड्यूलिंग विफलताओं में स्पाइक्स पर अलर्ट करें। साप्ताहिक रूप से ट्रांसक्रिप्ट्स के एक नमूने की समीक्षा करें और जो आपको मिलता है उसके आधार पर कॉन्फिडेंस थ्रेसहोल्ड, प्रॉम्प्ट्स और टूल विवरणों को समायोजित करें। Atoms कॉल एनालिटिक्स और ट्रांसक्रिप्ट समीक्षा प्रदान करता है, जो कस्टम डैशबोर्ड के बिना इनमें से अधिकांश को कवर करता है।
उत्पादन तत्परता चेकलिस्ट
टूल फ़ंक्शंस इडेम्पोटेंट हैं।
प्रत्येक एंडपॉइंट पर वेबहुक हस्ताक्षरों को सत्यापित किया जाता है।
भंडारण से पहले PII के लिए ट्रांसक्रिप्ट्स को रिडैक्ट किया जाता है।
Shopify और कैरियर APIs के लिए रेट लिमिट्स और बैकऑफ़ लागू हैं।
सेशन स्टेट रीस्टार्ट के बाद भी बचा रहता है।
प्रत्येक स्वचालित मार्ग के लिए एक मानव फॉलबैक मौजूद है।
लॉन्च से पहले अनुपालन और UX नियम लागू करें
रिकॉर्डिंग और क्लोनिंग। कॉल की शुरुआत में कॉल रिकॉर्डिंग का खुलासा करें और जहां आवश्यक हो सहमति प्राप्त करें। वॉइस क्लोनिंग के लिए वक्ता की स्पष्ट सहमति आवश्यक है।
भुगतान। वॉइस फ्लो में कार्ड डेटा कैप्चर या स्टोर न करें जब तक कि आप PCI DSS अनुपालन भुगतान आर्किटेक्चर का संचालन न कर रहे हों। भुगतान लिंक या अनुपालन भुगतान IVR का उपयोग करें।
आउटबाउंड रिमाइंडर्स। शेड्यूलिंग के बारे में स्वचालित कॉल और टेक्स्ट TCPA के अंतर्गत आ सकते हैं। व्यवसायों को आमतौर पर स्वचालित टेलीमार्केटिंग संदेशों के लिए पूर्व स्पष्ट लिखित सहमति की आवश्यकता होती है, और उन्हें तुरंत ऑप्ट-आउट का सम्मान करना चाहिए। 11 अप्रैल, 2025 से प्रभावी एक FCC बदलाव ने रद्दीकरण हैंडलिंग को कड़ा कर दिया है। वकील के साथ अपने दायित्वों की पुष्टि करें, और प्रत्येक संदेश में एक ऑप्ट-आउट पथ का निर्माण करें।
ऑर्डर लेने का UX। शुरुआत में ही ऑर्डर नंबर की पुष्टि करें, न्यूनतम एंटिटीज के लिए पूछें, प्रॉम्प्ट्स को छोटा रखें, और OMS में लिखने से पहले पुष्टि करें।
शेड्यूलिंग का UX। दो या तीन विंडो की पेशकश करें, टाइमज़ोन बताएं, और सबसे शुरुआती वास्तविक विंडो की पेशकश करके "जितनी जल्दी हो सके" को संभालें। छुट्टियों की जांच करें, और कॉलर को तब सचेत करें जब पता बदलने से डिलीवरी का वादा अमान्य हो सकता है।
व्यापक निर्माण के बारे में अधिक जानकारी के लिए, ई-कॉमर्स के लिए वॉइस एजेंट बनाने पर इस वॉकथ्रू को देखें।
सामान्य समस्याओं का निवारण
एजेंट बार-बार ऑर्डर नंबर गलत सुन रहा है। केवल अंकों के लिए कहें, उन्हें एक-एक करके पढ़कर सुनाएं, और फॉलबैक के रूप में DTMF कीपैड प्रविष्टि स्वीकार करें।
वेबहुक हस्ताक्षर की जांच विफल हो जाती है। आप शायद पार्स किए गए JSON को हैश कर रहे हैं। कच्चे अनुरोध शरीर (raw request body) को हैश करें।
कॉलर्स को दोहरी पुष्टियाँ मिलती हैं। जांचें कि इडेम्पोटेंसी की में कॉल आईडी, ऑर्डर आईडी और विंडो स्टार्ट शामिल हैं या नहीं।
स्टेट इवेंट्स नए स्टेट को ओवरराइट कर देते हैं। अपडेट लागू करने से पहले SequenceNumber (telephony) या इवेंट टाइमस्टैम्प की तुलना करें।
एजेंट कॉलर के बीच में बोलता है। प्रतिक्रियाओं को रोकने के लिए Pulse VAD इवेंट्स का उपयोग करें, या इन-बिल्ट बार्ज-इन के लिए Hydra का मूल्यांकन करें।
OMS में शेड्यूलिंग सफल हो जाती है लेकिन मानव एजेंट को कुछ नहीं दिखता। सफल लेखन के बाद विंडो को Shopify मेटाफ़ील्ड या नोट एट्रिब्यूट में मिरर करें।
आपने क्या बनाया है और आगे कहाँ जाना है
अब आपके पास एक वॉइस एजेंट है जो कॉलर को सत्यापित करता है, ऑर्डर और डिलीवरी एंटिटीज निकालता है, विंडोज का प्रस्ताव और पुष्टि करता है, इडेम्पोटेंट कॉल्स के साथ शेड्यूल लिखता है, फुलफिलमेंट वेबहुक्स पर प्रतिक्रिया करता है, और पूरे संदर्भ के साथ किसी इंसान को कॉल सौंपता है। पाइपलाइन ट्रांसक्रिप्शन के लिए Pulse, टूल कॉलिंग के लिए Electron और स्पीच के लिए Lightning v3.1 का उपयोग करती है।
सार्थक अगले कदम:
लाइव ट्रैफ़िक रूट करने से पहले गोल्डन-ट्रांसक्रिप्ट सुइट और एक सप्ताह के शैडो कॉल्स चलाएं।
उसी टूल पैटर्न का उपयोग करके रिटर्न और एक्सचेंज के इरादों को जोड़ें।
फ्लो स्थिर होने के बाद ऑर्केस्ट्रेशन, वर्जनिंग और कॉल मॉनिटरिंग को Atoms में ले जाएं।
लेटेंसी और कॉलर अनुभव की तुलना करने के लिए ऑर्डर स्टेटस जैसे कम जोखिम वाले इरादे पर Hydra का पायलट परीक्षण करें।
सहमति कैप्चर और ऑप्ट-आउट हैंडलिंग का परीक्षण होने के बाद ही आउटबाउंड डिलीवरी रिमाइंडर्स जोड़ें।
अक्सर पूछे जाने वाले प्रश्न
मैं ऑर्डर और डिलीवरी के लिए वॉयस एजेंट कैसे बनाऊं?
क्या यह एजेंट मेरे ऑर्डर सिस्टम में डिलीवरी विंडो को अपडेट कर सकता है?
ऑर्डर नंबर गायब होने या अमान्य होने पर मुझे क्या करना चाहिए?
शेड्यूलिंग के दौरान बैकएंड के टकरावों या 5xx गड़बड़ियों (एरर्स) को मैं कैसे संभालूँ?
पहला वर्किंग इंटीग्रेशन बनाने में कितना समय लगता है?
