AI
अपना AI एजेंट WhatsApp पर लाएँ: वेबहुक एंडपॉइंट से कोई भी फ़्रेमवर्क (LangGraph, ADK, कस्टम) कनेक्ट करें
आपकी टीम ने LangGraph, Google ADK, CrewAI या सादे कोड से एजेंट बनाया है, और वह काम करता है। जानें कि उसे दोबारा बनाए बिना WhatsApp और हर दूसरे चैनल पर ग्राहकों के सामने कैसे रखें, टीम इनबॉक्स और इंसानी हैंडओवर के साथ।
MonoChat टीम अपडेट किया गया: 6 मिनट में पढ़ें
इस पेज पर
आप लगभग किसी भी AI एजेंट को उसे दोबारा लिखे बिना WhatsApp से कनेक्ट कर सकते हैं। अपना एजेंट, जो LangGraph, Google ADK, CrewAI या आपके अपने कोड से बना हो, HTTPS एंडपॉइंट के पीछे चलाएँ, फिर MonoChat में उसे कस्टम प्रदाता के साथ AI हार्नेस के रूप में जोड़ें: एक एंडपॉइंट URL और एक शेयर्ड सीक्रेट। फ़्लो में AI एजेंट नोड रखें, अपना WhatsApp नंबर कनेक्ट करें, और आपका एजेंट WhatsApp और MonoChat से जुड़े हर दूसरे चैनल पर ग्राहकों को जवाब देता है, शेयर्ड इनबॉक्स और इंसानी हैंडओवर के साथ।
यह गाइड उन टीमों के लिए है जिनके पास पहले से एजेंट है, या जो चाहती हैं कि वह कैसे काम करे इस पर पूरा नियंत्रण रहे। इसमें बताया गया है कि अपना एजेंट लाना कब सही है, आपका एंडपॉइंट किसके लिए ज़िम्मेदार है, MonoChat में सेटअप, और प्रोडक्शन में मायने रखने वाले विवरण।
अपना एजेंट क्यों लाएँ?
ज़्यादातर कस्टमर मैसेजिंग प्लैटफ़ॉर्म एक बिल्ट-इन AI एजेंट के साथ आते हैं। यह सुविधाजनक है, जब तक:
- आपका एजेंट पहले से बना है। आपके डेवलपर ने LangGraph ग्राफ़ या ADK मल्टी-एजेंट सेटअप पर महीनों लगाए हैं, इवैल्युएशन और टेस्ट के साथ। उसे किसी वेंडर के बॉट बिल्डर में दोबारा बनाना उस मेहनत को फेंक देना है।
- आपको अपना लॉजिक चाहिए। कीमत के नियम, पात्रता जाँच, कंप्लायंस चरण या आंतरिक सिस्टम जहाँ सिर्फ़ आपका कोड पहुँच सकता है।
- आप फ़्रेमवर्क खुद चुनना चाहते हैं। फ़्रेमवर्क तेज़ी से बदलते हैं। आज LangGraph है; अगले साल कुछ और हो सकता है। आपके चैनल और इनबॉक्स को उसके साथ बदलना नहीं चाहिए।
- डेटा आपके पास रहना चाहिए। कुछ संगठन चाहते हैं कि एजेंट की रीज़निंग और टूल कॉल उनके अपने इन्फ़्रास्ट्रक्चर पर चलें।
MonoChat का Agent Harness इसी के लिए बना है: अपना एजेंट फ़्रेमवर्क लाएँ और उसके आसपास सब कुछ, चैनल, इनबॉक्स, लोग, एक ही जगह रखें।
कस्टम हार्नेस कैसे काम करता है
इसे काम के बँटवारे की तरह समझें।
MonoChat बातचीत की लेयर संभालता है:
- WhatsApp, Instagram, Messenger, TikTok, Telegram, वेब चैट, SMS और वॉयस से आधिकारिक कनेक्शन (MonoChat एक आधिकारिक Meta Business Partner है)।
- वह फ़्लो जो तय करता है कि एजेंट को कब बुलाया जाए, AI एजेंट नोड के ज़रिए।
- शेयर्ड टीम इनबॉक्स, जहाँ कोई इंसान पूरी हिस्ट्री के साथ कमान संभाल सकता है।
आपका एंडपॉइंट एजेंट संभालता है:
- MonoChat से बातचीत पाना।
- आपका एजेंट चलाना: उसकी रीज़निंग, उसके टूल, उसकी मेमोरी।
- एजेंट का जवाब लौटाना।
दोनों के बीच एक शेयर्ड सीक्रेट है, एक मान जो दोनों पक्ष जानते हैं, ताकि आपका एंडपॉइंट सत्यापित कर सके कि अनुरोध आपके MonoChat अकाउंट से आया है। आपका एंडपॉइंट जो अनुरोध और जवाब का फ़ॉर्मैट लागू करता है, उसे MonoChat तय करता है; अगर वह अभी आपके पास नहीं है, तो हमसे बात करें और हम उसे आपके डेवलपर के साथ साझा करेंगे।
आपका एंडपॉइंट क्या करे
आप कोई भी फ़्रेमवर्क इस्तेमाल करें, प्रोडक्शन-तैयार एजेंट एंडपॉइंट के कुछ काम होते हैं।
हर अनुरोध सत्यापित करें
हर कॉल पर शेयर्ड सीक्रेट जाँचें और जो मेल न खाए उसे ख़ारिज करें। सीक्रेट को कोड में नहीं, अपने सीक्रेट मैनेजर या एनवायरनमेंट वेरिएबल में रखें, और कभी उजागर हो जाए तो उसे बदल दें।
हर बातचीत को अलग रखें
ग्राहक एक साथ लिखते हैं। पक्का करें कि आपके एजेंट की स्टेट, मेमोरी और कोई भी वर्किंग फ़ाइल एक ही बातचीत तक सीमित हो, ताकि एक ग्राहक की जानकारी दूसरे के जवाब में न पहुँचे।
चैट के आकार के मैसेज में जवाब दें
वेब ऐप के लिए बने एजेंट आम तौर पर लंबे, फ़ॉर्मैट किए जवाब लिखते हैं। WhatsApp फ़ोन पर पढ़ा जाता है। अपने एजेंट से छोटे मैसेज माँगें, एक बार में एक सवाल, और जवाबों में भारी Markdown न रखें।
साफ़ तौर पर फ़ेल हों, चुपचाप नहीं
अगर कोई टूल टाइम आउट हो जाए या आपका मॉडल प्रदाता एरर लौटाए, तो अधूरे जवाब के बजाय साफ़ विफलता लौटाएँ। अनुमानित विफलता फ़्लो को सही काम करने देती है, जैसे बातचीत किसी इंसान को सौंप देना।
तेज़ रहें
ग्राहक सेकंड के भीतर जवाब की उम्मीद करते हैं। जहाँ हो सके, लंबे चलने वाले काम को जवाब के रास्ते से बाहर रखें, और अपने टूल तेज़ या असिंक्रोनस बनाएँ।
MonoChat में चरण-दर-चरण
1. अपना एजेंट HTTPS के पीछे डिप्लॉय करें
अपना LangGraph, ADK, CrewAI या कस्टम एजेंट अपने सर्वर या क्लाउड पर होस्ट करें, जो HTTPS पर पहुँच योग्य हो। MonoChat का अनुरोध और जवाब का फ़ॉर्मैट और शेयर्ड-सीक्रेट जाँच लागू करें।
2. कस्टम प्रदाता के साथ AI हार्नेस जोड़ें
MonoChat में AI हार्नेस जोड़ें, कस्टम चुनें और अपना एंडपॉइंट URL और शेयर्ड सीक्रेट दर्ज करें। हार्नेस आप एक बार जोड़ते हैं और जितने चाहें उतने फ़्लो में इस्तेमाल कर सकते हैं।
3. फ़्लो में AI एजेंट नोड जोड़ें
आने वाली बातचीत पाने वाले फ़्लो में AI एजेंट नोड जोड़ें और अपना कस्टम हार्नेस चुनें। उसके आसपास के फ़्लो का इस्तेमाल वहाँ करें जहाँ फ़्लो सबसे अच्छे हैं: अभिवादन, भाषा या विषय के हिसाब से रूटिंग, काम के घंटे, और इंसान तक का रास्ता।
4. हर रन के लिए बजट तय करें
हर AI एजेंट नोड हर रन की बजट सीमा सपोर्ट करता है। उन्हें अपने कोड में पहले से लागू सीमाओं के साथ सुरक्षा जाल की तरह इस्तेमाल करें।
5. WhatsApp और दूसरे चैनल कनेक्ट करें
अपना WhatsApp Business नंबर कनेक्ट करें, फिर वही फ़्लो अपने दूसरे चैनल से जोड़ें। हर चैनल के लिए कोई अतिरिक्त इंटीग्रेशन काम नहीं: आपका एंडपॉइंट बातचीत देखता है, चैनल API नहीं।
6. टेस्ट करें, फिर लाइव करें
असली ग्राहक मैसेज फ़्लो में दोबारा चलाएँ। टूल कॉल, जवाब का समय, लहजा और हैंडओवर जाँचें। लाइव ट्रैफ़िक के पहले दिनों पर क़रीबी नज़र रखें, फिर एजेंट को जो करने की अनुमति है उसे बढ़ाएँ।
फ़्रेमवर्क के बारे में नोट
LangGraph. नोड और एज का ग्राफ़ सपोर्ट यात्राओं (ट्रायज, लुकअप, समाधान, एस्केलेट) के लिए स्वाभाविक रूप से फ़िट बैठता है। कम्पाइल किए ग्राफ़ को एक छोटी HTTP सर्विस में लपेटें, हर अनुरोध पर बातचीत की स्टेट लोड करें और अंतिम मैसेज लौटाएँ।
Google ADK. ADK के मल्टी-एजेंट ट्री, यानी कोऑर्डिनेटर और विशेषज्ञ सब-एजेंट, सपोर्ट, सेल्स और बिलिंग टीमों से अच्छी तरह मेल खाते हैं। रूट एजेंट को अपने एंडपॉइंट से उपलब्ध कराएँ और रूटिंग ADK को अंदर करने दें।
CrewAI. भूमिका-आधारित एजेंट के क्रू उन कामों के लिए अच्छे हैं जिनमें साफ़ हैंड-ऑफ़ होते हैं, जैसे पहले रिसर्च फिर जवाब। चैट के लिए क्रू छोटे रखें: हर अतिरिक्त एजेंट देरी बढ़ाता है।
आपका अपना कोड। मॉडल API और कुछ फ़ंक्शन वाला सादा लूप अक्सर काफ़ी होता है। आपके पास पूरा नियंत्रण रहता है, और MonoChat आपको चैनल और इनबॉक्स देता है।
हैंडओवर: इसे फ़्लो में तय करें
फ़्लो में तय करें कि कौन-सी बातचीत किसी इंसान के पास जाए और कौन-सी टीम उन्हें पाए, और अपना एजेंट ऐसा लिखें कि जब वह मदद न कर सके तो अंदाज़ा लगाने के बजाय ग्राहक को ईमानदारी से बताए। फिर फ़्लो बातचीत पूरी हिस्ट्री के साथ शेयर्ड इनबॉक्स में सही टीम को सौंपता है। WhatsApp की Business Messaging Policy भी अपेक्षा करती है कि ऑटोमेटेड जवाब इंसान तक पहुँचने का साफ़ रास्ता दें।
अपने एजेंट को अपने बिज़नेस के भीतर भी रखें। 15 जनवरी 2026 से WhatsApp सामान्य-उद्देश्य AI असिस्टेंट को प्लैटफ़ॉर्म से बाहर रखता है; आपके अपने ग्राहकों की सेवा करने वाले एजेंट ठीक हैं। हमारी WhatsApp AI चैटबॉट पॉलिसी गाइड इस नियम को समझाती है।
अपना बनाना कब ठीक नहीं
कस्टम एजेंट सबसे लचीला विकल्प है और वही है जिसे आप मेंटेन करते हैं। अगर आप शुरू से शुरू कर रहे हैं, तो बिल्ट-इन विकल्प बिना कुछ होस्ट किए आपको जल्दी लाइव कर देता है:
- आपके MonoChat AI मॉडल पर MonoChat का बिल्ट-इन हार्नेस।
- MonoChat के अंदर चलने वाला OpenAI Agents SDK (गाइड)।
- MonoChat के एजेंट रनर पर चलने वाले Claude Agent SDK या Pi (Claude गाइड)।
- होस्टेड एजेंट: अपनी कुंजी के साथ OpenAI Agents API या Claude Managed Agents।
क्योंकि हर विकल्प वही AI एजेंट नोड इस्तेमाल करता है, आप एक से शुरू करके बाद में अपने चैनल या हैंडओवर को छुए बिना अपने एजेंट पर जा सकते हैं। उनकी तुलना Agent Harness पेज पर करें।
इसे MonoChat के साथ अमल में लाएँ