नो-कोड ऑटोमेशन गाइड

कनेक्ट 7stamp से Make — चरण दर चरण

कार्यान्वयन गाइड

7stamp को CRM, POS, ऑनलाइन शॉप, स्प्रेडशीट, मैसेजिंग टूल, या किसी भी सिस्टम से कनेक्ट करने के लिए Make का उपयोग करें जो किसी परिदृश्य में डेटा भेज सकता है। आज उत्पादन के लिए तैयार मार्ग 7stamp API कॉल के लिए Make का HTTP ऐप है और आने वाले 7stamp इवेंट के लिए Make का Custom webhook है।

Make के ऐप पिकर में अभी तक कोई सार्वजनिक 7stamp ऐप नहीं है। किसी के लिए प्रतीक्षा न करें: HTTP → Make a request जोड़ें, सटीक URL, विधि, Bearer हेडर, और JSON का उपयोग करें, फिर अपने स्रोत मॉड्यूल से फ़ील्ड को मैप करें। यह वही 7stamp Integration API है जिसे भविष्य में कोई कनेक्टर उपयोग करेगा।

खोलें Make खोलें API संदर्भ

पहला परिदृश्य चुनें जो आपके वर्कफ़्लो से मेल खाता हो

एक घटना और एक परिणाम से प्रारंभ करें। एक बार परीक्षण डेटा सही हो जाने पर, उसके चारों ओर फ़िल्टर, राउटर, CRM अपडेट और अनुवर्ती संदेश जोड़ें।

नए CRM संपर्क के बाद एक कार्ड बनाएं

CRM संपर्क ID को External ID के रूप में उपयोग करें, एक 7stamp कार्ड आमंत्रण बनाएं, फिर अपने सामान्य माध्यम से लौटा हुआ इंस्टॉल URL भेजें ईमेल, SMS, या संदेश भेजने का चरण।

भुगतान किए गए ऑर्डर के बाद स्टाम्प जोड़ें

भुगतान किए गए POS या ईकॉमर्स ऑर्डर से परिदृश्य को ट्रिगर करें। इसके स्थिर ग्राहक ID को मैप करें और कार्ड को स्कैन करने के लिए ID ऑर्डर करें, फिर एक राशि या स्पष्ट स्टाम्प गिनती का उपयोग करें।

एक इनाम अनुवर्ती भेजें

जब कोई कार्ड ईवेंट किसी इनाम या वाउचर की रिपोर्ट करता है, तो परिदृश्य को शाखा दें: CRM को अपडेट करें, टीम को सूचित करें, और जरूरत पड़ने पर ही वॉलेट-कार्ड पुश या ईमेल भेजें।

नेटिव Make ऐप के बिना सिस्टम को संभालें

सीधे 7stamp पर कॉल करने के लिए Make के HTTP मॉड्यूल का उपयोग करें। यह कस्टम POS, ERP, बुकिंग इंजन, या किसी API-प्रथम सेवा के लिए सार्वभौमिक विकल्प है।

7stamp Make HTTP से कॉल करने के लिए संचालन

नीचे दिए गए प्रत्येक कार्ड के लिए, HTTP → Make a request जोड़ें, फिर विधि और URL बिल्कुल दिखाए अनुसार सेट करें। प्रत्येक अनुरोध के लिए समान Bearer कुंजी का उपयोग करें। आवश्यक मैपिंग आपको बताती है कि आपके CRM, POS, या ईकॉमर्स ट्रिगर से क्या आपूर्ति करनी है।

Make ट्रिगर Webhooks → Custom webhook

एक कार्ड ईवेंट प्राप्त करें

Make में एक Custom webhook बनाएं, इसके URL को कॉपी करें, फिर उस URL को पेस्ट करें 7stamp प्रोफ़ाइल वेबहुक सेटिंग्स। यह एक परिदृश्य शुरू करता है जब 7stamp SCAN, REWARD_EARNED, या VOUCHER_ISSUED जैसी घटना भेजता है।

Make
Webhooks → Custom webhook में → जोड़ें; इसे एक स्पष्ट नाम दें और इसके उत्पन्न URL को कॉपी करें।
इन 7stamp
एडमिन → API & Integrations → Webhooks; URL पेस्ट करें, ईवेंट प्रकार चुनें, सहेजें, फिर एक परीक्षण ईवेंट बनाएं।
HTTP क्रिया बनाएं POST /cards/invite

