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 द्वारे ग्राहकाचा नंबर जोडताना होस्ट केलेली कनेक्ट लिंक किती काळ वैध राहते.
अधिकृतपणे WhatsApp वापरण्यासाठी AI एजंटला काय लागते?
Meta च्या Cloud API कडून चार गोष्टी लागतात. पहिली, फोन नंबर ID आणि whatsapp_business_messaging परवानगी असलेला ॲक्सेस टोकन, जेणेकरून एजंट messages एंडपॉइंट कॉल करू शकेल. दुसरी, येणारे मेसेज Meta जिथे पाठवते तो वेबहुक एंडपॉइंट; ॲपसोबत शेअर केलेल्या नंबरवर, फोनवर टाइप केलेल्या उत्तरांसाठी smb_message_echoes देखील. तिसरी, मंजूर टेम्प्लेट्स, कारण टाइप केलेला मेसेज फक्त गेल्या 24 तासांत लिहिलेल्या व्यक्तीलाच पोहोचतो. आणि चौथी, कनेक्शन कधी तुटते ते कळण्याची सोय, कारण API बाजू थांबली तरी फोनवरील ॲप चालूच राहते.
लोक सर्वात आधी शोधतात तो शॉर्टकट म्हणजे 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 बेस URL, WhatsApp Business Account ID, फोन नंबर ID, पाठवण्याचा एंडपॉइंट आणि, असल्यास, व्यवसायाचा स्वतःचा ॲक्सेस टोकन परत करते; हा टोकन फक्त व्यवसायाच्या WhatsApp संसाधनांपुरता मर्यादित असतो. कोणतेही क्लायंट टोकन जारी केले नसल्यास टोकन null म्हणून परत येते, आणि त्यासोबत एक नोंद असते की डॅशबोर्डवरून नंबर पुन्हा कनेक्ट केल्यास टोकन जारी होतो, पण चालणारा टोकन बदलला जात नाही. मिळवण्यासारखे कोणतेही app secret नाही, कारण Meta वेबहुक easyCoexistence च्या app secret ने साइन करते, जो कधीही शेअर केला जात नाही. टोकन पाठवू शकत असल्यामुळे हे टूल सक्रिय प्लॅनची मागणी करते.
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 ही डिलिव्हरी आमच्या app secret ने साइन करत असल्यामुळे, URL path मध्ये एक लांब यादृच्छिक सिक्रेट ठेवा आणि त्याशिवाय आलेल्या विनंत्या नाकारा.
ऑटोमेशन चालू: Meta easyCoexistence ला डिलिव्हर करते, ऑटोमेशन उत्तर देऊ शकतात, आणि एक पर्यायी Forward URL Meta चा मूळ पेलोड "value" या नावाखाली मिळवते, X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 of "<t>.<body>"> ने साइन केलेला, आणि सिक्रेट एकदाच दाखवले जाते. ऑटोमेशनमधील “Call my webhook” स्टेप मेसेज आणि चॅटचे शेवटचे 10 मेसेजही तुमच्या एजंटला देते, आणि तुमचे उत्तर {"reply": "..."} स्वरूपात 20 सेकंदांच्या आत आल्यास ते उत्तर पाठवते.
एजंटने कोणत्या मर्यादा पाळायच्या आहेत?
Meta च्या मर्यादा, आणि त्या कोणत्याही प्रदात्यामार्फत सारख्याच असतात. त्या आधीच माहीत असल्यास एजंट बगसारखे वाटणारे अपयश टाळतो:
- प्रति नंबर प्रति सेकंद 20 मेसेज, WhatsApp Business ॲपसोबत शेअर केलेल्या नंबरसाठी Meta ने निश्चित केलेले.
- टाइप केलेले मेसेज फक्त ग्राहकाच्या शेवटच्या मेसेजनंतरच्या 24 तासांच्या आत; त्यानंतर मंजूर टेम्प्लेट.
- टेम्प्लेट्स फक्त API द्वारेच पाठवली जातात, कारण Coexistence नंबरवरील ॲप ती पाठवू शकत नाही.
- व्यक्तीने ॲपमध्ये टाइप केलेली उत्तरे
smb_message_echoesम्हणून येतात; त्या चॅटवर एजंट थांबवा, नाहीतर ग्राहकाला दोन उत्तरे मिळतील. - ग्रुप चॅट्स API सोबत सिंक्रोनाइझ होत नाहीत, म्हणून एजंट एकास-एक चॅटमध्ये काम करतो.
- संपर्क आणि एकास-एक चॅटचे जास्तीत जास्त 6 महिने फक्त एकदाच आयात होतात, आणि तेव्हाच जेव्हा कनेक्ट केल्यापासून 24 तासांच्या आत थेट वेबहुक डेस्टिनेशन सेव्ह केले असेल; ऑटोमेशन चालू असलेल्या नंबरला हे आयात मिळत नाही.
- व्हॉइस आणि व्हिडिओ कॉल ॲपमध्ये चालू राहतात, पण Coexistence नंबरवर Cloud API कॉल वाहून नेत नाही, म्हणून एजंट मजकुरात काम करतो.
प्लॅटफॉर्म अशा प्रकारे स्वतःच्या ग्राहकांचे नंबर जोडू शकतो का?
हो, 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 च्या app secret ने साइन करते, जो कधीही शेअर होत नाही, त्यामुळे खरी डिलिव्हरीसुद्धा तपासणीत नापास होते; URL मधील लांब यादृच्छिक सिक्रेटवर विश्वास ठेवा, किंवा X-EC-Signature सह फॉरवर्डिंग वापरा.
- n8n च्या WhatsApp Trigger नोडने प्राप्त करणे. त्याला तुमचे स्वतःचे Meta ॲप अपेक्षित असते; त्याऐवजी URL मध्ये सिक्रेट असलेला सामान्य वेबहुक नोड वापरा.
- smb_message_echoes कडे दुर्लक्ष करणे. मग एजंट अशा व्यक्तीला उत्तर देतो जिने आधीच फोनवरून उत्तर दिलेले असते, आणि ग्राहकाला दोन उत्तरे वाचायला मिळतात.
- कनेक्ट केल्यानंतर अनेक दिवसांनी थेट वेबहुक डेस्टिनेशन सेव्ह करणे, किंवा नंबर ऑटोमेशनवर तसाच ठेवणे. संपर्क आणि 6 महिन्यांपर्यंतच्या चॅट्सचे Meta चे एकदाचे आयात कनेक्शनच्या 24 तासांच्या आत सेव्ह केलेले थेट डेस्टिनेशन मागते.
एजंट 30 पेक्षा जास्त MCP टूल्सद्वारे किंवा प्रत्येक नंबरच्या क्रेडेन्शियल्स आणि वेबहुकद्वारे काम करतो, आणि प्रत्येक नंबर 24/7 मॉनिटर केला जातो आणि अलर्ट मिळतात. US$ 9 ते US$ 0.75 प्रति नंबर प्रति महिना, नंबर वाढवल्यास दर कमी होत जातो, पहिले 3 दिवस मोफत.
वारंवार विचारले जाणारे प्रश्न
मला स्वतःचे Meta ॲप लागते का?
नाही. नंबर easyCoexistence च्या Meta ॲपद्वारे ऑनबोर्ड केला जातो आणि व्यवसायाच्याच Business Portfolio आणि WhatsApp Business Account मध्ये राहतो. तुमचा कोड get_api_credentials मधील व्यवसायाच्या स्वतःच्या टोकनने पाठवतो, त्यामुळे नंतर स्वतः तयार केल्याशिवाय तुमचे कोणतेही ॲप यात नसते.
एजंट आणि टीम एकाच वेळी नंबर वापरू शकतात का?
हो. Meta Cloud API आणि WhatsApp Business ॲप यांच्यात मेसेज मिरर करते, त्यामुळे एजंटने पाठवलेले मेसेज फोनवरील ॲपच्या चॅट थ्रेडमध्ये दिसतात, आणि टीमने ॲपमध्ये टाइप केलेले मेसेज smb_message_echoes म्हणून तुमच्या सिस्टीमपर्यंत पोहोचतात.
कोणते एजंट फ्रेमवर्क यासोबत चालतात?
MCP over HTTP आणि OAuth बोलणारा कोणताही क्लायंट, जसे ChatGPT, Claude, Claude Code, Codex आणि Cursor, आणि Meta च्या Graph API ला कॉल करणारा कोणताही कोड: Node.js, Python, n8n, LangChain, OpenAI Agents SDK किंवा Vercel AI SDK. खालचा API Meta चाच आहे, त्यामुळे एजंटमध्ये कोणतेही मालकीचे तंत्र नसते.
WhatsApp वर सामान्य हेतूचा AI असिस्टंट वापरण्याची परवानगी आहे का?
Meta च्या Business Solution Terms मधील कलम 4.7 ज्या प्रदात्यांकडे सामान्य हेतूचे AI असिस्टंट आहेत त्यांना WhatsApp Business Platform वर ते देण्यास मनाई करते, जिथे AI हीच मुख्य कार्यक्षमता असेल, Meta ठरवेल त्याप्रमाणे, आणि 15 जानेवारी 2026 पासून लागू आहे. स्वतःच्या ग्राहकांसाठी, सपोर्ट, विक्री किंवा बुकिंगसाठी AI वापरणारा व्यवसाय लक्ष्य नाही, आणि EU आणि ब्राझीलमधील नियामकांनी Meta ला प्रतिस्पर्धी असिस्टंटसाठी हा नियम स्थगित करण्याचे किंवा मागे घेण्याचे आदेश दिले आहेत.
पुढे वाचा
सुरुवात करण्यासाठी तयार आहात?
WhatsApp Coexistence काही मिनिटांत सेट करा, काही महिन्यांत नाही. ॲप फोनवर काम करत राहते.
मोफत ट्रायल सुरू करापडताळले: