डेवलपर एकीकरण

7stamp वेबहुक

उपलब्ध

7stamp से प्रत्येक लॉयल्टी इवेंट को वास्तविक समय में अपने सिस्टम पर पुश करें। कोई मतदान नहीं और कोई निर्धारित API कॉल नहीं। घटनाएँ घटित होने के कुछ ही सेकंड के भीतर HTTPS POST अनुरोधों के रूप में आ जाती हैं।

अपने CRM, ERP, या कस्टम बैकएंड को लॉयल्टी पक्ष पर जो हो रहा है, उसके साथ समन्वय में रखने के लिए वेबहुक का उपयोग करें: कौन शामिल हुआ, किसे स्टांप मिला, किसने वाउचर भुनाया, किसने जन्मदिन का उपहार ट्रिगर किया, और कौन निष्क्रिय हो गया। फिर आपका सिस्टम तय करता है कि उस डेटा के साथ क्या करना है।

आप वेबहुक के साथ क्या कर सकते हैं

वेबहुक एकीकरण स्टैक का आउटबाउंड पक्ष है। वे ग्राहक और इनाम गतिविधि को उन प्रणालियों में प्रतिबिंबित करते हैं जिन पर आप बिक्री, सेवा, विश्लेषण और मैसेजिंग के लिए पहले से ही भरोसा करते हैं।

वफादारी के इतिहास को अपने CRM में प्रतिबिंबित करें

प्रत्येक स्टाम्प, वाउचर, जन्मदिन, और निष्क्रियता ट्रिगर आपके CRM में ग्राहक रिकॉर्ड पर आता है। आप 7stamp में लॉग इन किए बिना बिक्री, कॉल और टिकटों के बगल में पूर्ण लॉयल्टी टाइमलाइन देखते हैं।

अपना खुद का मैसेजिंग स्टैक ट्रिगर करें

जब कोई ग्राहक वाउचर भुनाता है, तो अपने मौजूदा SMS गेटवे से धन्यवाद SMS भेजें। जब कोई ग्राहक गोल मारता है, तो Slack में जश्न मनाएं। जब कोई निष्क्रिय हो जाए, तो मामले को अपने खाता प्रबंधक के पास भेज दें।

पावर एनालिटिक्स और सुलह

घटनाओं को अपने BI टूल, वेयरहाउस, या सुलह पाइपलाइन में स्ट्रीम करें। वाउचर मोचन को POS प्राप्तियों के साथ मिलान करें और अपने स्वयं के मेट्रिक्स में लॉयल्टी ROI की गणना करें।

कार्ड इवेंट प्रकार

SCAN — एक कार्ड को स्कैन/stamp कार्रवाई प्राप्त हुई।
REWARD_EARNED — कार्ड पर एक इनाम अर्जित किया गया था।
VOUCHER_ISSUED — एक वाउचर जारी किया गया था।
VOUCHER_REDEEMED — एक वाउचर भुनाया गया।
LOTTERY_WIN — एक लॉटरी के परिणामस्वरूप जीत हुई।
DELIVERY_INSERT — एक डिलीवरी-इन्सर्ट प्रवाह रिकॉर्ड किया गया था।
CARD_JOINED — एक ग्राहक एक कार्ड से जुड़ा।
CARD_CAMPAIGN — एक कार्ड अभियान कार्यक्रम हुआ।
BIRTHDAY_GREETING — एक जन्मदिन बधाई कार्यक्रम हुआ।
ADMIN_VOUCHER_ISSUE — एक प्रशासक ने एक वाउचर जारी किया।
CARD_ADDED_TO_WALLET — एक ग्राहक ने कार्ड को अपने वॉलेट में जोड़ा।
CARD_REMOVED_FROM_WALLET — एक ग्राहक ने अपने वॉलेट से कार्ड निकाला।

एक सुरक्षित वेबहुक रिसीवर बनाएं

टिकाऊ हैंडलिंग के बाद स्वीकार करें

आपके समापन बिंदु को HTTPS POST को स्वीकार करना चाहिए, अनुरोध आकार को मान्य करना चाहिए, ईवेंट को जारी रखना या कतारबद्ध करना चाहिए, फिर एक सफल 2xx प्रतिक्रिया लौटानी चाहिए। यदि इसे सुरक्षित रूप से कतारबद्ध किया जा सकता है तो पावती से पहले धीमी CRM या मैसेजिंग कॉल न करें।

External ID के साथ सहसंबद्ध

प्रत्येक संबंधित घटना में External ID और वैकल्पिक External Source शामिल हो सकते हैं जिनका उपयोग आपने कार्ड बनाते या स्कैन करते समय किया था। नाम या ईमेल से अनुमान लगाए बिना अपने स्वयं के CRM, POS, या ऑर्डर रिकॉर्ड को अपडेट करने के लिए इस जोड़ी का उपयोग करें।

Make डिलीवरी बेकार

साइड इफेक्ट ट्रिगर करने से पहले एक टिकाऊ प्रोसेसिंग कुंजी या ईवेंट फिंगरप्रिंट स्टोर करें। यदि आपका रिसीवर वही डिलीवरी दोबारा देखता है, तो उसे डुप्लिकेट CRM नोट, वाउचर या संदेश नहीं जोड़ना चाहिए। समापन बिंदु URL को एक रहस्य मानें।

