आउटबाउंड इंटीग्रेशन

🔗 आउटबाउंड इंटीग्रेशन

अपने LoyaltyTree इवेंट्स को बाहरी मार्केटिंग, ऑटोमेशन और एनालिटिक्स प्लेटफार्मों से कनेक्ट करें। ईमेल अभियानों, ग्राहक खंडों, ऑटोमेशन और अधिक को शक्ति देने के लिए ग्राहक गतिविधि के बारे में वास्तविक समय का डेटा भेजें।

---

समर्थित प्लेटफार्म

LoyaltyTree निम्नलिखित प्लेटफार्मों पर इवेंट भेजने का समर्थन करता है:

प्लेटफार्म	प्रकार	आपको क्या चाहिए
Klaviyo	ईमेल/SMS मार्केटिंग	आपका Klaviyo प्राइवेट API कुंजी
Omnisend	ईमेल/SMS मार्केटिंग	आपका Omnisend API कुंजी
Shopify Flow	Shopify ऑटोमेशन	एक फ्लो ट्रिगर हैंडल (जो Shopify Flow में बनाया गया है)
जनरिक वेबहुक	कोई भी HTTP एंडपॉइंट	एक वेबहुक URL जो POST अनुरोध स्वीकार करता है

---

शुरू करना

---

समर्थित इवेंट (कुल 19)

आप प्रत्येक इंटीग्रेशन को इन इवेंट्स के किसी भी संयोजन के लिए सब्सक्राइब कर सकते हैं। केवल वही इवेंट्स भेजे जाएंगे जो आप चुनते हैं।

🌱 बीज अर्जित इवेंट्स

जब ग्राहक विभिन्न गतिविधियों के माध्यम से बीज अर्जित करता है, तो यह ट्रिगर होता है।

इवेंट	इवेंट कुंजी	जब ट्रिगर होता है
बीज – अर्जित – ऑर्डर	seeds.earned.order	ग्राहक एक खरीद से बीज अर्जित करता है
बीज – अर्जित – विजिट	seeds.earned.visit	ग्राहक स्टोर में विजिट करने से बीज अर्जित करता है
बीज – अर्जित – समीक्षा	seeds.earned.review	ग्राहक एक समीक्षा लिखने से बीज अर्जित करता है
बीज – अर्जित – रेफरल	seeds.earned.referral	ग्राहक एक सफल रेफरल से बीज अर्जित करता है
बीज – अर्जित – सोशल शेयर	seeds.earned.social_share	ग्राहक सोशल मीडिया पर शेयर करने से बीज अर्जित करता है
बीज – अर्जित – बोनस	seeds.earned.bonus	ग्राहक बोनस बीज प्राप्त करता है (जन्मदिन, मैन्युअल पुरस्कार, आदि)

⭐ स्तर & समीक्षा इवेंट्स

इवेंट	इवेंट कुंजी	जब ट्रिगर होता है
स्तर – बदला गया	tier.changed	ग्राहक एक अलग लॉयल्टी स्तर पर जाता है
समीक्षा – प्रस्तुत की गई	review.submitted	ग्राहक एक नया उत्पाद समीक्षा प्रस्तुत करता है
समीक्षा – स्वीकृत	review.approved	एक उत्पाद समीक्षा स्वीकृत होती है (AI या मैन्युअल रूप से)
समीक्षा – अस्वीकृत	review.rejected	एक उत्पाद समीक्षा अस्वीकृत होती है

🎁 पुरस्कार इवेंट्स

इवेंट	इवेंट कुंजी	जब ट्रिगर होता है
गिफ्ट कार्ड – अर्जित	gift_card.earned	ग्राहक गिफ्ट कार्ड पुरस्कार के लिए योग्य होता है
गिफ्ट कार्ड – दावा किया गया	gift_card.claimed	ग्राहक अपना गिफ्ट कार्ड दावा करता है
स्टोर क्रेडिट – अर्जित	store_credit.earned	ग्राहक स्टोर क्रेडिट के लिए योग्य होता है
स्टोर क्रेडिट – दावा किया गया	store_credit.claimed	ग्राहक अपना स्टोर क्रेडिट दावा करता है

🌳 इको & रेफरल इवेंट्स

इवेंट	इवेंट कुंजी	जब ट्रिगर होता है
इको उत्पाद – पुरस्कारित	eco_product.awarded	ग्राहक एक इको उत्पाद के लिए बीज भुनाता है
इको – पेड़ लगाया गया	eco.tree_planted	ग्राहक के लिए एक पेड़ लगाया जाता है
रेफरल – उत्पन्न	referral.generated	ग्राहक एक रेफरल लिंक उत्पन्न करता है
रेफरल – विजिट	referral.visit	कोई व्यक्ति एक रेफरल लिंक के माध्यम से स्टोर में जाता है
रेफरल – सफल	referral.successful	एक रेफर किया गया आगंतुक खरीदारी करता है

