MCP टूल का संदर्भ
कनेक्टर खाते के हर कनेक्शन के लिए 30 से अधिक टूल उपलब्ध कराता है। WhatsApp के लिए list_numbers पहले आता है, जिसके टूल उससे मिला connection_id लेते हैं, और अन्य चैनलों के लिए list_social_accounts, जिनके टूल account_id लेते हैं। बिलिंग रुकने पर छह टूल बंद हो जाते हैं: बाहरी दुनिया पर असर डालने वाले WhatsApp के चार टूल, access token लौटाने वाला get_api_credentials और create_connect_link। बाकी खुले रहते हैं।
कनेक्टर द्वारा उपलब्ध कराए गए टूल।
बिलिंग रुकने पर बंद होने वाले टूल, access token लौटाने वाले get_api_credentials समेत।
OAuth से साइन-इन, खाते के हर नंबर के लिए।
हर टूल क्या करता है?
पढ़ना: list_numbers कनेक्ट किए गए नंबरों को उनके स्टेटस, गुणवत्ता रेटिंग और मैसेजिंग टियर के साथ लौटाता है। हर दूसरी कॉल यहीं से शुरू होती है। get_number_health लाइव Meta स्नैपशॉट के साथ हाल की मॉनिटरिंग टाइमलाइन, वेबहुक इवेंट और पोलर जाँचें एक साथ लौटाता है। get_api_credentials Graph एपीआई का बेस यूआरएल, WABA आईडी, फ़ोन नंबर आईडी और, जहाँ उपलब्ध हो, खाते का अपना टोकन लौटाता है।
भेजना: send_message 24 घंटे की विंडो के भीतर फ़्री टेक्स्ट भेजता है, जहाँ जवाब मुफ़्त होते हैं। send_template एक स्वीकृत टेम्पलेट भेजता है। इसी तरह ऐसे व्यक्ति के साथ बातचीत शुरू की जाती है जिसने अभी तक कुछ नहीं लिखा है। list_templates, create_template और get_template_status टेम्पलेट के पूरे जीवनचक्र को संभालते हैं।
कनेक्शन: set_webhook_destination आने वाले मैसेज और ऐप के जवाब आपके सिस्टम तक पहुँचाता है। null भेजने पर यह फिर से रीसेट हो जाता है। get_connect_link नया नंबर कनेक्ट करने के लिए डैशबोर्ड लिंक और चरण लौटाता है। get_docs प्रोडक्ट दस्तावेज़ को markdown के रूप में लौटाता है।
Partner API, उन सॉफ़्टवेयर या एजेंसियों के लिए जिनके अपने ग्राहक नंबर जोड़ते हैं: get_partner_setup बिलिंग, API key, events URL और अगला कदम दिखाता है। create_api_key Partner API key जारी करता है और उसे सिर्फ़ एक बार दिखाता है, और साफ़ पुष्टि के बिना मौजूदा key को नहीं बदलता। revoke_api_key उसे रद्द करता है, वह भी पुष्टि के बाद ही। set_partner_events_url तय करता है कि status events कहाँ जाएँ और signing secret एक बार लौटाता है। create_connect_link एक ग्राहक के लिए 1 घंटे तक मान्य hosted connect link बनाता है, ठीक POST /api/v1/connect-sessions की तरह।
connection_id क्यों महत्वपूर्ण है?
क्योंकि यही किसी निर्देश को किसी खास नंबर से जोड़ता है, और असिस्टेंट इसका अनुमान नहीं लगा सकता।
नंबर पर काम करने वाला हर टूल connection_id लेता है, और list_numbers ही वह एकमात्र जगह है जहाँ से यह मिलता है। व्यवहार में इसका मतलब है कि मैसेज भेजने के लिए कहे जाने पर असिस्टेंट पहले list_numbers कॉल करेगा। इसी कारण सेशन का पहला अनुरोध अक्सर बाकी अनुरोधों से धीमा होता है।
इसका यह भी मतलब है कि कई नंबर वाले खाते में कोई भ्रम नहीं रहता। कोई डिफ़ॉल्ट नंबर या छिपा हुआ चयन नहीं होता, इसलिए जिस नंबर के बारे में निर्देश दिया गया है, उसे पूछा जाता है, उसका अनुमान नहीं लगाया जाता।
बिलिंग रुकने पर क्या होता है?
छह टूल बंद हो जाते हैं: बाहरी दुनिया पर असर डालने वाले send_message, send_template, create_template और set_webhook_destination; get_api_credentials, क्योंकि यह खाते का access token लौटाता है, जिससे रुका हुआ खाता सीधे Graph API से भेज सकता था; और नया नंबर जोड़ने वाला create_connect_link। बाकी सब कुछ पढ़ने की सुविधा उपलब्ध रहती है, और Partner API सेटअप भी: get_partner_setup, create_api_key, revoke_api_key और set_partner_events_url।
यह जानबूझकर किया गया है, कोई चूक नहीं। जो खाता यह नहीं देख सकता कि वह क्यों अवरुद्ध है या उसके नंबर ठीक हैं या नहीं, उसके पास सहायता अनुरोध के अलावा वापस आने का कोई रास्ता नहीं होगा। यही पढ़ने वाली सुविधाएँ स्वास्थ्य मॉनिटरिंग पर भी निर्भर हैं, इसलिए उन्हें बंद करने से मॉनिटरिंग उसी समय रुक जाएगी जब उसकी सबसे अधिक ज़रूरत हो।
व्यवहारिक असर यह है कि बिलिंग रुका हुआ खाता अपनी स्थिति से जुड़े सवालों के जवाब देता रहता है और उसकी मॉनिटरिंग जारी रहती है। रुकता केवल वह काम है जो किसी ग्राहक तक पहुँचता है।
आम गड़बड़ियाँ
- कनेक्टर से मैसेज प्राप्त होने की उम्मीद करना। MCP अनुरोध और जवाब पर काम करता है; आने वाले ट्रैफ़िक के लिए वेबहुक चाहिए।
- connection_id को पहले से लिखकर रखना। यह list_numbers से मिलता है और इसे स्थायी मान के रूप में दर्ज नहीं करना चाहिए।
- यह मान लेना कि बिलिंग रुका हुआ खाता पूरी तरह ऑफ़लाइन है। पढ़ना और मॉनिटरिंग जानबूझकर जारी रहती है, सिवाय क्रेडेंशियल्स के, जिनमें भेजने वाला एक्सेस टोकन होता है।
एक कनेक्टर खाते के हर नंबर को कवर करता है। OAuth से अनुमति मिलती है और कोई कुंजी चिपकाने की ज़रूरत नहीं। हर नंबर के लिए US$ 9 प्रति माह से शुरू होकर नंबर जोड़ने के साथ US$ 0.75 तक, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या मुझे चुनना होगा कि कौन सा टूल कॉल करना है?
नहीं। आप सामान्य भाषा में पूछते हैं और असिस्टेंट टूल चुनता है। टूल के विवरण इसी काम के लिए लिखे गए हैं।
क्या यह मेरी बातचीत पढ़ सकता है?
नहीं। आने वाले मैसेज आपके चुने हुए वेबहुक डेस्टिनेशन तक पहुँचते हैं। कनेक्टर खाते और नंबर की स्थिति पढ़ता है।
क्या get_docs उपयोगी है?
जितना सुनने में लगता है, उससे अधिक। यह असिस्टेंट को हमारा दस्तावेज़ markdown में देता है, इसलिए Coexistence के नियमों से जुड़े जवाब याददाश्त के बजाय हमारे दस्तावेज़ों से आते हैं।
क्या एक कनेक्टर कई क्लाइंट को कवर करता है?
हाँ। एक खाते में जितने चाहें उतने नंबर रखे जा सकते हैं और list_numbers उन सभी को लौटाता है।
पढ़ना जारी रखें
शुरू करने के लिए तैयार हैं?
WhatsApp Coexistence को महीनों में नहीं, मिनटों में कॉन्फ़िगर करें। ऐप्लिकेशन मोबाइल पर काम करता रहता है।
मुफ़्त ट्रायल शुरू करेंइस तारीख को सत्यापित