AI एजेन्टका लागि WhatsApp API: Tech Provider नबनी मिनेटभित्रै आधिकारिक पहुँच
AI एजेन्टले Meta को Cloud API मार्फत आधिकारिक WhatsApp पहुँच पाउँछ, र WhatsApp Business एपमै रहने नम्बर Tech Provider वा Solution Partner मार्फत जोडिन्छ। तपाईं आफैं त्यस्तो बन्न सक्नुहुन्छ, व्यवसाय प्रमाणीकरण, App Review भिडियो र Embedded Signup निर्माणसहित, वा पहिल्यै त्यस्तो भइसकेको प्रदायकमार्फत जडान गर्न सक्नुहुन्छ: नम्बर मिनेटभित्र जोडिन्छ र एजेन्टले MCP टुल वा एपीआई क्रेडेन्सियल पाउँछ।
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 endpoint मा कल गर्न दिन्छ। Meta ले आउने म्यासेज डेलिभर गर्ने वेबहुक एन्डपोइन्ट, र एपसँग साझा नम्बरमा फोनमा टाइप गरिएका जवाफहरूका लागि smb_message_echoes। स्वीकृत टेम्प्लेट चाहिन्छ, किनभने टाइप गरिएको म्यासेज पछिल्लो 24 घण्टामा लेख्ने व्यक्तिलाई मात्र पुग्छ। र कनेक्सन कहिले टुट्छ भन्ने थाहा पाउने उपाय चाहिन्छ, किनभने एपीआई पक्ष रोकिँदा पनि फोनको एप चलिरहन्छ।
सबैभन्दा पहिले मानिसले खोज्ने सर्टकट WhatsApp Web स्वचालन हो, जसले linked device का रूपमा लग इन गर्छ। त्यसले 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, phone number ID, send endpoint र, भएमा, व्यवसायको आफ्नै एक्सेस टोकन फर्काउँछ, जुन त्यसका 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 को पथमा लामो र अनियमित गोप्य राख्नुहोस् र त्यो नभएका अनुरोधहरू अस्वीकार गर्नुहोस्।
अटोमेसन खुला भए: Meta ले easyCoexistence मा डेलिभर गर्छ, अटोमेसनले जवाफ दिन सक्छ, र वैकल्पिक Forward URL ले Meta को मूल पेलोड "value" अन्तर्गत प्राप्त गर्छ, जुन X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 of "<t>.<body>"> ले हस्ताक्षर गरिएको हुन्छ, र गोप्य एक पटक मात्र देखाइन्छ। अटोमेसनको वेबहुक कल चरणले पनि म्यासेज र च्याटका पछिल्ला 10 म्यासेज तपाईंको एजेन्टलाई दिन्छ, र तपाईंको जवाफ 20 सेकेन्डभित्र {"reply": "..."} भएमा त्यसको उत्तर पठाउँछ।
एजेन्टले कुन सीमाहरूको पालना गर्नुपर्छ?
Meta का सीमाहरू हुन्, र ती कुनै पनि प्रदायकमार्फत उस्तै हुन्छन्। ती पहिल्यै जान्ने एजेन्टले बग जस्ता देखिने असफलताहरूबाट बच्छ:
- प्रति नम्बर प्रति सेकेन्ड 20 म्यासेज, WhatsApp Business एपसँग साझा नम्बरका लागि Meta ले तय गरेको।
- ग्राहकले पठाएको पछिल्लो म्यासेजको 24 घण्टाभित्र मात्र टाइप गरिएका म्यासेज; त्यसपछि स्वीकृत टेम्प्लेट।
- टेम्प्लेट एपीआई मार्फत मात्र पठाइन्छन्, किनभने Coexistence नम्बरको एपले तिनलाई पठाउन सक्दैन।
- एपमा व्यक्तिले टाइप गरेका जवाफहरू
smb_message_echoesका रूपमा आउँछन्; त्यस च्याटमा एजेन्ट रोक्नुहोस्, नत्र ग्राहकले दुईवटा जवाफ पाउँछ। - ग्रुप च्याटहरू एपीआई मा सिंक्रोनाइज हुँदैनन्, त्यसैले एजेन्ट एक-से-एक च्याटमा मात्र काम गर्छ।
- सम्पर्कहरू र अधिकतम 6 महिनासम्मका एक-से-एक च्याट एकपटक मात्र आयात हुन्छन्, तर जडान गरेको 24 घण्टाभित्र सिधा वेबहुक गन्तव्य सुरक्षित गरिएमा मात्र।
- भ्वाइस र भिडियो कल एपमा चलिरहन्छन्, तर Cloud API ले Coexistence नम्बरमा कल बोक्दैन, त्यसैले एजेन्ट पाठमा काम गर्छ।
के प्लेटफर्मले आफ्नै ग्राहकका नम्बर यही तरिकाले जोड्न सक्छ?
हो, Partner API मार्फत, जुन SaaS वा एजेन्सीले आफ्नै Tech Provider हैसियत नभई आफ्ना ग्राहक जोड्ने तरिका हो। create_api_key ले एउटा 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 लाई बेवास्ता गर्नु। त्यसो गर्दा एजेन्टले फोनबाट पहिल्यै जवाफ दिइसकेको व्यक्तिमाथि अर्को जवाफ दिन्छ, र ग्राहकले दुईवटा जवाफ पढ्छ।
- जडान गरेको दिनौंपछि सिधा वेबहुक गन्तव्य सुरक्षित गर्नु, वा नम्बरलाई अटोमेसनमा छोड्नु। Meta को एकपटकको आयात (सम्पर्क र 6 महिनासम्मका च्याट) का लागि जडानको 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 का रूपमा तपाईंको प्रणालीमा पुग्छ।
कुन एजेन्ट फ्रेमवर्कहरूले यससँग काम गर्छन्?
OAuth सहित HTTP मा MCP बोल्ने जुनसुकै क्लाइन्ट, जस्तै ChatGPT, Claude, Claude Code, Codex र Cursor, र Meta को Graph API कल गर्ने जुनसुकै कोड: Node.js, Python, n8n, LangChain, OpenAI Agents SDK वा Vercel AI SDK। तलको एपीआई Meta को आफ्नै भएकाले, एजेन्ट भित्र कुनै निजी प्रविधि राखिएको हुँदैन।
के सामान्य-उद्देश्यका AI सहायकलाई WhatsApp मा अनुमति छ?
Meta को Business Solution Terms, धारा 4.7 ले सामान्य-उद्देश्यका AI सहायक प्रदायकहरूलाई, जहाँ AI नै मुख्य कार्यक्षमता हो, WhatsApp Business Platform मा प्रस्ताव गर्न रोक लगाउँछ, Meta ले तय गरे अनुसार, र जनवरी 15, 2026 देखि लागू भएको छ। आफ्ना ग्राहकका लागि, सहायता, बिक्री वा बुकिङका लागि AI प्रयोग गर्ने व्यवसाय त्यो लक्ष्य होइन, र EU र ब्राजिलका नियामकहरूले प्रतिस्पर्धी सहायकहरूका लागि त्यो नियम निलम्बन गर्न वा फिर्ता लिन Meta लाई आदेश दिएका छन्।
पढ्दै जानुहोस्
सुरु गर्न तयार हुनुहुन्छ?
महिनौं होइन, केही मिनेटमै WhatsApp Coexistence सेट अप गर्नुहोस्। एप फोनमा चलिरहन्छ।
निःशुल्क ट्रायल सुरु गर्नुहोस्प्रमाणीकरण गरिएको