तुमच्या CRM मध्ये लॉयल्टी इतिहास मिरर करा
प्रत्येक स्टॅम्प, व्हाउचर, वाढदिवस आणि निष्क्रियता ट्रिगर तुमच्या CRM मधील ग्राहक रेकॉर्डवर उतरते. 7Stamp मध्ये लॉग इन न करता तुम्हाला विक्री, कॉल आणि तिकिटांच्या पुढे संपूर्ण लॉयल्टी टाइमलाइन दिसेल.
विकसक एकत्रीकरण
7Stamp वेबहुक्स
उपलब्ध7Stamp पासून प्रत्येक लॉयल्टी इव्हेंटला रिअल टाइममध्ये तुमच्या स्वतःच्या सिस्टीमवर पुश करा. मतदान नाही आणि शेड्यूल केलेले API कॉल नाहीत. घटना घडल्याच्या काही सेकंदात HTTPS POST विनंत्या म्हणून येतात.
तुमचा CRM, ERP, किंवा सानुकूल बॅकएंड लॉयल्टी बाजूने काय घडत आहे याच्या समक्रमित ठेवण्यासाठी वेबहुक वापरा: कोण सामील झाले, कोणाला स्टँप मिळाला, कोणी व्हाउचर रिडीम केले, कोणी वाढदिवसाची भेट ट्रिगर केली आणि कोण निष्क्रिय झाले. मग तुमच्या सिस्टम त्या डेटाचे काय करायचे ते ठरवतात.
तुम्ही वेबहुकसह काय करू शकता
वेबहुक ही इंटिग्रेशन स्टॅकची आउटबाउंड बाजू आहे. विक्री, सेवा, विश्लेषणे आणि मेसेजिंगसाठी तुमचा आधीच विश्वास असलेल्या सिस्टममध्ये ते ग्राहक आणि बक्षीस क्रियाकलाप मिरर करतात.
तुमचा स्वतःचा मेसेजिंग स्टॅक ट्रिगर करा
जेव्हा एखादा ग्राहक व्हाउचर रिडीम करतो, तेव्हा तुमच्या विद्यमान SMS गेटवेवरून धन्यवाद SMS पाठवा. जेव्हा एखादा ग्राहक ध्येय गाठतो, तेव्हा Slack मध्ये उत्सव पोस्ट करा. जेव्हा एखादी व्यक्ती निष्क्रिय होते, तेव्हा केस तुमच्या खाते व्यवस्थापकाकडे पाठवा.
पॉवर ॲनालिटिक्स आणि सामंजस्य
तुमच्या BI टूल, वेअरहाऊस किंवा रिकन्सिलिएशन पाइपलाइनमध्ये इव्हेंट स्ट्रीम करा. POS पावत्यांच्या विरूद्ध व्हाउचर रिडीम्शन जुळवा आणि तुमच्या स्वतःच्या मेट्रिक्समध्ये ROI लॉयल्टीची गणना करा.
कार्ड इव्हेंट प्रकार
SCAN — कार्डला स्कॅनटीएमएक्सPATH1XMT क्रिया प्राप्त झाली.
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 स्वीकारले पाहिजे, नंतर इव्हेंटला आकार द्या किंवा यशस्वीरित्या 2 आकारण्याची विनंती करा. प्रतिसाद सुरक्षितपणे रांगेत उभे राहता येत असल्यास पावतीपूर्वी मंद 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 प्रमाणित करा.