खाता और इंटीग्रेशन
बाहरी सिस्टम या सहायक जोड़ें
Pro या Agency पर सीमित अनुमतियों वाली कुंजी बनाएँ, नया कंटेंट प्रकाशित करें या सहायक जोड़ें।
शुरू करने से पहले
Webhook WhatsApp सेवा से आने वाले संदेशों की सूचना पाता है। सर्वर सेटअप इंटीग्रेशन संचालक की ज़िम्मेदारी है। पैनल उपयोगकर्ता को सर्वर सेटिंग्स बदलने की ज़रूरत नहीं। MCP सहायक को खाते के टूल माँगने देता है।
क्या करें
- आने वाले संदेशों के लिए सेटिंग्स खोलें और Webhook URL ढूँढें।
- अपने खाते के इंस्टॉलेशन का सही पता पाने के लिए कॉपी करें चुनें।
- संचालक से उस पते के साथ इच्छित डिवाइस के आने वाले इवेंट कॉन्फ़िगर करने को कहें।
- संचालक तैयार होना बताए तो अपने नंबर से आने वाले परीक्षण संदेश की व्यवस्था करें।
- अपेक्षित परिणाम जाँचें, जैसे मेल खाता स्वचालित उत्तर या लॉग चालू होने पर नया दर्ज समूह संदेश।
- सहायक कनेक्शन के लिए MCP क्लाइंट की खोली अनुमति स्क्रीन से साइन इन करें।
- पहुँच की अनुमति देने से पहले बताए ऐप और खाते को जाँचें।
- बाहरी सिस्टम से भेजने के लिए सेटिंग्स → बाहरी एकीकरण खोलें। एक जुड़े हुए खाते और स्पष्ट रूप से चुने समूहों के लिए नाम वाली कुंजी बनाएँ। कुंजी तुरंत सहेजें; यह केवल एक बार दिखाई जाती है। API का बेस URL कॉपी करें।
- उदाहरण: Abacus.AI को America/Sao_Paulo में रोज़ाना प्रकाशन के आठ समयों में से हर समय नया कंटेंट बनाने के लिए सेट करें। हर प्रकाशन को तीन अनुमत समूहों में नए Idempotency-Key के साथ भेजें। केवल बिल्कुल समान अनुरोध दोहराने के लिए ही कुंजी का फिर इस्तेमाल करें।
- तुरंत कतार में जोड़ने के लिए scheduled_at छोड़ दें, या अगले 30 दिनों तक का पूर्ण टाइमस्टैम्प -03:00 या Z (UTC) के साथ दें। प्रोसेसर हर मिनट जाँच करता है; scheduled_at सबसे पहला पात्र समय है, ठीक उसी सेकंड संदेश पहुँचने की गारंटी नहीं।
- दोबारा कोशिश से पहले कार्य की स्थिति और हर समूह का परिणाम देखें। केवल उन प्रयासों को रद्द करें जिनका संदेश अभी भेजा नहीं गया है। उजागर हुई कुंजी सेटिंग्स में निरस्त करें, फिर नई कुंजी बनाएँ और सहेजें; पुराने कार्य नई कुंजी से फिर शुरू नहीं होते।
पूरा उदाहरण
प्लेसहोल्डर वाले अनुरोध; भेजने से पहले आईडी बदलें और भविष्य की तारीख चुनें। ये अनुरोध असली संदेश प्रकाशित करते हैं। curl '<API_BASE_URL>/v1/groups' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-0900' -H 'Content-Type: application/json' --data '{"type":"text","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"text":"Updated publication","scheduled_at":"2026-10-16T09:00:00-03:00"}' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-1200' -F 'payload={"type":"image","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"caption":"Updated caption"}' -F 'image=@publication.png;type=image/png' curl '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X DELETE '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>'
कैसे जाँचें कि काम हुआ
कार्य की स्वीकृति और समूहों के स्वीकृत परिणाम गेटवे की स्वीकृति की पुष्टि करते हैं। ये पहुँचने या पढ़े जाने की पुष्टि नहीं करते। ऐक्सेस, कुंजी, खाता या समूहों की अनुमतियाँ बदलने पर निर्धारित कार्य अवरुद्ध हो सकता है।
ज़रूरी जानकारी
- सहायक उपलब्ध रिकॉर्ड पढ़ सकते हैं और कहने पर टेक्स्ट भेज सकते हैं। भेजने का अनुरोध करने से पहले सहायक टूल की मार्गदर्शिका पढ़ें।
- MCP से अनुपलब्ध संपादन कार्रवाइयों के लिए पैनल इस्तेमाल करें।
- API ऐक्सेस Pro और Agency के मासिक या सालाना प्लान में शामिल है। Starter के लिए अपग्रेड ज़रूरी है। कुंजियाँ केवल चुने खाते और समूहों की अनुमति देती हैं; WhatsApp खाता बदलने पर भेजना रुक जाता है। सर्वर के क्रेडेंशियल कभी साझा न करें।
- टेक्स्ट में 4,096 अक्षर और कैप्शन में 1,024 अक्षर हो सकते हैं। 5 MiB तक की JPEG, PNG या WebP फ़ाइल multipart के payload और image फ़ील्ड में अपलोड करें। रिमोट चित्रों के URL स्वीकार नहीं किए जाते।
- नया कार्य HTTP 202 लौटाता है। उसी Idempotency-Key के साथ समान अनुरोध दोहराने पर मूल कार्य HTTP 200 के साथ मिलता है; उसी कुंजी के साथ अलग कंटेंट पर 409 मिलता है। भेजने के बाद समयसीमा समाप्त होने पर परिणाम अपुष्ट रह सकता है; दूसरी कुंजी से अपने आप दोबारा न भेजें।
आम समस्याएँ
- क्या दिखाई देता है
- परीक्षण के बाद कोई उत्तर या नया रिकॉर्ड नहीं दिखता।
- क्या करें
- डिवाइस कनेक्शन और संबंधित नियम या लॉग सेटिंग जाँचें, फिर संचालक से आने वाले इवेंट की कॉन्फ़िगरेशन सत्यापित करने को कहें।
- क्या होना चाहिए
- सही कॉन्फ़िगर सुविधा नया मेल खाता इवेंट संसाधित कर सकती है।
- क्या दिखाई देता है
- सहायक अनुमति नहीं ले पाता या दूसरा खाता दिखाता है।
- क्या करें
- साइन इन पर लौटकर इच्छित खाता चुनें; बार-बार अनुमति त्रुटि हो तो संचालक को बताएँ।
- क्या होना चाहिए
- अनुमति स्क्रीन और लौटे रिकॉर्ड इच्छित खाते के होते हैं।
और सहायता लें
संचालक को सुविधा और दिखी त्रुटि बताएँ। सहायक की बातचीत में सर्वर के गोपनीय प्रवेश विवरण न दें।