एक Card Invite

एक बाहरी संपर्क के लिए एक नया व्यक्तिगत इंस्टॉल URL और डिलीवरी-डालें कोड बनाता है।

आवश्यक
external_id — अपने अस्तबल का नक्शा बनाएं CRM/contact ID, नाम नहीं।
फिर अपने ईमेल में प्रतिक्रिया से
मैप install_url, SMS, या CRM अपडेट चरण का उपयोग करें।
HTTP कार्रवाई POST /cards/invite/bulk

थोक निर्माण Card Invites

एक अनुरोध में 100 आमंत्रण लिंक तक बनाता है। इसका उपयोग नियंत्रित माइग्रेशन या अभियान के लिए करें, असीमित संपर्क निर्यात के लिए नहीं।

आवश्यक
आइटम - 1-100 व्यक्तिगत आमंत्रण अनुरोध ऑब्जेक्ट की JSON सरणी।
कोई भी लिंक भेजने से पहले
पढ़ें success_count, error_count और प्रत्येक परिणाम जांचें।
HTTP कार्रवाई GET /cards

Find Cards

वैकल्पिक टेम्पलेट और स्रोत फ़िल्टर के साथ External ID द्वारा कार्ड रिकॉर्ड ढूँढता है।

आवश्यक
क्वेरी पैरामीटर external_id।
वैकल्पिक
external_source और template_id जब एक सिस्टम में कई प्रोग्राम होते हैं तो लुकअप को सीमित कर देते हैं।
HTTP कार्रवाई GET /cards/{user_card_id}

कार्ड विवरण प्राप्त करें

एक कार्ड की पूरी स्थिति पढ़ता है जब एक पूर्व चरण अपना आंतरिक User Card ID लौटाता है।

आवश्यक
{user_card_id} को विश्वसनीय 7stamp प्रतिक्रिया द्वारा लौटाए गए आंतरिक ID से बदलें।
बचें
किसी भिन्न प्रोफ़ाइल से कार्ड ID का अनुमान न लगाएं या संग्रहित न करें।
HTTP कार्रवाई POST /cards/scan

कार्ड स्कैन करें

खरीद राशि या स्पष्ट गिनती से स्टाम्प जोड़ता है। यह User Card ID या External ID स्वीकार करता है और बाहरी ऑर्डर संदर्भ को बनाए रख सकता है।

पहचान
external_id और वैकल्पिक external_source का उपयोग करें; user_card_id जीतता है यदि दोनों की आपूर्ति की जाती है।
खरीदारी
राशि-आधारित कार्ड के लिए राशि का उपयोग करें या किसी स्पष्ट संख्या के लिए stamps_count; stamps_count को प्राथमिकता मिलती है।
पता लगाने की क्षमता
भुगतान किए गए ऑर्डर/receipt से मानचित्र external_order_id ताकि 7stamp घटनाओं का मिलान वापस किया जा सके।
HTTP कार्रवाई GET /templates

List Templates

API कुंजी के लिए उपलब्ध कार्ड टेम्पलेट्स को सूचीबद्ध करता है। कनेक्शन का परीक्षण करने या गतिशील रूप से टेम्पलेट का चयन करने के लिए इसका उपयोग करें।

पहला परीक्षण
यह सबसे सुरक्षित पहला अनुरोध है: इसमें कोई बॉडी नहीं है और यह ग्राहक डेटा को नहीं बदलता है।
बाद में मानचित्र करें
सक्रिय टेम्पलेट की आईडी का उपयोग template_id के रूप में तभी करें जब प्रोफ़ाइल में एक से अधिक सक्रिय टेम्पलेट हों।
HTTP कार्रवाई GET /templates/{template_id}/design

Get Template Design

किसी ज्ञात टेम्पलेट के लिए विज़ुअल डिज़ाइन सेटिंग्स लौटाता है, जो तब उपयोगी होता है जब किसी अन्य सिस्टम को एक सुसंगत कार्ड विकल्प प्रदर्शित करने की आवश्यकता होती है।