---

प्लेटफार्म सेटअप गाइड

📧 Klaviyo

Klaviyo एक ईमेल और SMS मार्केटिंग प्लेटफार्म है जो Shopify स्टोर्स के साथ लोकप्रिय है। LoyaltyTree Klaviyo को इवेंट्स API (v3) का उपयोग करके इवेंट भेजता है, ताकि आप लॉयल्टी गतिविधि के आधार पर खंड, फ्लो और अभियानों का निर्माण कर सकें।

यह कैसे काम करता है: LoyaltyTree ग्राहक के ईमेल को प्रोफ़ाइल पहचानकर्ता के रूप में Klaviyo इवेंट्स बनाता है। इवेंट्स कस्टम मैट्रिक्स के रूप में दिखाई देते हैं (जैसे "बीज अर्जित ऑर्डर", "स्तर बदला गया") जिन्हें आप Klaviyo फ्लो और खंडों में उपयोग कर सकते हैं। बीज की मात्रा को इवेंट मूल्य के रूप में भेजा जाता है, ताकि आप उन्हें शर्तीय विभाजनों में उपयोग कर सकें।

📨 Omnisend

Omnisend एक और लोकप्रिय ईमेल और SMS मार्केटिंग प्लेटफार्म है। LoyaltyTree इवेंट्स को Omnisend इवेंट्स API (v5) का उपयोग करके भेजता है।

यह कैसे काम करता है: इवेंट्स ग्राहक के ईमेल, नाम, और Shopify ग्राहक ID के साथ भेजे जाते हैं। प्रत्येक इवेंट में सभी प्रासंगिक गुण शामिल होते हैं (बीज की मात्रा, ऑर्डर विवरण, स्तर की जानकारी, आदि) ताकि आप उन्हें Omnisend ऑटोमेशन वर्कफ़्लो और विभाजन में उपयोग कर सकें।

⚡ Shopify Flow

Shopify Flow Shopify का अंतर्निहित ऑटोमेशन टूल है। LoyaltyTree इवेंट्स को सीधे Shopify Flow में GraphQL flowTriggerReceive म्यूटेशन का उपयोग करके भेजता है, जिसका अर्थ है कि इवेंट्स आपके फ्लो वर्कफ़्लो के अंदर ट्रिगर्स के रूप में दिखाई देते हैं — कोई तीसरे पक्ष के ऐप की आवश्यकता नहीं।

यह कैसे काम करता है: जब एक सब्सक्राइब किया गया इवेंट होता है, तो LoyaltyTree आपके स्टोर के Shopify API कनेक्शन का उपयोग करके इवेंट डेटा को सीधे Shopify Flow में GraphQL के माध्यम से भेजता है। पेलोड को मानव-पठनीय कुंजियों में समतल किया जाता है जैसे "ग्राहक ईमेल", "इवेंट प्रकार", "राशि", आदि। आप फिर इन मानों का उपयोग अपने फ्लो में शर्तों के रूप में कर सकते हैं ताकि ईमेल भेजने, ग्राहकों को टैग करने, या कार्य बनाने जैसी क्रियाएँ ट्रिगर की जा सकें।

उदाहरण Shopify Flow ऑटोमेशन:

• जब ग्राहक गोल्ड स्तर पर पहुँचते हैं तो उन्हें टैग करें
• जब एक पेड़ लगाया जाता है तो एक आंतरिक स्लैक सूचना भेजें
• जब एक समीक्षा प्रस्तुत की जाती है तो एक कार्य बनाएं
• जब वे एक गिफ्ट कार्ड अर्जित करते हैं तो ग्राहक प्रोफ़ाइल में एक नोट जोड़ें

 

🌐 जनरिक वेबहुक

LoyaltyTree इवेंट्स को किसी भी HTTP एंडपॉइंट पर भेजें। यह कस्टम सिस्टम, Zapier, Make (Integromat), n8n, या किसी अन्य प्लेटफार्म से कनेक्ट करने के लिए बिल्कुल सही है जो वेबहुक POST स्वीकार करता है।

प्रमाणन विकल्प:

विधि	भेजा गया हेडर	विवरण
HMAC सिग्नेचर	X-LoyaltyTree-Signature	पेलोड बॉडी का SHA-256 HMAC, आपके वेबहुक सीक्रेट के साथ हस्ताक्षरित
बियरर टोकन	Authorization: Bearer <token>	मानक OAuth-शैली बियरर टोकन प्रमाणन
X-Token	X-Token: <token>	कस्टम हेडर में सरल टोकन
कस्टम हेडर	<your-header>: <token>	अपने स्वयं के हेडर नाम और टोकन मान निर्दिष्ट करें

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