उदाहरण इवेंट पेलोड आकार

इसे अपने स्वचालन चरण में कॉपी करें json
{
  "event_type": "SCAN",
  "scanned_at": "2026-07-23T12:34:56Z",
  "user_card_id": 123,
  "card_template_id": 42,
  "card_template_name": "Coffee Loyalty",
  "stamps_added": 1,
  "stamps_before": 4,
  "stamps_after": 5,
  "amount": 24.5,
  "external_order_id": "order_2048",
  "external_id": "crm_contact_8821",
  "external_source": "hubspot"
}

एक वेबहुक कॉन्फ़िगर और परीक्षण करें

01

अपने बैकएंड में एक HTTPS एंडपॉइंट बनाएं, CRM एकीकरण परत, Make वेबहुक, या Zapier Catch Hook। Make URL को कॉपी करने से पहले सुनिश्चित करें कि आप गंतव्य को नियंत्रित करते हैं।

02

7stamp Admin में Stamp Cards → API & Integrations → Webhooks खोलें।

03

समापन बिंदु URL जोड़ें और केवल उन ईवेंट प्रकारों का चयन करें जिनकी प्राप्तकर्ता वर्कफ़्लो को वास्तव में आवश्यकता है।

04

प्रोफ़ाइल सेटिंग्स सहेजें, फिर एक ईवेंट उत्पन्न करने के लिए एक डिस्पोजेबल परीक्षण स्कैन या कार्ड कार्रवाई ट्रिगर करें।

05

प्राप्त पेलोड का निरीक्षण करें। अपेक्षित रिकॉर्ड के साथ External ID और External Source का मिलान करें और पुष्टि करें कि प्राप्तकर्ता एक सफल प्रतिक्रिया देता है।

06

CRM, वाउचर, या मैसेजिंग साइड इफेक्ट्स को तभी सक्षम करें जब आपके पास रीप्ले-सुरक्षित हैंडलिंग और विफलताओं की निगरानी हो।

नो-कोड विकल्प: Make और Zapier

Make में, एक रिसीविंग URL उत्पन्न करने के लिए Webhooks → Custom webhook का उपयोग करें और इसे 7stamp प्रोफ़ाइल में पेस्ट करें। Zapier में, इसी उद्देश्य के लिए Webhooks by Zapier → Catch Hook का उपयोग करें। 7stamp प्रोफ़ाइल सदस्यता का स्वामी है क्योंकि वर्तमान API स्वचालित वेबहुक पंजीकरण समापन बिंदुओं को उजागर नहीं करता है।

सुरक्षा और वितरण अनुबंध

वर्तमान पेलोड स्कीमा और फ़ील्ड अर्थ के स्रोत के रूप में सार्वजनिक OpenAPI संदर्भ के वेबहुक अनुभाग का उपयोग करें। HTTPS की आवश्यकता है, रिसीवर URL को सार्वजनिक लॉग से बाहर रखें, और प्रसंस्करण को निष्क्रिय बनाएं। उत्पादन में एक विशिष्ट हेडर नाम या पुनः प्रयास नीति लागू करने से पहले ऑनबोर्डिंग के दौरान अपने 7stamp प्रोफ़ाइल के लिए अनुरोध-प्रमाणीकरण/signature प्रक्रिया की पुष्टि करें।

अक्सर पूछे जाने वाले प्रश्न

क्या मैं केवल कुछ निश्चित वेबहुक इवेंट का चयन कर सकता हूँ?

हां. 7stamp प्रोफ़ाइल की वेबहुक सेटिंग्स में इवेंट प्रकारों का चयन करें ताकि रिसीवर को केवल वही इवेंट मिलें जो उसके वर्कफ़्लो के लिए महत्वपूर्ण हों।

मैं वेबहुक को Make या Zapier से कैसे जोड़ूँ?

Make में प्राप्त वेबहुक या Zapier में Catch Hook बनाएं, जेनरेट किए गए URL को कॉपी करें, फिर इसे 7stamp प्रोफ़ाइल की वेबहुक सेटिंग्स में पेस्ट करें और एक परीक्षण ईवेंट भेजें।

मुझे किसी ईवेंट का मेरे CRM संपर्क से कैसे मिलान करना चाहिए?

External ID का उपयोग करें और, मौजूद होने पर, External Source का उपयोग करें। ये वे पहचानकर्ता हैं जो आपके एकीकरण ने कार्ड बनाते या स्कैन करते समय प्रदान किए थे।

क्या मुझे हस्ताक्षर शीर्षलेख मान लेना चाहिए या समय पुनः प्रयास करना चाहिए?

नहीं। वर्तमान OpenAPI/profile डिलीवरी अनुबंध का उपयोग करें और हेडर को हार्ड-कोड करने या पुनः प्रयास करने से पहले ऑनबोर्डिंग के दौरान अपनी प्रोफ़ाइल के लिए प्रमाणीकरण प्रक्रिया की पुष्टि करें।

अगला चरण

पहला कार्ड इवेंट भेजने के लिए तैयार हैं?

एक रिसीवर बनाएं, इसके HTTPS URL को प्रोफाइल में पेस्ट करें, एक डिस्पोजेबल स्कैन चलाएं, और डाउनस्ट्रीम ऑटोमेशन को सक्षम करने से पहले मिलान External ID को मान्य करें।