Shopify + Atoms: एआई वॉइस ऑर्डर स्टेटस और रिटर्न सपोर्ट

ऑर्डर स्टेटस चेक करने, रिटर्न रिक्वेस्ट संभालने, ग्राहकों को वेरिफ़ाई करने और मुश्किल सपोर्ट मामलों को आगे सौंपने के लिए Smallest.ai Atoms के साथ एक Shopify AI वॉइस एजेंट बनाएं।
एक ग्राहक आपके स्टोर पर कॉल करता है और पूछता है, "मेरा ऑर्डर कहाँ है?" यह जानकारी Shopify के ऑर्डर रिकॉर्ड, पूर्ति (फुलफिलमेंट) विवरण या शिपिंग कैरियर के ट्रैकिंग सिस्टम में पहले से ही उपलब्ध हो सकती है। लेकिन सपोर्ट कॉल के दौरान उस जानकारी को प्राप्त करने में फिर भी कई चरण लग सकते हैं। एक सपोर्ट एजेंट को ऑर्डर खोजना होता है, यह स्थापित करना होता है कि कौन कॉल कर रहा है, नवीनतम स्थिति की जांच करनी होती है, और उस रिकॉर्ड को एक उपयोगी उत्तर में बदलना होता है।
अब प्रश्न बदलें: "क्या मैं उस ऑर्डर से जूते वापस कर सकता हूँ?" ग्राहक की तरफ से बातचीत लगभग एक जैसी दिखती है। परदे के पीछे, यह एक अलग तरह की समस्या है। ऑर्डर की खोज केवल डेटा पढ़ती है। रिटर्न का अनुरोध वर्कफ़्लो को बदल सकता है, एक नया रिकॉर्ड बना सकता है, और ग्राहक की ऐसी अपेक्षाएँ तय कर सकता है जिनका स्टोर को सम्मान करना ही होगा।
यहीं पर Shopify + Smallest.ai Atoms उपयोगी बन जाता है। Atoms लाइव बातचीत को संभालता है और यह तय करता है कि कॉन्फ़िगर किए गए टूल का उपयोग कब करना है। ऑर्डर और रिटर्न रिकॉर्ड के लिए Shopify ही प्रामाणिक स्रोत बना रहता है। एक सुरक्षित इंटीग्रेशन लेयर Atoms को Shopify से जोड़ती है, ग्राहक के एक्सेस को सत्यापित करती है, और यह लागू करती है कि एजेंट कौन से ऑर्डर विवरण प्राप्त कर सकता है और कौन सी कार्रवाइयां कर सकता है।
यह गाइड उस आर्किटेक्चर को विस्तार से समझाती है, दिखाती है कि इसे Atoms डैशबोर्ड से कैसे कॉन्फ़िगर किया जाए, और वास्तविक ग्राहकों को एजेंट से जोड़ने से पहले महत्वपूर्ण निर्णयों के बारे में बताती है।
एजेंट को क्या करने की आवश्यकता है?
कार्यों के एक छोटे सेट से शुरुआत करें। प्रत्येक Shopify सपोर्ट अनुरोध को स्वचालित करने का प्रयास करने के बजाय, कुछ पूर्वानुमानित कार्यों से शुरुआत करें जिन्हें एजेंट भरोसेमंद तरीके से संभाल सके। ऑर्डर ट्रैकिंग और रिटर्न पात्रता व्यावहारिक शुरुआती बिंदु हैं, खासकर तब जब एजेंट जानता हो कि बातचीत को किसी इंसान को कब स्थानांतरित (ट्रांसफर) करना है।
ग्राहक पूछता है | सिस्टम को क्या करना चाहिए | सुरक्षित परिणाम |
|---|---|---|
"मेरा ऑर्डर कहाँ है?" | कॉलर को सत्यापित करें; ऑर्डर और पूर्ति डेटा पढ़ें; कैरियर की स्थिति केवल तभी जोड़ें जब वह उपलब्ध हो। | नवीनतम पुष्ट स्थिति बताएं, कोई मनगढ़ंत डिलीवरी तिथि नहीं। |
"क्या मेरा पैकेज शिप हो गया है?" | केवल पूरे ऑर्डर की ही नहीं, बल्कि प्रत्येक शिपमेंट या पूर्ति की जांच करें। | स्पष्ट करें कि क्या ऑर्डर आंशिक रूप से पूरा हुआ है या विभाजित है। |
"क्या मैं यह आइटम वापस कर सकता हूँ?" | आइटम की पहचान करें; लागू मर्चेंट नियमों और वापस किए जाने योग्य आइटमों की जांच करें। | पात्रता स्पष्ट करें या समीक्षा के लिए अपवाद को अग्रेषित करें। |
"कृपया रिटर्न शुरू करें।" | कारण दर्ज करें, चुने गए विकल्प को दोहराएं, पुष्टि प्राप्त करें, स्वीकृत वर्कफ़्लो सबमिट करें। | अनुरोध आईडी और उसकी वास्तविक स्थिति बताएं, किसी रिफंड का वादा न करें। |
दो आवश्यकताएं हर पंक्ति पर लागू होती हैं: ऑर्डर-विशिष्ट जानकारी प्रकट करने से पहले एक्सेस को सत्यापित करें, और केवल उन कार्रवाइयों का वर्णन करें जिनकी बैकएंड पुष्टि करता है। ये नियम किसी चतुर स्क्रिप्ट की तुलना में कहीं अधिक महत्वपूर्ण हैं।
आर्किटेक्चर पर एक नज़र
इस प्रणाली को एक सुरक्षित प्रवेश द्वार के माध्यम से कॉमर्स लेयर से जुड़ी हुई बातचीत लेयर के रूप में समझें।