HTTP कार्रवाई POST /vouchers/issue

वाउचर जारी करें

External ID या User Card ID द्वारा पहचाने गए कार्ड मालिक को वाउचर जारी करता है।

आवश्यक
वाउचर.short_description. कार्ड को external_id या ज्ञात user_card_id से लक्षित करें।
वैधता
validity_value के साथ validity_type का उपयोग करें, या एक निश्चित समाप्ति तिथि के लिए OpenAPI संदर्भ पढ़ें।
HTTP कार्रवाई POST /messages/send

संदेश भेजें

कॉन्फ़िगर चैनल और सहमति नियमों के अधीन, वॉलेट-कार्ड पुश और/or ईमेल के माध्यम से कार्ड मालिक को सामग्री भेजता है।

कार्ड पुश
card_push_text 20 अक्षरों तक सीमित है और एक स्थापित वॉलेट पास की आवश्यकता है।
ईमेल
विषय और मुख्य भाग भेजें; बॉडी में बेसिक HTML सपोर्ट करता है।
Make मॉड्यूल Full 7stamp endpoint URL

HTTP → Make a request

यह Make मॉड्यूल है जो उपरोक्त प्रत्येक 7stamp रूट को कॉल करता है। संपूर्ण URL का उपयोग करें, दस्तावेज़ीकृत विधि का चयन करें, Bearer हेडर जोड़ें, और JSON का उपयोग केवल तभी करें जब रूट को बॉडी की आवश्यकता हो।

बेस URL
https://api.7loc.com/cards-api
हेडर
Authorization: Bearer YOUR_7STAMP_API_कुंजी; Content-Type: POST अनुरोधों के लिए application/json।

तीन Make परिदृश्य आप बिल्कुल लिखे अनुसार बना सकते हैं

नीचे दिए गए नाम वास्तविक Make मॉड्यूल हैं। पहले परिदृश्य से प्रारंभ करें, इसे डिस्पोजेबल संपर्क के विरुद्ध चलाएं, और उसके बाद ही राउटर, फ़िल्टर या उत्पादन शेड्यूलिंग जोड़ें।

1. नया CRM संपर्क → एक 7stamp कार्ड लिंक भेजें

अपेक्षित परिणाम: ग्राहक को 7stamp द्वारा लौटाया गया install_url प्राप्त होता है; आपका CRM उस URL को उसी संपर्क रिकॉर्ड में रख सकता है।

  1. 1 एक परिदृश्य बनाएं और अपना CRM का नया/Created संपर्क ट्रिगर जोड़ें। Kommo के लिए, संपर्क निर्माण ट्रिगर चुनें और नमूना संपर्क लोड करने के लिए इसे एक बार चलाएं।
  2. 2 HTTP → Make a request जोड़ें। विधि को POST और URL से https://api.7loc.com/cards-api/cards/invite.
  3. 3 पर सेट करें Authorization जोड़ें: Bearer YOUR_7STAMP_API_KEY और Content-Type: application/json. JSON बॉडी में, CRM संपर्क ID को external_id में मैप करें और external_source को कोमो जैसे एक निश्चित लेबल पर सेट करें।
  4. 4 HTTP मॉड्यूल को एक बार चलाएँ। पुष्टि करें कि आउटपुट में install_url, delivery_insert_code, external_id, और template_id है।
  5. 5 HTTP के बाद अपना ईमेल/SMS/CRM अपडेट मॉड्यूल जोड़ें और HTTP आउटपुट से install_url मैप करें। यदि टीम को इसे बाद में दोबारा भेजना हो तो CRM संपर्क पर URL सहेजें।

कोई भी लिंक भेजने से पहले: POST /cards/invite हमेशा एक नया आमंत्रण बनाता है। यदि आपका व्यावसायिक नियम किसी मौजूदा संपर्क के लिए दूसरे आमंत्रण से बचना है तो पहले Find Cards का उपयोग करें।

2. भुगतान आदेश → वफादारी टिकट जोड़ें

