> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp टूलकिट

> WhatsApp Business API के माध्यम से अपने एजेंट्स और वर्कफ़्लो से आउटबाउंड संदेश, मीडिया और पूर्व-अनुमोदित टेम्पलेट्स भेजें।

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

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

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

| आवश्यकता                             | कहाँ से प्राप्त करें                                      |
| ------------------------------------ | --------------------------------------------------------- |
| WhatsApp Business Account (सत्यापित) | [Meta Business Manager](https://business.facebook.com)    |
| 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 दोनों में उपलब्ध है। दोनों में कनेक्शन सेटअप समान है, लेकिन नेविगेशन पथ भिन्न है।

<Tabs>
  <Tab title="Agent Toolkit">
    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 सहेजने से पहले क्रेडेंशियल्स सत्यापित करेगा
  </Tab>

  <Tab title="Workflow Toolkit">
    1. **Workflow Builder** में अपना वर्कफ़्लो खोलें
    2. नया चरण जोड़ें और टूलकिट सूची से **WhatsApp** चुनें
    3. **Add Connection** पर क्लिक करें
    4. अपना **Access Token**, **Phone Number ID**, **Business Account ID** (वैकल्पिक), और कनेक्शन के लिए एक प्रदर्शन **Name** दर्ज करें
    5. **Save** पर क्लिक करें — EKB सहेजने से पहले क्रेडेंशियल्स सत्यापित करेगा
  </Tab>
</Tabs>

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

| टूल                | विवरण                                                                                                        |
| ------------------ | ------------------------------------------------------------------------------------------------------------ |
| **संदेश भेजें**    | 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 प्रकार समर्थित हैं |

�दि त्रुटि ऊपर सूचीबद्ध नहीं है, तो **डीबग चेकलिस्ट** का उपयोग करें:

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