सहायक मार्ग: Atoms स्वीकृत सामान्य नीतियों के लिए नॉलेज बेस से परामर्श कर सकता है, कॉल को किसी व्यक्ति को स्थानांतरित कर सकता है, और आपकी रिपोर्टिंग या सपोर्ट सिस्टम को कॉल के बाद के इवेंट भेज सकता है। जब Shopify के पास कोई हालिया ट्रैकिंग माइलस्टोन न हो, तो शिपिंग अपडेट किसी कैरियर या पूर्ति सेवा से आने की आवश्यकता हो सकती है।
महत्वपूर्ण अंतर अक्टूबर 2026 तक, Shopify को प्रलेखित Atoms इंटीग्रेशन कैटलॉग में मूल वन-क्लिक इंटीग्रेशन के रूप में सूचीबद्ध नहीं किया गया है। यहाँ दिया गया कार्यान्वयन एक अधिकृत Shopify इंटीग्रेशन सेवा से जुड़े Atoms API टूल का उपयोग करता है। किसी टूल कॉन्फ़िगरेशन को स्वचालित Shopify खाता कनेक्शन न समझें। |
Atoms और Shopify के बीच एक ब्रिज क्यों लगाएं?
क्योंकि वॉयस एजेंट को आपके स्टैक का वह हिस्सा नहीं होना चाहिए जो यह तय करे कि कोई ऑर्डर कॉलर का है या नहीं, कोई रिटर्न नीति विंडो के अंतर्गत आता है या नहीं, या कोई डेटा राइट (write) दो बार हो सकता है या नहीं। एक अनुमोदित ऑटोमेशन प्लेटफ़ॉर्म या हल्के बैकएंड के साथ निर्मित एक सुरक्षित इंटीग्रेशन लेयर, ऑर्डर के स्वामित्व को सत्यापित कर सकती है, रिटर्न नीतियों को लागू कर सकती है, डुप्लिकेट अनुरोधों को रोक सकती है, और केवल प्रासंगिक परिणाम ही Atoms को वापस भेज सकती है।
एक ब्रिज Shopify क्रेडेंशियल्स को बातचीत के प्रॉम्प्ट्स से बाहर भी रखता है। Shopify Admin API कॉल प्रमाणित स्टोर एक्सेस और स्वीकृत स्कोप्स का उपयोग करते हैं। ब्रिज के पास वे क्रेडेंशियल्स होते हैं; वॉयस एजेंट को केवल वही रिस्पॉन्स फ़ील्ड मिलते हैं जिनकी उसे आवश्यकता होती है।
वर्कफ़्लो 1: "मेरा ऑर्डर कहाँ है?"
कॉन्फ़िगरेशन स्क्रीन खोलने से पहले आइए एक सामान्य कॉल का अनुसरण करते हैं।
1. इरादे (इंटेंट) को पहचानें। कॉलर कहता है, "मैंने पिछले मंगलवार को एक जैकेट ऑर्डर की थी। क्या वह शिप हो गई है?" Atoms बातचीत को ऑर्डर-स्थिति वर्कफ़्लो पर रूट करता है।
2. ऑर्डर संदर्भ प्राप्त करें। ऑर्डर नंबर मांगें। अस्पष्ट ऑडियो से अनुमान लगाने के बजाय अस्पष्ट अक्षरों या अंकों को दोहराएं।
3. कॉलर को सत्यापित करें। इंटीग्रेशन स्टोर की स्वीकृत प्रमाणीकरण प्रक्रिया का उपयोग करके कॉलर को सत्यापित करता है, जैसे कि एक विश्वसनीय चैनल के माध्यम से दिया गया और बैकएंड द्वारा मान्य किया गया वन-टाइम कोड। सत्यापन सफल होने के बाद ही एजेंट आगे बढ़ता है। केवल ऑर्डर नंबर या कॉलर आईडी को स्वामित्व का प्रमाण नहीं माना जाना चाहिए।
4. अधिकृत ऑर्डर प्राप्त करें। सत्यापित होने के बाद, बैकएंड Shopify से संबंधित ऑर्डर और उसके पूर्ति विवरण प्राप्त करता है। यदि ऑर्डर में दो शिपमेंट हैं, तो उन शिपमेंट को अलग रखें।
5. संरचित फ़ील्ड्स को आवाज़ में अनुवादित करें। "आपकी जैकेट कल पूरी (फुलफिल) कर दी गई थी। कैरियर ने अभी तक डिलीवरी का अनुमान प्रकाशित नहीं किया है।" यह ग्राहक को ऑर्डर की पूर्ति को कन्फर्म डिलीवरी के साथ भ्रमित किए बिना एक उपयोगी अपडेट देता है।
6. एक उपयोगी अगली कार्रवाई की पेशकश करें। यदि ग्राहक को ट्रैकिंग लिंक की आवश्यकता है, तो एक स्वीकृत मैसेजिंग फ्लो का उपयोग करें या उन्हें ऑर्डर पेज पर निर्देशित करें। यदि डेटा असंगत है, तो मानवीय सहायता की पेशकश करें।
अंतर्निहित रिस्पॉन्स में ऑर्डर की स्थिति, पूर्ति की स्थिति, ट्रैकिंग की उपलब्धता, और अंतिम पुष्ट अपडेट के टाइमस्टैम्प के बीच अंतर होना चाहिए। "फुलफिल्ड" होना "डिलीवर" होने जैसा नहीं है, और "लेबल बन जाना" "कैरियर द्वारा एकत्र किया जाना" नहीं है।
वर्कफ़्लो 2: "मैं यह आइटम वापस करना चाहता हूँ"
रिटर्न के लिए एक अलग वर्कफ़्लो की आवश्यकता होती है क्योंकि एजेंट को केवल जानकारी प्राप्त करने से अधिक कुछ करने की आवश्यकता हो सकती है। उसे पात्रता की जांच करने, ग्राहक के विवरण एकत्र करने, और एक ऐसा अनुरोध सबमिट करने की भी आवश्यकता हो सकती है जो स्टोर के रिकॉर्ड को बदलता है। Shopify मर्चेंट द्वारा निर्धारित रिटर्न विंडो, अंतिम-बिक्री बहिष्करण, शुल्क और अन्य शर्तों का समर्थन करता है। वे नियम उत्पाद या बाज़ार के अनुसार भिन्न हो सकते हैं, और रिटर्न नियमों के अपडेट स्वचालित रूप से उन नियमों को फिर से नहीं लिखते हैं जो पहले की गई खरीदारियों पर लागू होते थे। देखें Shopify का रिटर्न-नियम मार्गदर्शन।

