वफादारी के इतिहास को अपने CRM में प्रतिबिंबित करें
प्रत्येक स्टाम्प, वाउचर, जन्मदिन, और निष्क्रियता ट्रिगर आपके CRM में ग्राहक रिकॉर्ड पर आता है। आप 7Stamp में लॉग इन किए बिना बिक्री, कॉल और टिकटों के बगल में पूर्ण लॉयल्टी टाइमलाइन देखते हैं।
डेवलपर एकीकरण
7Stamp वेबहुक
उपलब्ध7Stamp से प्रत्येक लॉयल्टी इवेंट को वास्तविक समय में अपने सिस्टम पर पुश करें। कोई मतदान नहीं और कोई निर्धारित API कॉल नहीं। घटनाएँ घटित होने के कुछ ही सेकंड के भीतर HTTPS POST अनुरोधों के रूप में आ जाती हैं।
अपने CRM, ERP, या कस्टम बैकएंड को लॉयल्टी पक्ष पर जो हो रहा है, उसके साथ समन्वय में रखने के लिए वेबहुक का उपयोग करें: कौन शामिल हुआ, किसे स्टांप मिला, किसने वाउचर भुनाया, किसने जन्मदिन का उपहार ट्रिगर किया, और कौन निष्क्रिय हो गया। फिर आपका सिस्टम तय करता है कि उस डेटा के साथ क्या करना है।
आप वेबहुक के साथ क्या कर सकते हैं
वेबहुक एकीकरण स्टैक का आउटबाउंड पक्ष है। वे ग्राहक और इनाम गतिविधि को उन प्रणालियों में प्रतिबिंबित करते हैं जिन पर आप बिक्री, सेवा, विश्लेषण और मैसेजिंग के लिए पहले से ही भरोसा करते हैं।
अपना खुद का मैसेजिंग स्टैक ट्रिगर करें
जब कोई ग्राहक वाउचर भुनाता है, तो अपने मौजूदा 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 {
"entity": "card_event",
"action": "created",
"entity_id": 707,
"event_id": "8f05e58decec48e09d328f0edebbacf6",
"profile_id": 2,
"profile_name": "Your Business",
"profile_lang": "en",
"data": {
"event_type": "SCAN",
"scanned_at": "2026-10-01T09:19:24.179424",
"user_card_id": 10,
"card_template_id": 14,
"card_template_name": "Collect your stamps!",
"stamps_added": 3,
"stamps_before": 1,
"stamps_after": 4,
"amount": null,
"external_order_id": "ORDER-1001",
"workplace": { "id": 4, "name": "Bar Counter" },
"device_type": null,
"external_id": "odoo_contact_8821",
"external_source": "odoo",
"issued_vouchers": [
{
"id": 174,
"unique_code": "100425813507",
"stamp_number": 4,
"issued_at": "2026-10-01T09:19:24.191836",
"expires_at": "2027-01-01T23:59:59",
"status": "ACTIVE",
"voucher_template_id": 58,
"voucher_description": "Free coffee",
"voucher_image_url": "https://..."
}
],
"achieved_goals": [],
"user": {
"id": 2,
"name": "Anna",
"full_name": "Anna Smith",
"email": "anna@example.com",
"telegram_chat_id": null,
"telegram_username": null,
"whatsapp_phone": null,
"birth_date": null
}
}
}एक वेबहुक कॉन्फ़िगर और परीक्षण करें
अपने बैकएंड में एक HTTPS एंडपॉइंट बनाएं, CRM एकीकरण परत, Make वेबहुक, या Zapier Catch Hook। Make URL को कॉपी करने से पहले सुनिश्चित करें कि आप गंतव्य को नियंत्रित करते हैं।
7Stamp Admin में Stamp Cards → API & Integrations → Webhooks खोलें।
एंडपॉइंट URL जोड़ें। वेबहुक प्रोफ़ाइल का हर कार्ड इवेंट प्राप्त करता है, इसलिए अपने रिसीवर में data.event_type के आधार पर फ़िल्टर करें।
प्रोफ़ाइल सेटिंग्स सहेजें, फिर एक ईवेंट उत्पन्न करने के लिए एक डिस्पोजेबल परीक्षण स्कैन या कार्ड कार्रवाई ट्रिगर करें।
प्राप्त पेलोड का निरीक्षण करें। अपेक्षित रिकॉर्ड के साथ External ID और External Source का मिलान करें और पुष्टि करें कि प्राप्तकर्ता एक सफल प्रतिक्रिया देता है।
CRM, वाउचर, या मैसेजिंग साइड इफेक्ट्स को तभी सक्षम करें जब आपके पास रीप्ले-सुरक्षित हैंडलिंग और विफलताओं की निगरानी हो।
नो-कोड विकल्प: Make और Zapier
Make में, एक रिसीविंग URL उत्पन्न करने के लिए Webhooks → Custom webhook का उपयोग करें और इसे 7Stamp प्रोफ़ाइल में पेस्ट करें। Zapier में, इसी उद्देश्य के लिए Webhooks by Zapier → Catch Hook का उपयोग करें। 7Stamp प्रोफ़ाइल सदस्यता का स्वामी है क्योंकि वर्तमान API स्वचालित वेबहुक पंजीकरण समापन बिंदुओं को उजागर नहीं करता है।
सुरक्षा और वितरण अनुबंध
मौजूदा पेलोड स्कीमा के स्रोत के रूप में सार्वजनिक OpenAPI संदर्भ के Webhooks सेक्शन का उपयोग करें। बॉडी एक एनवेलप है: profile_id और profile_name 7Stamp प्रोफ़ाइल का नाम बताते हैं, event_id इवेंट की पहचान करता है, और कार्ड इवेंट स्वयं data में होता है (Make या Zapier URL के लिए कुंजी card_event होती है)। हर डिलीवरी एक ही हेडर में साइन की जाती है, X-Webhook-Signature: t=…,s=…। अपने वेबहुक सीक्रेट से t और रॉ रिक्वेस्ट बॉडी को जोड़कर HMAC-SHA256 निकालें, उसे hex में एन्कोड करें और s से मिलाएँ; सीक्रेट 7Stamp Admin में वेबहुक के पेज पर होता है। दोहराई गई डिलीवरी हटाने के लिए X-Webhook-Event-Id का उपयोग करें: रीट्राई को नए t के साथ फिर से साइन किया जाता है। आप एंडपॉइंट को Basic Auth से भी सुरक्षित कर सकते हैं। HTTPS अनिवार्य रखें और रिसीवर URL को सार्वजनिक लॉग से दूर रखें।
अक्सर पूछे जाने वाले प्रश्न
क्या मैं केवल कुछ निश्चित वेबहुक इवेंट का चयन कर सकता हूँ?
नहीं। 7Stamp वेबहुक प्रोफ़ाइल का हर कार्ड इवेंट प्राप्त करता है। अपने रिसीवर में data.event_type के आधार पर फ़िल्टर करें; Make और Zapier में इवेंट card_event के अंतर्गत आता है, इसलिए card_event.event_type के आधार पर फ़िल्टर करें।
मैं वेबहुक को Make या Zapier से कैसे जोड़ूँ?
Make में प्राप्त वेबहुक या Zapier में Catch Hook बनाएं, जेनरेट किए गए URL को कॉपी करें, फिर इसे 7Stamp प्रोफ़ाइल की वेबहुक सेटिंग्स में पेस्ट करें और एक परीक्षण ईवेंट भेजें।
मुझे किसी ईवेंट का मेरे CRM संपर्क से कैसे मिलान करना चाहिए?
data.external_id और, मौजूद होने पर, data.external_source का उपयोग करें: ये उन कार्डों के हर वेबहुक में वापस आते हैं जिन्हें आपने अपनी ID के साथ API के ज़रिए जारी किया है। जिस ग्राहक ने कार्ड खुद लिया है, उसके पास External ID नहीं होता, इसलिए उसे data.user.email से मिलाएँ। Apple का “Hide My Email” पता एक रिले पता है, न कि वह पता जो आपके CRM में है।
मैं कैसे जाँचूँ कि वेबहुक 7Stamp से ही आया है?
X-Webhook-Signature हेडर को t और s में बाँटें, 7Stamp Admin के वेबहुक सीक्रेट से t और रॉ रिक्वेस्ट बॉडी को जोड़कर HMAC-SHA256 निकालें, उसे hex में एन्कोड करें और s से मिलाएँ। t को ठीक वैसा ही लें जैसा भेजा गया था, और बॉडी को प्राप्त रॉ बाइट्स के रूप में, किसी भी JSON पार्सिंग से पहले। जिस डिलीवरी का X-Webhook-Event-Id आप पहले ही प्रोसेस कर चुके हैं, उसे छोड़ दें: रीट्राई को नए t के साथ फिर से साइन किया जाता है।
संबंधित पृष्ठ
अगला चरण
पहला कार्ड इवेंट भेजने के लिए तैयार हैं?
एक रिसीवर बनाएं, इसके HTTPS URL को प्रोफाइल में पेस्ट करें, एक डिस्पोजेबल स्कैन चलाएं, और डाउनस्ट्रीम ऑटोमेशन को सक्षम करने से पहले मिलान External ID को मान्य करें।