डेवलपर्स के लिए
एक वाक्य में
MsgBuddy स्क्रीन पर आप जो भी काम कर सकते हैं, वह लगभग सब कुछ आप कोड से भी कर सकते हैं — सुरक्षित कीज़ वाले REST API, रीयल-टाइम वेबहुक्स, और ऐसी सुरक्षा सुविधाओं के ज़रिए जिनसे ऑटोमेटेड सेंडिंग भरोसेमंद बनी रहती है।
यह अध्याय डेवलपर्स के लिए एक हाई-लेवल ओरिएंटेशन है, जिसे आसान भाषा में लिखा गया है। सटीक एंडपॉइंट और रिक्वेस्ट फ़ॉर्मैट Settings → Developers से लिंक किए गए इंटरैक्टिव API रेफ़रेंस (Swagger) में मिलते हैं। गैर-डेवलपर इस पूरे अध्याय को छोड़ सकते हैं।
तीन बुनियादी हिस्से
| हिस्सा | किस लिए है |
|---|---|
| API कीज़ | यह साबित करना कि वाकई आपका ऐप कॉल कर रहा है। |
| REST API | मैसेज भेजें, कॉन्टैक्ट मैनेज करें, कैम्पेन चलाएं — प्रोग्रामेटिक रूप से। |
| वेबहुक्स | नए इवेंट्स (नया मैसेज, टेम्पलेट अप्रूव होना) रीयल टाइम में पाएं। |
API कीज़ (लाइव बनाम टेस्ट)
Settings → Developers के तहत कीज़ बनाएं। कीज़ दो तरह की होती हैं ताकि आप सुरक्षित तरीके से बना सकें।
| प्रीफ़िक्स | वातावरण | किस काम के लिए |
|---|---|---|
mb_test… | टेस्ट | डेवलपमेंट और प्रयोगों के लिए |
mb_live… | लाइव | असली ग्राहकों को असली मैसेज भेजने के लिए |
कीज़ को गुप्त रखें — जिसके पास mb_live की है, वह आपकी ओर से मैसेज भेज सकता है। अगर कोई की
कभी उजागर हो जाए, तो आप Developers स्क्रीन से उसे रोटेट (बदल) कर सकते हैं।
आइडेम्पोटेंसी (गलती से दोहरी सेंडिंग न हो)
जब आप API से भेजते हैं, तो आप एक आइडेम्पोटेंसी की जोड़ सकते हैं — उस रिक्वेस्ट के लिए एक यूनीक टोकन। अगर वही रिक्वेस्ट दोबारा भेजी जाए (मान लीजिए किसी नेटवर्क गड़बड़ी के बाद), तो MsgBuddy उस टोकन को पहचान लेता है और दोबारा नहीं भेजता। यही वजह है जिससे ऑटोमेटेड सेंडिंग को दोबारा कोशिश करना सुरक्षित बनता है।
सेंड रिक्वेस्ट पर हमेशा एक आइडेम्पोटेंसी की सेट करें। इससे ही तय होता है कि दोबारा भेजी गई रिक्वेस्ट बेअसर रहती है या ग्राहक को एक ही मैसेज पांच बार मिल जाता है।
वेबहुक्स (दूसरी दिशा)
API का मतलब है कि आप MsgBuddy को कॉल कर रहे हैं; वेबहुक्स का मतलब है कि MsgBuddy आपको कॉल कर रहा है। दोनों मिलकर आपको किसी बाहरी सिस्टम को पूरी तरह सिंक में रखने देते हैं। वेबहुक डिलीवरी HMAC-साइन्ड और वर्ज़न्ड होती हैं ताकि आप उन पर भरोसा कर सकें और उन्हें आगे भी बदल सकें।
यह कैसे जुड़ता है
- Settings → Developers और वेबहुक्स में कीज़/वेबहुक्स सेट अप करें।
- वही 24-घंटे की विंडो और टेम्पलेट से जुड़े नियम API सेंड्स पर भी लागू होते हैं — API, WhatsApp के नियमों को दरकिनार नहीं करता।
आगे: MsgBuddy को ब्राउज़र से आगे इस्तेमाल करें — ऐप्स →।