अपेक्षित परिणाम: एक सफल स्कैन प्रतिक्रिया में सफलता, scan_id, stamps_added, और आपके अगले चरण के लिए पोस्ट-स्कैन कार्ड स्थिति शामिल है।

  1. 1 POS/ecommerce पेड ऑर्डर ट्रिगर से प्रारंभ करें। Make सुनिश्चित करें कि इसके नमूने में एक स्थिर ग्राहक ID और ऑर्डर/receipt ID शामिल है।
  2. 2 HTTP → Make a request को POST https://api.7loc.com/cards-api/cards/scan और समान Bearer हेडर के साथ जोड़ें।
  3. 3 मानचित्र external_id ग्राहक से, external_source सिस्टम नाम से, और external_order_id ऑर्डर ID से। राशि-आधारित कार्डों के लिए राशि जोड़ें, या टिकटों की स्पष्ट संख्या के लिए stamps_count जोड़ें।
  4. 4 Run once परीक्षण आदेश के साथ। परिदृश्य शेड्यूल को सक्षम करने से पहले लौटाए गए सफलता ध्वज और stamps_added की जांच करें।
  5. 5 वैकल्पिक रूप से HTTP चरण के बाद एक फ़िल्टर जोड़ें: केवल तभी जारी रखें जब सफलता सत्य हो, फिर वापस ऑर्डर/CRM रिकॉर्ड पर scan_id या stamps_added लिखें।

कोई भी लिंक भेजने से पहले: पुनः प्रयास पर समान external_order_id का उपयोग करें ताकि बाद के वेबहुक इवेंट में ऑर्डर का पता लगाया जा सके; अस्पष्ट असफल रन के बाद दो बार टिकट न दें।

3. 7stamp इवेंट → CRM को अपडेट करें

अपेक्षित परिणाम: Make तुरंत 7stamp इवेंट प्राप्त करता है और external_id के माध्यम से मिलान CRM रिकॉर्ड पा सकता है और external_source.

  1. 1 एक अलग Make परिदृश्य बनाएं। Webhooks → Custom webhook जोड़ें, जोड़ें चुनें, इसे 7stamp-कार्ड-इवेंट नाम दें, और जेनरेट किए गए URL को कॉपी करें।
  2. 2 7stamp Admin में, API & Integrations → Webhooks खोलें। उस URL को जोड़ें और घटनाओं का एक छोटा सेट चुनें, उदाहरण के लिए SCAN और REWARD_EARNED।
  3. 3 7stamp में एक डिस्पोजेबल टेस्ट स्कैन या कार्ड इवेंट बनाएं। Make पर लौटें और Make को इवेंट डेटा संरचना निर्धारित करने देने के लिए Run once का उपयोग करें।
  4. 4 external_id का उपयोग करके CRM खोज चरण जोड़ें। event_type पर एक फ़िल्टर या राउटर जोड़ें ताकि SCAN, REWARD_EARNED, और VOUCHER_ISSUED अलग-अलग कार्रवाई कर सकें।
  5. 5 CRM अद्यतन/note क्रिया जोड़ें। मानचित्र scanned_at, stamps_after, external_order_id, और issued_vouchers केवल तभी जब वे फ़ील्ड चयनित ईवेंट प्रकार के लिए मौजूद हों।

कोई भी लिंक भेजने से पहले: वेबहुक URL को निजी रखें। अपरिवर्तनीय संदेशों, वाउचर, या CRM परिवर्तनों पर स्विच करने से पहले किसी वास्तविक घटना का परीक्षण करें।

Make खोलने से पहले 7stamp API कुंजी प्राप्त करें

ये सटीक 7stamp Admin स्क्रीन हैं। एक बार कुंजी बनाएं, इसे Make के सुरक्षित HTTP कनेक्शन/keychain में कॉपी करें, फिर तुरंत इसे अपने क्लिपबोर्ड से हटा दें।

7stamp Admin API और एकीकरण स्क्रीन API Keys सूची और Add API Key नियंत्रण
के साथ 7stamp Admin में, API और एकीकरण खोलें, फिर API Keys, और चयन करें Add API Key.
नया 7stamp API प्रतिलिपि नियंत्रण के साथ कुंजी संवाद दृश्यमान
कुंजी को केवल सुरक्षित में कॉपी करें Make HTTP कनेक्शन/keychain. इसे एक पासवर्ड की तरह समझें और यदि यह उजागर हो तो इसे घुमाएँ।