1. ऑर्डर ढूंढें और सत्यापित करें। पिछले चरण के सत्यापित ऑर्डर संदर्भ का पुन: उपयोग करें, या यदि यह एक नया कॉल है तो कॉलर को सत्यापित करें।
2. सटीक आइटम और मात्रा की पहचान करें। ग्राहक ने दो आकार खरीदे होंगे या अलग-अलग पूर्ति में वही आइटम प्राप्त किया होगा। कभी भी यह अनुमान न लगाएं कि उनका क्या मतलब है।
3. वापसी योग्यता और स्टोर नीति की जांच करें। बैकएंड ऑर्डर की लागू रिटर्न नीति की जांच करता है और पात्र वस्तुओं और मात्राओं की पहचान करने के लिए Shopify के वापस करने योग्य पूर्ति डेटा की क्वेरी करता है। इससे पहले कि एजेंट उपलब्ध विकल्पों को समझाए, यह मौजूदा रिटर्न या अन्य प्रतिबंधों की भी जांच करता है।
4. कारण पूछें। मर्चेंट के वर्कफ़्लो के अनुसार आवश्यक कारण दर्ज करें, जिसमें कोई भी ऐसा नोट शामिल हो जिसे अनुरोध के साथ भेजा जाना आवश्यक हो।
5. डेटा राइट (write) करने से पहले पुष्टि करें। "आप ऑर्डर 1042 से एक नीली शर्ट के लिए रिटर्न का अनुरोध करना चाहते हैं क्योंकि आकार बहुत छोटा है। क्या मुझे वह अनुरोध सबमिट करना चाहिए?"
6. सही ऑपरेशन सबमिट करें। मर्चेंट समीक्षा के लिए, Shopify returnRequest को प्रलेखित करता है, जो REQUESTED स्थिति में एक रिटर्न बनाता है। इसके विपरीत returnCreate एक OPEN रिटर्न बनाता है और मानता है कि अनुमोदन पहले ही हो चुका है। ये आपस में बदले जाने योग्य नहीं हैं। देखें Shopify की रिटर्न-प्रबंधन गाइड।
7. पुष्ट परिणाम को पढ़कर सुनाएं। केवल तब कहें 'आपका रिटर्न अनुरोध समीक्षा के लिए सबमिट कर दिया गया है' जब बैकएंड पुष्टि करता है कि Shopify ने रिटर्न अनुरोध बनाया है, उसका संदर्भ और REQUESTED स्थिति लौटा दी है, और कोई म्यूटेशन त्रुटि रिपोर्ट नहीं की है। यदि परिणाम अनिश्चित है, तो स्पष्ट करें कि अनुरोध की पुष्टि नहीं की जा सकी और आगे की सहायता की पेशकश करें। वास्तविक संदर्भ और अगला कदम बताएं। ऐसे किसी लेबल, अनुमोदन या रिफंड का वादा न करें जिसकी बैकएंड ने पुष्टि नहीं की है।

बिना किसी बड़े कोडबेस के Shopify + Atoms का निर्माण कैसे करें
एक व्यावहारिक शुरुआती आर्किटेक्चर बातचीत और API टूल को कॉन्फ़िगर करने के लिए Atoms डैशबोर्ड का उपयोग करता है, जिसमें एक अलग सुरक्षित इंटीग्रेशन लेयर Shopify प्रमाणीकरण, ग्राहक सत्यापन, और रिटर्न-नीति जांच को संभालती है। आपके मौजूदा टूल्स के आधार पर, आप इस इंटीग्रेशन को एक अनुमोदित लो-कोड ऑटोमेशन प्लेटफ़ॉर्म के माध्यम से कॉन्फ़िगर कर सकते हैं या अधिक नियंत्रण के लिए एक हल्का बैकएंड बना सकते हैं। नीचे दिए गए उदाहरण एंडपॉइंट नाम उदाहरणात्मक हैं, मूल Shopify या Atoms एंडपॉइंट नहीं हैं।

