AI एजेंट के लिए WhatsApp एपीआई: Tech Provider बने बिना कुछ मिनटों में आधिकारिक एक्सेस
AI एजेंट को Meta के Cloud API के ज़रिए WhatsApp का आधिकारिक एक्सेस मिलता है, और WhatsApp Business ऐप में बना रहने वाला नंबर किसी Tech Provider या Solution Partner के ज़रिए इसमें जुड़ता है। आप खुद Tech Provider बन सकते हैं, जिसके लिए कारोबार की पुष्टि, App Review के वीडियो और Embedded Signup बिल्ड चाहिए, या ऐसे प्रदाता से जुड़ सकते हैं जो पहले से यह दर्जा रखता है: नंबर मिनटों में जुड़ जाता है और एजेंट को MCP टूल या API क्रेडेंशियल मिल जाते हैं।
easyCoexistence एक स्वतंत्र Meta Tech Provider है: यह WhatsApp Business नंबर को Coexistence के ज़रिए मिनटों में Cloud API से जोड़ता है, ताकि आपके एजेंट को आधिकारिक एक्सेस मिले और कारोबार के पास ऐप भी बना रहे।
WhatsApp Business ऐप में बने रहने वाले नंबर को जोड़ने वाले से Meta की शर्त: Tech Provider या Solution Partner का दर्जा।
App Review एक वीडियो माँगता है जिसमें आपके ऐप से मैसेज भेजा जाए, और एक वीडियो जिसमें आपका ऐप टेम्पलेट बनाए।
App Review whatsapp_business_messaging और whatsapp_business_management की अनुमति देता है, जो Tech Provider बनने के लिए दोनों ज़रूरी हैं।
जब Meta ने Embedded Signup v2 और v3 को अप्रचलित घोषित किया और इंटीग्रेशन से v4 पर जाने को कहा।
WhatsApp Business ऐप और Cloud API, दोनों में इस्तेमाल होने वाले नंबर की तय थ्रूपुट सीमा।
जब कोई प्लेटफ़ॉर्म Partner API से ग्राहक का नंबर जोड़ता है, तो होस्टेड कनेक्ट लिंक कितनी देर तक मान्य रहता है।
AI एजेंट को WhatsApp आधिकारिक रूप से इस्तेमाल करने के लिए क्या चाहिए?
Meta के Cloud API से चार चीज़ें। एक फ़ोन नंबर ID और whatsapp_business_messaging अनुमति वाला एक्सेस टोकन, ताकि एजेंट messages एंडपॉइंट को कॉल कर सके। एक वेबहुक एंडपॉइंट जहाँ Meta आने वाले मैसेज भेजता है, और ऐप के साथ साझा नंबर पर smb_message_echoes, यानी वे जवाब जो कोई व्यक्ति फ़ोन पर टाइप करता है। स्वीकृत टेम्पलेट, क्योंकि टाइप किया गया मैसेज सिर्फ़ उसी तक पहुँचता है जिसने पिछले 24 घंटों में लिखा हो। और यह जानने का तरीका कि कनेक्शन कब टूटता है, क्योंकि एपीआई की तरफ़ से काम बंद हो जाने पर भी फ़ोन पर ऐप चलता रहता है।
वह शॉर्टकट जिसे लोग सबसे पहले ढूँढते हैं, WhatsApp Web ऑटोमेशन है, जो लिंक किए गए डिवाइस के रूप में लॉग इन करता है। यह WhatsApp की शर्तों का उल्लंघन है, और उसके ऊपर एजेंट कुछ भी करे, नंबर पर बैन का जोखिम बना रहता है।
Tech Provider रास्ते में क्या शामिल है?
Meta का अपना क्रम, इसी क्रम में। हर चरण मुफ़्त है, और किसी भी चरण को पैसे देकर तेज़ नहीं करवाया जा सकता: समीक्षाएँ Meta के शेड्यूल पर चलती हैं और Meta कोई समय-सीमा प्रकाशित नहीं करता, इसलिए पहले ग्राहक का नंबर जुड़ने तक दिनों की नहीं, हफ़्तों की योजना बनाएँ। इसके बाद बैकएंड को चलते रहना होता है: हर साइनअप के बाद टोकन एक्सचेंज, एक वेबहुक रिसीवर, हर नंबर के हिसाब से रूटिंग, और कनेक्शन टूटने की निगरानी, जैसे Meta का 14 दिन की निष्क्रियता वाला नियम।
छोटा रास्ता कौन सा है?
किसी ऐसे प्रदाता के ज़रिए नंबर जोड़ें जो यह प्रक्रिया पहले ही पूरी कर चुका है। easyCoexistence के साथ कारोबार Meta का Embedded Signup चलाता है और WhatsApp Business ऐप से कोड स्कैन करता है, जिसमें लगभग दो मिनट लगते हैं। नंबर कारोबार के अपने Business Portfolio में Cloud API से जुड़ जाता है, जबकि ऐप चलता रहता है। फिर एजेंट को उस रूप में एक्सेस मिलता है जिसमें वह काम करता है: ChatGPT, Claude, Claude Code या Codex जैसे असिस्टेंट के लिए MCP टूल, या आपके चलाए कोड के लिए नंबर के क्रेडेंशियल और वेबहुक।
| Connect through easyCoexistence | Become a Tech Provider | |
|---|---|---|
| Meta app and App Review | Not needed: the number joins through ours | Yours to build and pass |
| Embedded Signup | Hosted, with the QR scan in the app | You integrate version 4 and host the flow |
| First number connected | Minutes after signing up | After verification and review |
| Webhook trust | A secret in your URL, or X-EC-Signature on forwarded messages | Your app secret signs Meta's deliveries |
| Disconnection alerts | Every number watched 24/7, 14-day rule included | Monitoring you build and run |
| Who owns the WhatsApp Business Account | The business, in its own portfolio | The business |
एजेंट को नंबर के क्रेडेंशियल कैसे मिलते हैं?
get_api_credentials के ज़रिए, या डैशबोर्ड में नंबर के पेज से। यह टूल Graph API का बेस यूआरएल, WhatsApp Business Account ID, फ़ोन नंबर ID, सेंड एंडपॉइंट और, अगर मौजूद हो, कारोबार का अपना एक्सेस टोकन लौटाता है, जो उसकी WhatsApp संपत्तियों तक सीमित रहता है। अगर कोई क्लाइंट टोकन जारी नहीं हुआ, तो टोकन null आता है और साथ में एक नोट होता है कि डैशबोर्ड से नंबर को दोबारा कनेक्ट करने पर टोकन जारी होगा, और जो टोकन काम कर रहा है उसे बदला नहीं जाएगा। कोई ऐप सीक्रेट लेने की ज़रूरत नहीं, क्योंकि Meta वेबहुक को easyCoexistence के ऐप सीक्रेट से साइन करता है, जो कभी साझा नहीं होता। टूल के लिए सक्रिय प्लान चाहिए, क्योंकि यह टोकन मैसेज भेज सकता है।
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511999998888",
"type": "text",
"text": { "body": "Your order #1042 is ready for pickup." }
}'आने वाले मैसेज एजेंट तक कैसे पहुँचते हैं?
हर नंबर के दो मोड हैं, जो set_inbound_mode से या नंबर के पेज पर बदले जाते हैं। सीधे आपके सर्वर पर: set_webhook_destination Meta को सीधे आपके HTTPS एंडपॉइंट पर भेजता है, जिसे Meta के GET हैंडशेक का जवाब देना होगा, और easyCoexistence मैसेज कभी नहीं देखता, इसलिए ऑटोमेशन बंद रहते हैं। चूँकि Meta उन डिलीवरी को हमारे ऐप सीक्रेट से साइन करता है, यूआरएल पाथ में एक लंबा रैंडम सीक्रेट रखें और उसके बिना आने वाले अनुरोध अस्वीकार करें।
ऑटोमेशन चालू: Meta मैसेज easyCoexistence तक पहुँचाता है, ऑटोमेशन जवाब दे सकते हैं, और एक वैकल्पिक फ़ॉरवर्ड यूआरएल को Meta का मूल पेलोड "value" के अंतर्गत मिलता है, जो X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 of "<t>.<body>"> से साइन होता है, और सीक्रेट सिर्फ़ एक बार दिखाया जाता है। ऑटोमेशन का Call my वेबहुक स्टेप भी मैसेज और चैट के आख़िरी 10 मैसेज आपके एजेंट को भेजता है, और आपका जवाब 20 सेकंड के भीतर {"reply": "..."} के रूप में आए तो उसे भेज देता है।
एजेंट को किन सीमाओं का पालन करना होगा?
Meta की सीमाएँ, और वे किसी भी प्रदाता के ज़रिए एक जैसी हैं। जो एजेंट इन्हें पहले से जानता है, वह उन विफलताओं से बचता है जो बग जैसी दिखती हैं:
- Meta ने WhatsApp Business ऐप के साथ साझा नंबरों के लिए प्रति नंबर 20 मैसेज प्रति सेकंड की सीमा तय की है।
- टाइप किए गए मैसेज केवल ग्राहक के आख़िरी मैसेज के 24 घंटों के भीतर; उसके बाद स्वीकृत टेम्पलेट।
- टेम्पलेट केवल एपीआई से जाते हैं, क्योंकि Coexistence नंबर पर ऐप टेम्पलेट नहीं भेज सकता।
- कोई व्यक्ति ऐप में जो जवाब टाइप करता है, वह
smb_message_echoesके रूप में आता है; उस चैट पर एजेंट को रोकें, नहीं तो ग्राहक को दो जवाब मिलेंगे। - ग्रुप चैट एपीआई से सिंक नहीं होतीं, इसलिए एजेंट सिर्फ़ एक-पर-एक चैट में काम करता है।
- कॉन्टैक्ट और एक-पर-एक चैट के अधिकतम 6 महीने एक बार इंपोर्ट होते हैं, और केवल तब जब कनेक्शन के 24 घंटों के भीतर सीधा वेबहुक डेस्टिनेशन सेव किया गया हो; जिस नंबर पर ऑटोमेशन चालू है, उसे यह इंपोर्ट नहीं मिलता।
- वॉइस और वीडियो कॉल ऐप में चलते रहते हैं, लेकिन Cloud API, Coexistence नंबर पर कॉल नहीं ले जाता, इसलिए एजेंट टेक्स्ट में काम करता है।
क्या कोई प्लेटफ़ॉर्म अपने ग्राहकों के नंबर इस तरह जोड़ सकता है?
हाँ, Partner API के ज़रिए, जिससे कोई SaaS या एजेंसी अपने Tech Provider दर्जे के बिना ग्राहकों को जोड़ती है। create_api_key से कुंजी बनाएँ (यह ec_live_ से शुरू होती है और एक बार दिखती है), फिर अपने बैकएंड से POST /api/v1/connect-sessions कॉल करें, या असिस्टेंट से create_connect_link, ताकि 1 घंटे के लिए मान्य होस्टेड लिंक मिले। ग्राहक वहाँ Meta का पॉपअप और QR स्कैन करता है और connection_id के साथ आपके redirect_url पर लौट आता है। फिर GET /api/v1/connections/:id?credentials=1 ग्राहक का अपना टोकन लौटाता है, और connection.disconnected जैसे स्टेटस इवेंट X-EC-Signature से साइन होकर आते हैं। हर नंबर का बिल आपके खाते पर उन्हीं प्रति-नंबर बैंड के हिसाब से बनता है।
आम गड़बड़ियाँ
- X-Hub-Signature-256 को सीधे डेस्टिनेशन पर वैलिडेट करना। Meta easyCoexistence के ऐप सीक्रेट से साइन करता है, जो कभी साझा नहीं होता, इसलिए असली डिलीवरी भी जाँच में फ़ेल होती हैं; यूआरएल में एक लंबे रैंडम सीक्रेट पर भरोसा करें, या X-EC-Signature वाले फ़ॉरवर्डिंग का उपयोग करें।
- n8n के WhatsApp Trigger नोड से रिसीव करना। वह आपका अपना Meta ऐप अपेक्षित करता है; इसके बजाय सामान्य वेबहुक नोड का उपयोग करें, जिसके यूआरएल में एक सीक्रेट हो।
- smb_message_echoes को नज़रअंदाज़ करना। तब एजेंट ऐसे व्यक्ति के ऊपर जवाब देता है जिसने पहले ही फ़ोन से जवाब दे दिया है, और ग्राहक को दो जवाब दिखते हैं।
- कनेक्ट करने के कई दिन बाद सीधा वेबहुक डेस्टिनेशन सेव करना, या नंबर को ऑटोमेशन पर छोड़ देना। Meta का एक बार का कॉन्टैक्ट और अधिकतम 6 महीने की चैट का इंपोर्ट, कनेक्शन के 24 घंटों के भीतर सेव किए गए सीधे डेस्टिनेशन की माँग करता है।
एजेंट 30 से अधिक MCP टूल के ज़रिए या हर नंबर के क्रेडेंशियल और वेबहुक के ज़रिए काम करता है, और हर नंबर अलर्ट के साथ 24/7 निगरानी में रहता है। US$ 9 से घटकर US$ 0.75 प्रति नंबर प्रति माह, नंबर बढ़ने के साथ कम होते हुए, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या मुझे अपना Meta ऐप चाहिए?
नहीं। नंबर easyCoexistence के Meta ऐप से जुड़ता है और कारोबार के अपने Business Portfolio और WhatsApp Business खाते में रहता है। आपका कोड get_api_credentials से मिले कारोबार के अपने टोकन से भेजता है, इसलिए आपका कोई ऐप शामिल नहीं होता, जब तक आप बाद में कोई न बनाएँ।
क्या एजेंट और टीम एक साथ नंबर इस्तेमाल कर सकते हैं?
हाँ। Meta, Cloud API और WhatsApp Business ऐप के बीच मैसेज मिरर करता है, इसलिए एजेंट जो भेजता है वह फ़ोन पर ऐप की चैट थ्रेड में दिखता है, और टीम जो ऐप में टाइप करती है वह smb_message_echoes के रूप में आपके सिस्टम तक पहुँचता है।
कौन से एजेंट फ़्रेमवर्क इसके साथ काम करते हैं?
HTTP पर OAuth के साथ MCP बोलने वाला कोई भी क्लाइंट, जैसे ChatGPT, Claude, Claude Code, Codex और Cursor, और Meta के Graph API को कॉल करने वाला कोई भी कोड: Node.js, Python, n8n, LangChain, OpenAI Agents SDK या Vercel AI SDK। इसके नीचे का एपीआई Meta का अपना है, इसलिए एजेंट के भीतर कुछ भी मालिकाना नहीं है।
क्या WhatsApp पर सामान्य-उद्देश्य वाले AI असिस्टेंट की अनुमति है?
Meta की Business Solution Terms की धारा 4.7 उन प्रदाताओं को रोकती है जो सामान्य-उद्देश्य AI असिस्टेंट WhatsApp Business Platform पर पेश करते हैं, जहाँ AI मुख्य कार्यक्षमता हो, जैसा Meta तय करे, और यह 15 जनवरी 2026 से लागू है। जो कारोबार अपने ग्राहकों के लिए AI इस्तेमाल करता है, सहायता, बिक्री या बुकिंग के लिए, वह इसका लक्ष्य नहीं है, और EU और ब्राज़ील के नियामकों ने Meta को प्रतिस्पर्धी असिस्टेंट के लिए इस नियम को निलंबित या वापस लेने का आदेश दिया है।
पढ़ना जारी रखें
शुरू करने के लिए तैयार हैं?
WhatsApp Coexistence को महीनों में नहीं, मिनटों में कॉन्फ़िगर करें। ऐप्लिकेशन मोबाइल पर काम करता रहता है।
मुफ़्त ट्रायल शुरू करेंइस तारीख को सत्यापित