निर्माण से पहले कनेक्शन तैयार करें

प्रति परिवेश एक API कुंजी बनाएँ

7stamp Admin में, API & Integrations → API Keys → Add API Key पर जाएँ। जब वह विकल्प उपलब्ध हो तो मान को Make के HTTP API-कुंजी कनेक्शन/keychain में संग्रहीत करें। कभी भी कुंजी को टेक्स्ट फ़ील्ड से मैप न करें, उसे किसी नोट में न रखें, या उसे ब्राउज़र-फ़ेसिंग वर्कफ़्लो में उपयोग न करें। एक कुंजी एक 7stamp कार्यस्थल/profile.

से संबंधित है एक स्थिर External ID

का उपयोग करें अपने CRM, POS, या वाणिज्य मंच से अपरिवर्तनीय ID को मैप करें - उदाहरण के लिए ए CRM संपर्क ID या ग्राहक UUID. जब एक ही पहचानकर्ता एक से अधिक सिस्टम में दिखाई दे सकता है तो External Source जैसे हबस्पॉट, शॉपिफाई या पोस्टर जोड़ें।

तय करें कि कौन सा टेम्प्लेट लागू होता है

जब कनेक्टेड 7stamp प्रोफ़ाइल में एक सक्रिय कार्ड टेम्प्लेट होता है, तो टेम्प्लेट को खाली छोड़ा जा सकता है। एकाधिक टेम्प्लेट के साथ, मैप करें या जानबूझकर template_id चुनें ताकि प्रत्येक आमंत्रण और स्कैन इच्छित लॉयल्टी प्रोग्राम तक पहुंच सके।

सटीक Make HTTP सेटअप: एक कार्ड आमंत्रण बनाएं

इसे अपने स्वचालन चरण में कॉपी करें http 
Method: POST
URL: https://api.7loc.com/cards-api/cards/invite
Headers:
  Authorization: Bearer YOUR_7STAMP_API_KEY
  Content-Type: application/json
Body type: Raw / JSON

{
  "external_id": "crm_contact_8821",
  "external_source": "hubspot",
  "template_id": 42
}

अपना पहला Make परिदृश्य बनाएं और परीक्षण करें

01

7stamp Admin में, API & Integrations → API Keys → Add API Key में एक कुंजी बनाएं। जब आपका खाता सेटअप इसकी अनुमति देता है तो एक अलग परीक्षण प्रोफ़ाइल/key का उपयोग करें।

02

Make में, एक परिदृश्य बनाएं और स्रोत ट्रिगर जोड़ें। मैपिंग से पहले इसे एक बार चलाएं ताकि आप वास्तविक नमूना संपर्क या भुगतान ऑर्डर देख सकें।

03

अगला प्लस क्लिक करें, HTTP खोजें, और Make एक अनुरोध चुनें। इस पृष्ठ पर ऑपरेशन कार्ड से विधि, पूर्ण URL, और हेडर सेट करें।

04

पहले अनुरोध के रूप में GET https://api.7loc.com/cards-api/templates का उपयोग करें। इसकी सफल प्रतिक्रिया किसी भी ग्राहक डेटा को बदले बिना महत्वपूर्ण कार्यों को साबित करती है।

05

POST मार्गों के लिए, application/json चुनें और इस गाइड से बॉडी आकार चिपकाएँ। एक स्थिर मानचित्र External ID; template_id केवल तभी जोड़ें जब प्रोफ़ाइल में कई सक्रिय टेम्पलेट हों।

06

एक डिस्पोजेबल संपर्क के साथ चलाएं, HTTP आउटपुट का निरीक्षण करें, और उसके बाद ही इसके सटीक प्रतिक्रिया फ़ील्ड को अगले CRM, ईमेल, या मैसेजिंग मॉड्यूल में मैप करें।

आपको Make HTTP का उपयोग कब करना चाहिए?