चरण 1. Shopify डेटा और अनुमतियां तैयार करें
अपने Shopify एडमिन में, सेटिंग्स → नीतियां की समीक्षा करें और विंडो, अंतिम-बिक्री बहिष्करण, शुल्क और उत्पाद अपवादों सहित अपने रिटर्न और रद्दीकरण नियमों की पुष्टि करें। लिखें कि एजेंट किन अनुरोधों को संभाल सकता है और किनके लिए मानवीय निर्णय की आवश्यकता है।
डेटा एक्सेस के लिए, एक अधिकृत Shopify ऐप और वर्तमान GraphQL Admin API प्रमाणीकरण मॉडल का उपयोग करें। नया ऐप कार्य Shopify के Dev Dashboard या CLI प्रक्रिया का पालन करता है, न कि नए एडमिन-निर्मित कस्टम ऐप बनाने के बंद किए गए फ्लो का। न्यूनतम अनुमत स्कोप्स की मांग करें। ऑर्डर लुकअप के लिए आम तौर पर read_orders स्कोप की आवश्यकता होती है। रिटर्न रिकॉर्ड या वापस करने योग्य पूर्ति को पढ़ने के लिए उचित रिटर्न एक्सेस की भी आवश्यकता होती है, जैसे read_returns, जबकि रिटर्न अनुरोध सबमिट करने के लिए write_returns की आवश्यकता होती है। 60 दिनों से पुराने ऑर्डरों तक पहुंच के लिए आम तौर पर अतिरिक्त Shopify अनुमोदन और read_all_orders स्कोप की आवश्यकता होती है।
Shopify क्रेडेंशियल्स को इंटीग्रेशन सेवा में सुरक्षित रूप से संग्रहीत करें और उन्हें कभी भी एजेंट प्रॉम्प्ट्स, ग्राहक-दृश्यमान वेरिएबल्स या सार्वजनिक एंडपॉइंट्स में उजागर न करें। उपयोग की गई प्रमाणीकरण विधि के अनुसार टोकन प्राप्ति और नवीनीकरण को संभालें, जिसमें लागू होने पर टोकन समाप्ति भी शामिल है।
चरण 2. सुरक्षित कार्रवाइयों के एक छोटे सेट को प्रदर्शित करें
आपकी इंटीग्रेशन सेवा को कठिन काम करना चाहिए: स्वामित्व सत्यापित करना, Shopify से पूछताछ करना, स्टोर नीति लागू करना, और प्रतिक्रियाओं को सामान्य बनाना। Atoms से, वर्कफ़्लो कई कच्चे कॉमर्स API कॉल के बजाय चार व्यावसायिक कार्रवाइयों जैसा दिखता है।
उदाहरणात्मक कार्रवाई | Atoms से इनपुट | एजेंट को आवश्यक प्रतिक्रिया |
|---|---|---|
verify_order | ऑर्डर संदर्भ और आवश्यक सत्यापन इनपुट। | सर्वर द्वारा जारी किया गया सत्यापन संदर्भ, या एक सुरक्षित विफलता परिणाम। |
get_order_status | सत्यापित संदर्भ। | ऑर्डर की स्थिति, लाइन/शिपमेंट की स्थिति, ट्रैकिंग सारांश, अंतिम अपडेट किया गया टाइमस्टैम्प। |
check_return_eligibility | सत्यापित संदर्भ, चयनित वस्तु और मात्रा। | पात्र / पात्र नहीं / मानवीय समीक्षा; अनुमत अगला कदम; नीतिगत कारण। |
submit_return_request | सत्यापित संदर्भ, वस्तु, मात्रा, कारण, स्पष्ट ग्राहक पुष्टि। | अनुरोध संदर्भ और वास्तविक स्थिति, या एक स्पष्ट त्रुटि। |
verification_failed, order_not_found, tracking_unavailable, human_review_required, और request_already_exists जैसे छोटे त्रुटि कोड का उपयोग करें। एजेंट आंतरिक डायग्नोस्टिक्स को उजागर किए बिना इन्हें सामान्य भाषा में मैप कर सकता है। रिटर्न सबमिशन के लिए, प्रत्येक ग्राहक-पुष्ट अनुरोध को एक स्थिर इडेम्पोटेंसी (idempotency) कुंजी सौंपें और इसे बैकएंड में लागू करें। यदि कॉल टाइम आउट हो जाती है या एजेंट पुनः प्रयास करता है, तो बैकएंड को उस कुंजी का पुन: उपयोग करना चाहिए, जांचना चाहिए कि क्या कोई रिटर्न पहले से मौजूद है, और एक ही अनुरोध को दो बार सबमिट करने से बचना चाहिए।
चरण 3. Atoms में कस्टमर-सपोर्ट एजेंट बनाएं
Smallest.ai कंसोल में साइन इन करें और Shopify ग्राहक सहायता के लिए एक नया वॉयस एजेंट बनाएं। संपादक में, एक सपोर्ट-केंद्रित नाम, प्राथमिक बोली जाने वाली भाषा, एक आवाज़, और एक प्रॉम्प्ट सेट करें जो सटीक रूप से बताता हो कि कौन से कार्य दायरे में हैं। Atoms डैशबोर्ड सेटअप और इसके अलग पब्लिश और एक्टिवेट चरणों को एजेंट सेटअप गाइड में प्रलेखित करता है।
पहले संस्करण को सीमित रखें: ऑर्डर लुकअप, रिटर्न पात्रता, रिटर्न अनुरोध सबमिशन, और स्थानांतरण। पते में बदलाव, रद्दीकरण, भुगतान, और रिफंड को पायलट प्रोजेक्ट से बाहर रखें जब तक कि आपने उन फ्लो को स्वतंत्र रूप से नहीं बनाया और अनुमोदित नहीं किया हो।
चरण 4. रिटर्न-नीति नॉलेज बेस जोड़ें
अपनी वर्तमान लिखित रिटर्न नीति, शिपिंग अक्सर पूछे जाने वाले प्रश्न (FAQ), संपर्क के घंटे और एस्केलेशन शर्तों से युक्त एक नॉलेज बेस बनाएं। एक स्वीकृत नीति दस्तावेज़ अपलोड करें या वेबसाइट सामग्री आयात करने के लिए समर्थित 'URL से निकालें' विकल्प का उपयोग करें। जब दस्तावेज़ों का प्रसंस्करण समाप्त हो जाए, तो एजेंट कॉन्फ़िगरेशन में नॉलेज बेस सक्षम करें और प्रासंगिक नॉलेज बेस का चयन करें। Atoms इसे नॉलेज बेस के अंतर्गत प्रलेखित करता है।
यहाँ सामान्य प्रश्न आते हैं: "मेरे पास कुछ वापस करने के लिए कितना समय है?" ऑर्डर-विशिष्ट प्रश्नों के लिए अभी भी सत्यापित लाइव डेटा की आवश्यकता होती है। जब भी नीतियां बदलें तो नॉलेज बेस की समीक्षा करें।
चरण 5. Atoms में API टूल्स कॉन्फ़िगर करें
टूल्स लाइब्रेरी में, टूल जोड़ें → API टूल चुनें। कार्रवाई को नाम दें, बताएं कि एजेंट को इसका उपयोग कब करना चाहिए, और HTTP विधि और सुरक्षित ब्रिज URL को कॉन्फ़िगर करें। Atoms पाथ, पैरम्स, हेडर, ऑथ, और बॉडी सेटिंग्स प्रदान करता है, साथ ही वेरिएबल मैपिंग और रिस्पॉन्स निष्कर्षण भी प्रदान करता है। इनलाइन टेस्ट API सुविधा अनुरोधों का परीक्षण कर सकती है, लेकिन यह सहेजे गए प्रमाणीकरण रहस्यों (secrets) को इंजेक्ट नहीं करती है। इसलिए प्रमाणित एंडपॉइंट्स इनलाइन परीक्षण के दौरान 401 या 403 प्रतिक्रिया दे सकते हैं और वास्तविक एजेंट कॉल के माध्यम से भी सत्यापित किए जाने चाहिए। देखें API टूल गाइड।
उदाहरण के लिए, ब्रिज के प्रमाणित ऑर्डर-स्थिति एंडपॉइंट को कॉल करने के लिए get_order_status को कॉन्फ़िगर करें। सफल सत्यापन वर्कफ़्लो द्वारा पॉप्युलेट किए गए वेरिएबल से सत्यापन संदर्भ को मैप करें। कॉलर द्वारा प्रदान किए गए या मॉडल द्वारा उत्पन्न असत्यापित मान पर भरोसा करने के बजाय बैकएंड को इस संदर्भ को मान्य करना होगा। ब्रिज API क्रेडेंशियल को Atoms सीक्रेट्स में संग्रहीत करें और Auth टैब से इसका संदर्भ लें।
टूल सेटिंग | उदाहरण कॉन्फ़िगरेशन | यह क्यों मायने रखता है |
|---|---|---|
नाम | get_order_status | मॉडल एक विशिष्ट कार्रवाई का चयन कर सकता है। |
विधि / URL | GET / https://support.example.com/orders/status | आपके ब्रिज को कॉल करता है, किसी ओपन Shopify टोकन एंडपॉइंट को नहीं। |
पैरामीटर | verification_ref ← सत्यापित वेरिएबल | सत्यापित संदर्भ को बैकएंड में पास करता है, जिसे ऑर्डर की जानकारी लौटाने से पहले इसकी प्रामाणिकता, वैधता अवधि और प्राधिकरण को स्वतंत्र रूप से मान्य करना होगा। |
प्रमाणीकरण | Bearer सीक्रेट ORDER_BRIDGE_TOKEN | क्रेडेंशियल सर्वर-साइड इंजेक्ट किया जाता है। |
रिस्पॉन्स निष्कर्षण | status ← $.status, tracking ← $.tracking_summary | बोले जाने वाले उत्तरों को लौटाए गए फ़ील्ड्स पर आधारित रखता है। |
परीक्षण | वैध, अमान्य, समाप्त, और अनुपलब्ध मामले | अनुरोध संरचना और प्रतिक्रिया से निपटने की जांच करता है। टेस्ट एजेंट और बैकएंड परीक्षणों के माध्यम से प्रमाणित अनुरोधों और पूर्ण त्रुटि-हैंडलिंग व्यवहार को सत्यापित करें। |
फिर इन सहेजे गए टूल्स को एजेंट के टूल्स टैब में जोड़ें। Atoms पुन: प्रयोज्य टूल्स एजेंटों के बीच साझा किए जाते हैं, इसलिए किसी लाइब्रेरी टूल को संपादित करने से उस पर निर्भर प्रत्येक एजेंट प्रभावित हो सकता है। लाइब्रेरी टूल की प्रतिलिपि बनाएँ और परीक्षण प्रति को अपना स्वयं का कॉन्फ़िगरेशन और पहचानकर्ता दें जब आपको मूल टूल का उपयोग करने वाले एजेंटों को प्रभावित किए बिना अलग परीक्षण की आवश्यकता हो। देखें टूल्स लाइब्रेरी।
चरण 6. एजेंट को बताएं कि प्रत्येक टूल का उपयोग कब करना है
एक कनेक्टेड टूल एक विश्वसनीय वर्कफ़्लो के समान नहीं है। आपके प्रॉम्प्ट को यह बताना होगा कि टूल कब चलना चाहिए और किसे पूर्ण कार्रवाई माना जाता है। एजेंट संपादक में अनुकूलित करने के लिए यहाँ एक संक्षिप्त शुरुआती निर्देश दिया गया है:
उदाहरण एजेंट निर्देश "आप Shopify स्टोर के ऑर्डर और रिटर्न सहायक हैं। ऑर्डर-विशिष्ट प्रश्नों के लिए, ऑर्डर संदर्भ का अनुरोध करें और पहले आवश्यक सत्यापन टूल को पूरा करें। सत्यापन से पहले ग्राहक या शिपमेंट विवरण प्रकट न करें। केवल सत्यापित संदर्भ के साथ get_order_status का उपयोग करें। रिटर्न के लिए, वस्तु और मात्रा की पुष्टि करें, check_return_eligibility को कॉल करें, और submit_return_request से पहले कॉलर से स्पष्ट अनुमोदन मांगें। केवल टूल्स द्वारा लौटाई गई स्थितियों और संदर्भों को बताएं। कभी भी यह न कहें कि रिफंड जारी कर दिया गया है जब तक कि कोई अधिकृत प्रणाली इसकी पुष्टि न करे। जब सत्यापन, नीति जांच, या टूल्स विफल हो जाएं, तो सीमा को स्पष्ट करें और किसी व्यक्ति को ट्रांसफर करने की पेशकश करें।" |
आवाज़-विशिष्ट छोटे नियम जोड़ें: एक समय में एक प्रश्न पूछें, अनिश्चित ऑर्डर नंबरों को दोहराएं, कॉल करने वालों को बीच में बोलने या विवरण सही करने की अनुमति दें, और लंबे ट्रैकिंग URL को जोर से पढ़ने से बचें। एजेंट को डिलीवरी की तारीखें या स्टोर नीति के अपवाद गढ़ने से रोकें।
चरण 7. मानवीय स्थानांतरण जोड़ें और पूरे पथ का परीक्षण करें
एक वैध गंतव्य के साथ Atoms के ट्रांसफर कॉल सिस्टम टूल को सक्षम करें, और तय करें कि क्या वार्म ट्रांसफर आपकी सहायता टीम के लिए उपयुक्त है। प्रलेखित टूल वार्म ट्रांसफर में प्राप्तकर्ता एजेंट को एक छोटा संदेश (whisper message) दे सकता है। संदेश से निजी विवरण दूर रखें जब तक कि स्थानांतरण गंतव्य विश्वसनीय और अधिकृत न हो। देखें सिस्टम टूल्स।
वेब या फोन परीक्षण के साथ टेस्ट एजेंट का उपयोग करें। ब्राउज़र-आधारित टेस्ट एजेंट बातचीत से शुरुआत करें और सत्यापित करें कि एजेंट सही वर्कफ़्लो का पालन करता है। इसके बाद, पुष्टि करें कि प्रमाणित API अनुरोध सफल होते हैं, अमान्य और समाप्त हो चुके सत्यापन संदर्भों का परीक्षण करें, और फोन चैनल के माध्यम से पूरी प्रक्रिया को दोहराएं। जब ड्राफ्ट तैयार हो जाए, तो इसे प्रकाशित और सक्रिय करें। अपने चुने हुए ग्राहक चैनल के लिए एजेंट के समर्थित फोन परिनियोजन या वॉयस विजेट का उपयोग करें; Shopify API कनेक्शन जोड़ने से आपके स्टोरफ्रंट में स्वचालित रूप से कोई विजेट नहीं जुड़ता है।
नो-कोड या लो-कोड: आपको कौन सा तरीका चुनना चाहिए?
तरीका | आप क्या कॉन्फ़िगर करते हैं | उपयुक्तता / समझौता |
|---|---|---|
UI-आधारित, प्रबंधित ऑटोमेशन | Atoms एजेंट और टूल्स + Shopify प्रमाणीकरण और सरल नीतियों के साथ स्वीकृत इंटीग्रेशन वर्कफ़्लो। | लो-कोड इंटीग्रेशन के त्वरित परीक्षण के लिए उपयोगी, बशर्ते प्लेटफ़ॉर्म सुरक्षित प्रमाणीकरण, सत्यापन जांच, Shopify API एक्सेस और विश्वसनीय त्रुटि प्रबंधन का समर्थन करता हो। जटिल नीतिगत नियमों के लिए अभी भी कस्टम बैकएंड की आवश्यकता हो सकती है। |
छोटी कस्टम इंटीग्रेशन सेवा | Atoms एजेंट और टूल्स + Shopify GraphQL को कॉल करने वाली एक छोटी प्रमाणित API लेयर। | अधिक इंजीनियरिंग प्रयास, सत्यापन, स्कोप, इडेम्पोटेंसी, त्रुटि प्रबंधन और ऑडिट ट्रेल्स पर बेहतर नियंत्रण। |
किसी भी मार्ग के लिए, एजेंट को एक साधारण व्यावसायिक प्रतिक्रिया देखनी चाहिए, न कि एक कच्चा Shopify GraphQL पेलोड। यह अलगाव प्रॉम्प्ट व्यवहार का परीक्षण करना आसान बनाता है और बोले गए उत्तर में संवेदनशील फ़ील्ड के लीक होने की संभावना को कम करता है।
उत्पादन (प्रोडक्शन) में आमतौर पर क्या टूटता है?
एक प्रारंभिक डेमो एक एकल ऑर्डर, एक शिपमेंट, और एक ऐसे ग्राहक के साथ पूरी तरह से काम कर सकता है जो प्रत्येक विवरण सही ढंग से प्रदान करता है। वास्तविक स्टोरों में आंशिक पूर्ति होती है, रिटर्न पहले से ही प्रगति पर होते हैं, कैरियर में देरी होती है, और ऐसे ग्राहक होते हैं जो कहते हैं "नहीं, वह दूसरी नीली शर्ट।" विफलताओं की योजना अभी से बनाएं।

