अपनी खुद की इंटीग्रेशन के लिए API कुंजियाँ (keys) जनरेट करें और प्रबंधित करें, दैनिक उपयोग देखें, और इन-ब्राउज़र प्लेग्राउंड में लाइव कॉल का परीक्षण करें।
6 min read
आर्काइव किया गया — डैशबोर्ड के पुराने संस्करण के लिए लिखा गया था, इसलिए कुछ स्क्रीन अलग दिख सकती हैं।
WizMessage एक डेवलपर-अनुकूल API प्रदान करता है जो आपको अपने मौजूदा सिस्टम — आपके ई-कॉमर्स स्टोर, CRM, हेल्पडेस्क, या कस्टम एप्लिकेशन — को चैटबॉट क्रियाओं को चलाने, संपर्कों को प्रबंधित करने और प्रोग्रामेटिक रूप से बल्क संदेश भेजने के लिए कनेक्ट करने देता है। इस स्क्रीन से, आप एंटरप्राइज़-ग्रेड सुरक्षा के साथ API कुंजियाँ जनरेट और प्रबंधित करते हैं: कुंजियों को सुरक्षित भंडारण के लिए हैश किया जाता है, रहस्य (secrets) केवल एक बार दिखाए जाते हैं, और आप IP श्वेतसूची (whitelist) द्वारा पहुंच को प्रतिबंधित कर सकते हैं और दर (rate) और दैनिक अनुरोध सीमा लागू कर सकते हैं। सिग्नेचर सत्यापन के साथ रीयल-टाइम ईवेंट (संदेश प्राप्त, वितरित, पढ़ा गया) प्राप्त करने के लिए आउटबाउंड वेबहुक सेट अप करें, और कोई भी इंटीग्रेशन कोड लिखने से पहले सीधे अपने ब्राउज़र से लाइव API कॉल का परीक्षण करने के लिए अंतर्निहित प्लेग्राउंड का उपयोग करें।
📊 प्लान आवश्यकता: API प्रबंधन के लिए Wiz Bot या Wiz Pro की आवश्यकता होती है। API कॉल और वेबहुक डिलीवरी असीमित हैं — API उपयोग पर कोई मासिक संदेश सीमा लागू नहीं होती है।
API कुंजियाँ जनरेट करें — बाहरी सिस्टम को कनेक्ट करने के लिए सुरक्षित API कुंजियाँ (pk_live_...) और सिंगल-व्यू सीक्रेट (sk_live_...) बनाएं।
सीक्रेट रोटेट करें — यदि समझौता हो गया है, तो पूर्ण कोड रीफैक्टरिंग से बचने के लिए पब्लिक कुंजी को बरकरार रखते हुए अपना सीक्रेट जनरेट करें।
IP श्वेतसूचीकरण लागू करें — अनधिकृत अनुरोधों को ब्लॉक करने के लिए अनुमत IP पतों की अल्पविराम से अलग की गई सूची परिभाषित करें।
उपयोग सीमाएँ निर्धारित करें — दर सीमा (प्रति मिनट अनुरोध) और दैनिक पूर्ण सीमा परिभाषित करके दुरुपयोग को कम करें।
वेबहुक कॉन्फ़िगर करें — रीयल-टाइम ईवेंट (भेजा गया, वितरित, प्राप्त हुआ) प्राप्त करने के लिए एक सिग्नेचर टोकन (whsec_...) के साथ आउटबाउंड वेबहुक सेट अप करें।
प्लेग्राउंड में परीक्षण करें — कोड लिखने से पहले अपने टेम्प्लेट और संपर्कों का उपयोग करके लाइव टेस्ट कॉल निष्पादित करने के लिए इन-ब्राउज़र प्लेग्राउंड का उपयोग करें।
युक्ति (Tip): API कुंजियों को पासवर्ड की तरह समझें। उन्हें कभी भी गिट रिपॉजिटरी में कमिट न करें या फ्रंटएंड कोड में हार्डकोड न करें। यदि कोई कुंजी लीक हो जाती है, तो उसे तुरंत रद्द या रोटेट करें।
API कुंजी प्रारूप (Format):pk_live_ के साथ उपसर्ग (जैसे, pk_live_abcd1234...)। पहले 12 अक्षर पहचान के लिए सादे पाठ में हैं; पूरी कुंजी SHA-256 के माध्यम से हैश की गई है।
API सीक्रेट प्रारूप:sk_live_ के साथ उपसर्ग (जैसे, sk_live_xyz9876...)। निर्माण पर केवल एक बार दिखाया जाता है।
दर सीमा (Rate Limit): प्रति कुंजी प्रति मिनट अधिकतम अनुमत अनुरोध (डिफ़ॉल्ट रूप से 60)।
दैनिक सीमा: प्रति कुंजी कुल अनुरोधों पर सख्त दैनिक सीमा (डिफ़ॉल्ट रूप से 1000)।
वेबहुक सीक्रेट: स्वचालित रूप से whsec_ उपसर्ग के साथ एक सिग्नेचर टोकन जनरेट करता है (जैसे, whsec_abc123...)।
सिग्नेचर सत्यापन (Signature Verification): प्रत्येक वेबहुक में एक X-WizMessage-Signature हेडर होता है (आपके whsec_ सीक्रेट का उपयोग करके कच्चे शरीर का HMAC-SHA256 सिग्नेचर)।
ईवेंट सदस्यताएँ: विशिष्ट ईवेंट जैसे message.received, message.sent, delivery.updated की सदस्यता लें, या all सुनें।
पुनः प्रयास तर्क (Retry Logic): विफल वेबहुक डिलीवरी में 5 प्रयासों तक देरी के साथ पुनः प्रयास किया जाता है।