मुख्य सामग्री पर जाएं
WhatsApp टूलकिट WhatsApp Business Platform (Cloud API) तक प्रोग्रामेटिक पहुँच प्रदान करता है। यह एजेंट्स और वर्कफ़्लो को Meta Graph API के माध्यम से टेक्स्ट, मीडिया, पूर्व-अनुमोदित टेम्पलेट्स और उन्नत संदेश प्रकारों सहित आउटबाउंड संदेश भेजने में सक्षम बनाता है। इनकमिंग WhatsApp संदेशों को प्राप्त करना या प्रोसेस करना समर्थित नहीं है।

​
पूर्वावश्यकताएं

कनेक्शन बनाने से पहले, आपको Meta से निम्नलिखित की आवश्यकता होगी:

​
कनेक्शन बनाना

WhatsApp टूलकिट Agent Builder और Workflow Builder दोनों में उपलब्ध है। दोनों में कनेक्शन सेटअप समान है, लेकिन नेविगेशन पथ भिन्न है।
  1. Agent Builder में अपना एजेंट खोलें
  2. बाईं साइडबार में Toolkits टैब पर जाएं
  3. WhatsApp खोजें और Add to Agent पर क्लिक करें
  4. टूलकिट पैनल में, Select a Connection > Create a Connection पर क्लिक करें
  5. पॉप-अप में, Connection Name, अपना System User Access Token, Business Account ID दर्ज करें।
  6. अपना Access Token, Business Account ID (वैकल्पिक), और कनेक्शन के लिए एक प्रदर्शन Name दर्ज करें
  7. Save पर क्लिक करें — EKB सहेजने से पहले क्रेडेंशियल्स सत्यापित करेगा

​
उपलब्ध टूल्स

​
कस्टम 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 चालान या अनुबंध जनरेट करता है और वर्णनात्मक कैप्शन के साथ मीडिया भेजें टूल के माध्यम से इसे वितरित करता है।
  • प्रसारण अभियान: वर्कफ़्लो संपर्क सूची पर दोहराता है और व्यक्तिगत पैरामीटर प्रतिस्थापन के साथ एक अनुमोदित मार्केटिंग टेम्पलेट भेजता है।

​
समस्या निवारण

�दि त्रुटि ऊपर सूचीबद्ध नहीं है, तो डीबग चेकलिस्ट का उपयोग करें:
  1. क्रेडेंशियल्स और कनेक्शन की वैधता सत्यापित करें
  2. पुष्टि करें कि प्राप्तकर्ता का फ़ोन नंबर WhatsApp पर पंजीकृत है
  3. संदेश प्रारूप और पेलोड संरचना मान्य करें
  4. टेम्पलेट अनुमोदन स्थिति की पुष्टि करें
  5. जांचें कि API रेट सीमाएं पहुँच गई हैं या नहीं