अब 7stamp के लिए HTTP का उपयोग करें: यह प्रलेखित, उत्पादन-तैयार मार्ग है, कम फ़ॉलबैक नहीं। जब भी आपको 7stamp ऑपरेशन, एक नया API रूट, या एक कस्टम POS/ERP कनेक्शन की आवश्यकता हो तो इसे चुनें। OpenAPI संदर्भ विधि, पूर्ण पथ, मुख्य भाग और प्रतिक्रिया स्कीमा के लिए सत्य का स्रोत है; वाहक कुंजी और आधार URL वही रहें।

Make में 7stamp इवेंट प्राप्त करें

इवेंट-संचालित परिदृश्य के लिए, Webhooks → Custom webhook जोड़ें और एक वेबहुक बनाएं। इसके URL को कॉपी करें, 7stamp प्रोफ़ाइल में API & Integrations → Webhooks खोलें, URL पेस्ट करें, ईवेंट प्रकार चुनें, सहेजें, और एक वास्तविक परीक्षण ईवेंट भेजें। 7stamp प्रोफ़ाइल उस सदस्यता का स्वामी है; वर्तमान API स्वचालित वेबहुक सब्सक्राइब/unsubscribe समापन बिंदु को उजागर नहीं करता है।

कोई सार्वजनिक Make कनेक्टर की आवश्यकता नहीं है

इस पृष्ठ पर दिए गए निर्देश Make मॉड्यूल का उपयोग करते हैं जो प्रत्येक Make खाते के लिए उपलब्ध हैं। यदि आप HTTP के बजाय भविष्य का मूल 7stamp मॉड्यूल चाहते हैं, तो हमें आवश्यक वर्कफ़्लो भेजें; तब तक, HTTP और Custom webhooks प्रत्येक प्रलेखित 7stamp ऑपरेशन को कवर करते हैं।

नेटिव कनेक्टर के बारे में पूछें

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

मुझे Make में 7stamp नहीं मिल रहा है। क्या मैं अब भी इसे स्वचालित कर सकता हूँ?

हां. आज Make में कोई सार्वजनिक 7stamp ऐप नहीं है। HTTP > Make एक अनुरोध जोड़ें, पूर्ण 7stamp समापन बिंदु URL का उपयोग करें, और अपनी 7stamp API कुंजी के बाद Authorization: Bearer भेजें। HTTP प्रत्येक दस्तावेज़ित समापन बिंदु को कॉल कर सकता है।

मुझे Make कनेक्शन के लिए टोकन कहां मिलेगा?

7stamp Admin में, API एकीकरण खोलें, फिर API Keys, फिर Add API Key खोलें। कुंजी का दायरा उस कार्यस्थल/profile तक है जिसने इसे बनाया है, इसलिए जब भी संभव हो परीक्षण परिदृश्यों के लिए एक परीक्षण प्रोफ़ाइल का उपयोग करें।

मुझे किस पहचानकर्ता को External ID के रूप में मैप करना चाहिए?

स्रोत प्रणाली से स्थिर पहचानकर्ता का उपयोग करें, अधिमानतः एक CRM संपर्क ID या ग्राहक UUID। प्रदर्शन नाम का प्रयोग न करें. एक फ़ोन नंबर या ईमेल काम कर सकता है, लेकिन बदल सकता है और इसे लगातार संभालना चाहिए।

मैं 7stamp घटनाओं को Make में कैसे प्राप्त करूं?

Make में एक वेबहुक > Custom webhook बनाएं, फिर इसके जेनरेट किए गए URL को 7stamp प्रोफ़ाइल की वेबहुक सेटिंग्स में पेस्ट करें। आने वाले event_type को संभालने के लिए डिलीवरी के बाद Make फ़िल्टर या राउटर का उपयोग करें।

संबंधित पृष्ठ

खुला Make Make HTTP सहायता Make Custom webhook सहायता 7stamp API संदर्भ वेबहुक सेटअप Zapier गाइड

अगला चरण

पहली लॉयल्टी कार्रवाई को स्वचालित करने के लिए तैयार हैं?

API कुंजी बनाएं, List Templates का परीक्षण करें, और एक डिस्पोजेबल संपर्क के साथ एक आमंत्रण या स्कैन परिदृश्य बनाएं। सरल प्रवाह विश्वसनीय होने के बाद ही राउटर और मैसेजिंग जोड़ें।

खोलें 7stamp Admin API संदर्भ पढ़ें