पूर्वावश्यकताएं
कनेक्शन बनाने से पहले, आपको Meta से निम्नलिखित की आवश्यकता होगी:| आवश्यकता | कहाँ से प्राप्त करें |
|---|---|
| WhatsApp Business Account (सत्यापित) | Meta Business Manager |
| System User Access Token | Meta Business Manager → System Users |
| Phone Number ID | WhatsApp Manager → Phone Numbers |
| Business Account ID | वैकल्पिक — उन्नत Graph API कॉल के लिए आवश्यक |
| अनुमोदित संदेश टेम्पलेट्स | Meta Business Manager → Account Tools → Message Templates |
कनेक्शन बनाना
WhatsApp टूलकिट Agent Builder और Workflow Builder दोनों में उपलब्ध है। दोनों में कनेक्शन सेटअप समान है, लेकिन नेविगेशन पथ भिन्न है।- Agent Toolkit
- Workflow Toolkit
- Agent Builder में अपना एजेंट खोलें
- बाईं साइडबार में Toolkits टैब पर जाएं
- WhatsApp खोजें और Add to Agent पर क्लिक करें
- टूलकिट पैनल में, Select a Connection > Create a Connection पर क्लिक करें
- पॉप-अप में, Connection Name, अपना System User Access Token, Business Account ID दर्ज करें।
- अपना Access Token, Business Account ID (वैकल्पिक), और कनेक्शन के लिए एक प्रदर्शन Name दर्ज करें
- Save पर क्लिक करें — EKB सहेजने से पहले क्रेडेंशियल्स सत्यापित करेगा
उपलब्ध टूल्स
| टूल | विवरण |
|---|---|
| संदेश भेजें | 24-घंटे के सत्र विंडो के भीतर प्लेन टेक्स्ट संदेश (अधिकतम 4,096 वर्ण, UTF-8) भेजें |
| मीडिया भेजें | सार्वजनिक HTTPS URL के माध्यम से इमेज, वीडियो, ऑडियो, या दस्तावेज़ भेजें, वैकल्पिक कैप्शन या फ़ाइलनाम के साथ |
| टेम्पलेट भेजें | पूर्व-अनुमोदित टेम्पलेट संदेश भेजें — 24-घंटे के सत्र विंडो के बाहर आउटबाउंड मैसेजिंग के लिए आवश्यक |
| कस्टम API कॉल | उन्नत उपयोग के मामलों के लिए किसी भी Meta Graph API एंडपॉइंट पर सीधा कॉल करें (नीचे देखें) |
कस्टम API कॉल
कस्टम API कॉल टूल सबसे विस्तार योग्य विकल्प है। यह अन्य टूल्स द्वारा कवर किए गए से परे WhatsApp Graph API एंडपॉइंट्स तक सीधी पहुँच प्रदान करता है, जिसमें शामिल हैं:- इंटरैक्टिव संदेश (बटन, लिस्ट)
- लोकेशन और कॉन्टैक्ट कार्ड
- उत्पाद कैटलॉग संदेश
- प्रोग्रामेटिक टेम्पलेट प्रबंधन
- बिज़नेस प्रोफ़ाइल अपडेट
- मैसेजिंग एनालिटिक्स और अंतर्दृष्टि
कॉन्फ़िगरेशन नोट्स
- फ़ोन नंबर प्रारूप: हमेशा E.164 अंतर्राष्ट्रीय प्रारूप का उपयोग करें (जैसे,
+1...,+52...)। स्पेस, डैश, या गायब देश कोड वितरण विफलताएं करेगा (त्रुटि1006)। - सत्र विंडो: प्लेन टेक्स्ट और मीडिया संदेश केवल प्राप्तकर्ता के अंतिम संदेश के 24-घंटे के विंडो के भीतर भेजे जा सकते हैं। उस विंडो के बाहर, टेम्पलेट भेजें का उपयोग करें।
- मीडिया URLs: HTTPS पर सार्वजनिक रूप से सुलभ होना चाहिए। निजी, लोकलहोस्ट, या समाप्त URLs डाउनलोड विफलताएं करेंगे (त्रुटि
1011)। पुष्टि करें कि MIME प्रकार फ़ाइल सामग्री से मेल खाते हैं। - टेम्पलेट्स: उपयोग से पहले Meta Business Manager में अनुमोदित होने चाहिए। पैरामीटर गिनती और क्रम अनुमोदित टेम्पलेट से बिल्कुल मेल खाना चाहिए। अपनी टेम्पलेट गुणवत्ता रेटिंग की निगरानी करें — कम रेटिंग के परिणामस्वरूप टेम्पलेट रुक सकता है (त्रुटि
131056)। - रेट सीमाएं: WhatsApp Business API प्रति-नंबर और प्रति-दिन मैसेजिंग सीमाएं लागू करता है। बल्क भेजने के लिए, क्यू का उपयोग करें और एक्स्पोनेंशियल बैकऑफ़ के साथ रीट्राई लॉजिक लागू करें।
- सुरक्षा: Access tokens सुरक्षित रूप से संग्रहित करें और क्रेडेंशियल्स समय-समय पर घुमाएं। मार्केटिंग संदेश भेजने से पहले उपयोगकर्ता सहमति प्राप्त करें।
व्यावहारिक उदाहरण
- ग्राहक सहायता: एजेंट एक सहायता अनुरोध प्राप्त करता है, ग्राहक रिकॉर्ड देखता है, और टिकट नंबर और अगले चरणों के साथ WhatsApp संदेश भेजता है — या उपयोगकर्ता को सही टीम में रूट करने के लिए इंटरैक्टिव बटन टेम्पलेट का उपयोग करता है।
- ट्रांज़ैक्शनल सूचनाएं: ऑर्डर दिए जाने के बाद वर्कफ़्लो ट्रिगर होता है और ऑर्डर पुष्टि, शिपिंग अपडेट, या भुगतान सूचनाओं के साथ टेम्पलेट भेजता है।
- दस्तावेज़ वितरण: एजेंट एक PDF चालान या अनुबंध जनरेट करता है और वर्णनात्मक कैप्शन के साथ मीडिया भेजें टूल के माध्यम से इसे वितरित करता है।
- प्रसारण अभियान: वर्कफ़्लो संपर्क सूची पर दोहराता है और व्यक्तिगत पैरामीटर प्रतिस्थापन के साथ एक अनुमोदित मार्केटिंग टेम्पलेट भेजता है।
समस्या निवारण
| त्रुटि कोड | लक्षण | समाधान |
|---|---|---|
401 / 190 | अमान्य access token | Meta Business Manager में System User टोकन पुनः जनरेट करें और कनेक्शन अपडेट करें |
33 | अमान्य Phone Number ID | WhatsApp Manager में Phone Number ID सत्यापित करें |
1006 | अमान्य फ़ोन नंबर प्रारूप | E.164 प्रारूप का उपयोग करें — + और देश कोड शामिल करें, कोई स्पेस या डैश नहीं |
131005 | टेम्पलेट नहीं मिला | टेम्पलेट नाम और यह कि यह Meta Business Manager में मौजूद है, पुष्टि करें |
131056 | टेम्पलेट रुका हुआ | Meta Business Manager में टेम्पलेट की गुणवत्ता रेटिंग जांचें |
1011 | मीडिया डाउनलोड विफल | सार्वजनिक HTTPS URL का उपयोग करें और पुष्टि करें कि फ़ाइल प्रकार और MIME प्रकार समर्थित हैं |
- क्रेडेंशियल्स और कनेक्शन की वैधता सत्यापित करें
- पुष्टि करें कि प्राप्तकर्ता का फ़ोन नंबर WhatsApp पर पंजीकृत है
- संदेश प्रारूप और पेलोड संरचना मान्य करें
- टेम्पलेट अनुमोदन स्थिति की पुष्टि करें
- जांचें कि API रेट सीमाएं पहुँच गई हैं या नहीं