विफलता का प्रकार | एजेंट को क्या करना चाहिए |
|---|---|
ऑर्डर नंबर गलत सुना गया या दोहराया गया | अस्पष्ट हिस्से को दोहराएं और फिर से जांचें। कभी भी मिलान का अनुमान न लगाएं। |
सत्यापन विफल होता है | ऑर्डर प्रकट न करें। नीति के तहत पुन: प्रयास या सुरक्षित मानवीय सहायता की पेशकश करें। |
विभाजित शिपमेंट या आंशिक पूर्ति | प्रत्येक वस्तु या शिपमेंट का अलग-अलग वर्णन करें; यह कहने से बचें कि पूरा ऑर्डर डिलीवर हो गया था। |
ट्रैकिंग फ़ीड पुरानी है | अंतिम ज्ञात पड़ाव और उसका टाइमस्टैम्प बताएं। कोई अनुमानित डिलीवरी समय (ETA) न गढ़ें। |
रिटर्न नीति अपवाद | स्पष्ट करें कि मैन्युअल समीक्षा की आवश्यकता है। स्टोर नियमों को चुपचाप न बदलें। |
सबमिशन के बाद अनुरोध टाइम आउट हो जाता है | इडेम्पोटेंसी संदर्भ का उपयोग करके, पुनः प्रयास करने से पहले मौजूदा अनुरोध की जांच करें। |
ग्राहक तुरंत रिफंड मांगता है | स्पष्ट करें कि अनुरोध, अनुमोदन, आइटम प्राप्त करना और रिफंड प्रसंस्करण अलग-अलग चरण हो सकते हैं। |
जब कुछ गलत हो जाता है, तो एजेंट को अनुमान लगाने या असत्यापित जानकारी के साथ जारी रखने के बजाय सीमा को स्पष्ट रूप से समझाना चाहिए। यदि आपका इंटीग्रेशन डाउन है, तो कहें कि ऑर्डर सिस्टम तक नहीं पहुंचा जा सकता है। याददाश्त से उत्पन्न उत्तर के साथ जारी न रखें।
आपको कैसे पता चलेगा कि वर्कफ़्लो वास्तव में काम कर गया?
सफल लगने वाली बातचीत को सफल Shopify कार्रवाई न मानें। एजेंट ने जो कहा उसका मिलान सिस्टम में सहेजे गए डेटा से करें।