प्रत्येक अनुरोध के साथ भेजे गए मानक हेडर:

• Content-Type: application/json
• User-Agent: LoyaltyTree/1.0
• X-LoyaltyTree-Event: <event_type>
• X-LoyaltyTree-Timestamp: <ISO timestamp>

---

उदाहरण वेबहुक पेलोड

यहाँ एक सामान्य seeds.earned.order इवेंट का उदाहरण है जब इसे एक जनरिक वेबहुक पर भेजा जाता है:

{
  "event": "seeds.earned.order",
  "timestamp": "2026-02-06T14:30:00.000Z",
  "customer": {
    "email": "jane@example.com",
    "first_name": "Jane",
    "last_name": "Smith",
    "display_name": "Jane Smith",
    "shopify_customer_id": "7891234567890"
  },
  "amount": 50,
  "order_id": "6012345678901",
  "order_number": "1042",
  "order_total": "89.99",
  "order_currency": "USD",
  "balance": 350,
  "tier": "Silver"
}

हर इवेंट पेलोड में ग्राहक ऑब्जेक्ट शामिल होता है जिसमें उनका ईमेल, नाम, और Shopify ग्राहक ID होती है, साथ ही इवेंट-विशिष्ट डेटा फ़ील्ड भी होते हैं।

---

इवेंट डेटा संदर्भ

नीचे प्रत्येक इवेंट प्रकार के साथ शामिल डेटा फ़ील्ड की विस्तृत सूची है।

---

विश्वसनीयता & पुनः प्रयास लॉजिक

LoyaltyTree विश्वसनीय इवेंट डिलीवरी सुनिश्चित करने के लिए एक असिंक्रोनस कतार का उपयोग करता है। इवेंट कभी भी खोते नहीं हैं — यदि डिलीवरी विफल होती है, तो सिस्टम स्वचालित रूप से पुनः प्रयास करता है जिसमें वृद्धि होती है।

पुनः प्रयास प्रयास	इंतज़ार का समय
1st पुनः प्रयास	1 मिनट
2nd पुनः प्रयास	5 मिनट
3rd पुनः प्रयास	30 मिनट
4th पुनः प्रयास	2 घंटे
5th पुनः प्रयास (अंतिम)	24 घंटे

सभी पुनः प्रयास समाप्त होने के बाद, इवेंट को "खत्म" के रूप में चिह्नित किया जाता है और आपके इवेंट लॉग में एक पुनः प्रयास बटन के साथ दिखाई देता है ताकि आप इसे किसी भी समय मैन्युअल रूप से पुनः प्रयास कर सकें।

इवेंट लॉग

हर इवेंट डिलीवरी लॉग की जाती है और इवेंट लॉग अनुभाग में दिखाई देती है। आप लॉग को फ़िल्टर कर सकते हैं:

• कनेक्शन – एक विशिष्ट इंटीग्रेशन के लिए इवेंट देखें
• इवेंट – इवेंट प्रकार द्वारा फ़िल्टर करें
• ग्राहक – ग्राहक ईमेल या नाम द्वारा खोजें
• तारीख सीमा – एक विशिष्ट समय अवधि के इवेंट देखें

प्रत्येक लॉग प्रविष्टि समय, प्लेटफार्म, इवेंट प्रकार, स्थिति, और किसी भी त्रुटि संदेश को दिखाती है। विफल इवेंट्स में तुरंत उन्हें फिर से कतार में लगाने के लिए पुनः प्रयास बटन शामिल होता है।

 

---

समस्या निवारण

---

सुरक्षा

• सभी API कुंजी और टोकन आराम में एन्क्रिप्टेड हैं, AES-256-CBC एन्क्रिप्शन का उपयोग करके
• वेबहुक सीक्रेट्स HMAC सिग्नेचर सत्यापन सक्षम करते हैं ताकि आपका एंडपॉइंट सत्यापित कर सके कि अनुरोध वास्तव में LoyaltyTree से आया है
• इवेंट्स एक असिंक्रोनस कतार के माध्यम से संसाधित होते हैं — आपके स्टोर के प्रदर्शन पर इंटीग्रेशन डिलीवरी का कभी भी प्रभाव नहीं पड़ता
• पुराने डिलीवर किए गए इवेंट्स और लॉग स्वचालित रूप से 30 दिनों के बाद साफ़ कर दिए जाते हैं