परीक्षण मामला | पास होने की शर्त |
|---|---|
वैध ऑर्डर, सही सत्यापन | एजेंट उसी पूर्ति स्थिति की घोषणा करता है जो अधिकृत एंडपॉइंट द्वारा लौटाई गई है। |
गलत सत्यापन इनपुट | कोई भी निजी ऑर्डर फ़ील्ड नहीं बोला जाता है या एजेंट को नहीं लौटाया जाता है। |
दो शिपमेंट, अलग-अलग स्थितियां | एजेंट दोनों शिपमेंट को एक स्थिति में समेटने के बजाय उनके बीच अंतर करता है। |
अनुमोदन की आवश्यकता वाला पात्र रिटर्न | बैकएंड REQUESTED स्थिति में ठीक एक रिटर्न अनुरोध की पुष्टि करता है, या अपेक्षित वस्तु, मात्रा और संदर्भ के साथ एक समकक्ष अनुमोदित मर्चेंट वर्कफ़्लो रिकॉर्ड की पुष्टि करता है। कोई म्यूटेशन त्रुटि या डुप्लिकेट सबमिशन नहीं होता है। |
रिटर्न सबमिशन के बाद टूल टाइमआउट | कोई डुप्लिकेट अनुरोध नहीं बनाया गया है; अस्पष्ट परिणाम को एस्केलेट किया जाता है या सुलझाया जाता है। |
अपात्र या पहले से रिफंड किया गया आइटम | कोई रिटर्न राइट (write) नहीं होता है; कॉलर को सही अगला कदम मिलता है। |
फिर परिचालन मेट्रिक्स के एक छोटे सेट को ट्रैक करें: सत्यापित लुकअप सफलता दर, सही ऑर्डर-स्थिति उत्तर दर, रिटर्न-अनुरोध पुष्टि दर, डुप्लिकेट-राइट घटनाएं, टूल त्रुटि दर, और कारण के अनुसार मानवीय-स्थानांतरण दर। केवल बातचीत की सहजता के लिए ही नहीं, बल्कि नीतिगत सटीकता के लिए भी कॉलों के नमूने की समीक्षा करें।
Atoms कॉल ट्रांसक्रिप्ट, मेट्रिक्स और लाइफसाइकिल वेबहुक का समर्थन करता है। इसके प्रलेखित इवेंट प्रकारों में प्री-कन्वर्सेशन, पोस्ट-कन्वर्सेशन और एनालिटिक्स-कम्प्लीटेड शामिल हैं। ये किसी बातचीत को सपोर्ट टिकट या ऑडिट रिकॉर्ड से जोड़ने में मदद कर सकते हैं, लेकिन इंटीग्रेशन को अभी भी Shopify या आपके सिस्टम ऑफ रिकॉर्ड के मुकाबले किसी भी दावा की गई ऑर्डर कार्रवाई का मिलान करना चाहिए। देखें Atoms वेबहुक।
सुरक्षा और ग्राहक का विश्वास वर्कफ़्लो का हिस्सा हैं
एक ऑर्डर स्थिति प्रतिक्रिया पते, खरीदारियों और अन्य व्यक्तिगत जानकारी को उजागर कर सकती है। बैकएंड में सत्यापन बनाएं, न्यूनतम-विशेषाधिकार Shopify पहुंच लागू करें, और केवल बोले जाने वाले कार्य के लिए आवश्यक फ़ील्ड ही लौटाएं। कॉलर का फ़ोन नंबर एक उपयोगी संकेत है, अपने आप में पर्याप्त प्रमाणीकरण नहीं है।
रिटर्न सबमिशन के लिए, स्पष्ट ग्राहक पुष्टि की आवश्यकता रखें, एक ऑडिट रिकॉर्ड लिखें, और एक इडेम्पोटेंट ऑपरेशन का उपयोग करें। डेटा प्रतिधारण, रिकॉर्डिंग नोटिस, सहमति और एक्सेस नियंत्रण को अपने स्टोर की नीतियों और लागू कानून के अनुरूप रखें। जब आप पहचान सत्यापित नहीं कर सकते हैं या विश्वास के साथ नीति लागू नहीं कर सकते हैं, तो ग्राहक को एक अधिकृत सहायता व्यक्ति के पास भेजें।
बातचीत को उपयोगी बनाएं, केवल धाराप्रवाह नहीं
लक्ष्य किसी वॉयस एजेंट को ऐसा दिखाना नहीं है जैसे कि वह हर उत्तर जानता हो। इसका उद्देश्य स्टोर के नियमों से समझौता किए बिना किसी सामान्य ग्राहक समस्या को हल करना आसान बनाना है। Shopify को ऑर्डर और रिटर्न के लिए आधिकारिक बने रहना चाहिए; Atoms को उन तथ्यों को स्वाभाविक बातचीत में सुलभ बनाना चाहिए; और इंटीग्रेशन लेयर को यह लागू करना चाहिए कि उनके बीच क्या होता है।
एक सत्यापित ऑर्डर-स्थिति वर्कफ़्लो से शुरुआत करें जो सटीक Shopify डेटा प्राप्त करता है, परिणाम को स्वाभाविक रूप से समझाता है, और आवश्यकता पड़ने पर मानवीय सहायता प्रदान करता है। फिर स्थिति परिवर्तन स्पष्ट होने पर रिटर्न अनुरोध जोड़ें। Smallest.ai Atoms के साथ निर्माण शुरू करें और अपने पहले Shopify सहायता वर्कफ़्लो को कॉन्फ़िगर करने के लिए Atoms एजेंट दस्तावेज़ीकरण का उपयोग करें।
अक्सर पूछे जाने वाले प्रश्न
क्या Atoms सीधे Shopify से कनेक्ट हो सकता है?
क्या एजेंट रीयल-टाइम ऑर्डर ट्रैकिंग प्रदान कर सकता है?
क्या एजेंट अपने आप रिटर्न स्वीकार कर सकता है और रिफंड जारी कर सकता है?
क्या इस वर्कफ़्लो को बनाने के लिए कोडिंग की आवश्यकता है?
शुरुआत के लिए सबसे सुरक्षित यूज़ केस (उपयोग का मामला) कौन सा है?



