श्रेणियाँ

आपके भेजे हर ईमेल की एक श्रेणी होती है, जो बताती है कि आप उसे क्यों भेज रहे हैं। इसे POST /v1/email/messages पर category फ़ील्ड से सेट किया जाता है। इसका मान दो में से एक होता है, marketing या transactional, और इसका एक ही असर है: यह तय करती है कि कौन-से सप्रेशन रिकॉर्ड और अनसब्सक्राइब प्राथमिकताएँ संदेश को रोक सकती हैं।

न्यूज़लेटर से अनसब्सक्राइब करना मार्केटिंग मेल के बारे में कुछ कहता है, पासवर्ड रीसेट के बारे में कुछ नहीं। श्रेणी से ही हम इन दोनों इरादों में फ़र्क करते हैं।

दो श्रेणियाँ

• marketing: ऐसा मेल जिसे प्राप्तकर्ता ने पाना चुना है और जिसे बंद करना भी चुन सकता है। कैंपेन, न्यूज़लेटर, प्रोडक्ट घोषणाएँ, प्रचार ऑफ़र। ऐसा कोई भी मेल जहाँ "I don't want this anymore" एक ऐसा जवाब है जिसका आपको सम्मान करना होगा।
• transactional: ऐसा मेल जो प्राप्तकर्ता की अपनी किसी कार्रवाई के कारण ज़रूरी है। पासवर्ड रीसेट, ईमेल सत्यापन, वन-टाइम कोड, ऑर्डर रसीदें, सुरक्षा और अकाउंट अलर्ट। प्राप्तकर्ता की मार्केटिंग प्राथमिकताएँ जो भी हों, इन्हें पहुँचना ही चाहिए।

सोचिए कि संदेश कभी न पहुँचे तो क्या होगा। अगर प्राप्तकर्ता का शुरू किया कोई फ़्लो टूट जाता है, तो वह ट्रांज़ैक्शनल है। अगर बातचीत आपने शुरू की थी, तो वह मार्केटिंग है।

बस यही दो श्रेणियाँ हैं: कोई API श्रेणी नहीं बनाता या कॉन्फ़िगर नहीं करता, और फ़ील्ड को इन्हीं मानों के आधार पर जाँचा जाता है। इससे बारीक सेगमेंटेशन के लिए श्रेणी के साथ टैग का उपयोग करें।

श्रेणी सप्रेशन नीति को कैसे तय करती है

नियम एक पंक्ति का है: marketing को हर सप्रेशन कारण और किसी भी ऑप्ट-आउट से रोका जाता है, जबकि transactional शिकायत वाले सप्रेशन या केवल मार्केटिंग के ऑप्ट-आउट के बावजूद डिलीवर होता है। हार्ड बाउंस, मैन्युअल सप्रेशन और सभी संदेशों के लिए दर्ज ऑप्ट-आउट दोनों को रोकते हैं।

यह असमानता हर कारण के अर्थ से आती है। हार्ड बाउंस का अर्थ है कि पता मौजूद नहीं है, इसलिए श्रेणी चाहे जो हो, भेजना बेकार है। मैनुअल सप्रेशन आपकी अपनी टीम का निर्णय है, जिस पर हम कभी सवाल नहीं उठाते। शिकायतें और अनसब्सक्राइब अनचाहे मेल के बारे में प्राथमिकताएँ हैं: वे आपके marketing संदेशों को रोकती हैं, जबकि जिस प्राप्तकर्ता ने आपके न्यूज़लेटर को स्पैम बताया, उसे पासवर्ड रीसेट फिर भी मिलता है। अपवाद भी जानबूझकर रखा गया है: ऑप्ट-आउट केवल मार्केटिंग के बजाय सभी संदेशों के लिए दर्ज किया जा सकता है (Record preference डायलॉग में Messages to stop विकल्प, या POST /v1/preferences पर coverage: all)। इसका अर्थ है कि प्राप्तकर्ता पूरी चुप्पी चाहता है, इसलिए यह ट्रांज़ैक्शनल मेल को भी रोकता है।

रोके गए प्राप्तकर्ता ऐसी जगह अस्वीकार किए जाते हैं जहाँ आप उन्हें देख सकें, हर प्राप्तकर्ता के लिए एक पंक्ति, कारण के साथ। सप्रेशन पेज पर हर कारण की तालिका है और यह भी बताया गया है कि पते सूची में कैसे पहुँचते हैं।

डिफ़ॉल्ट, और ट्रांज़ैक्शनल संदेशों को ऑप्ट-आउट क्यों करना होगा

category छोड़ने पर संदेश marketing माना जाता है। यह सुरक्षित दिशा में विफल होता है: स्पष्ट श्रेणी के बिना भेजा गया मेल अनसब्सक्राइब और शिकायतों का सम्मान करता है और उसमें अनसब्सक्राइब लिंक होता है, इसलिए कोई कैंपेन बिना अतिरिक्त काम के नियमों का पालन करता है।

दो भेजने के तरीके अपनी श्रेणी कहीं और से लेते हैं। जो संदेश संग्रहीत टेम्पलेट का उपयोग करता है और category छोड़ देता है, वह टेम्पलेट का अपना वर्गीकरण लेता है, इसलिए transactional के रूप में बनाया गया टेम्पलेट ट्रांज़ैक्शनल के रूप में भेजा जाता है। किसी एक संदेश को अलग वर्गीकृत करने के लिए भेजते समय category सेट करें, तब भेजने वाला मान लागू होता है। SMTP के ज़रिए भेजा गया मेल अपनी श्रेणी API कुंजी के SMTP कॉन्फ़िगरेशन से लेता है, जो कॉन्फ़िगर न की गई कुंजी के लिए transactional होता है।

इसलिए परिचालन मेल को ऑप्ट-आउट करना होगा। बिना श्रेणी के भेजा गया पासवर्ड रीसेट मार्केटिंग माना जाता है: उसमें ऐसा अनसब्सक्राइब लिंक जुड़ जाता है जो नहीं होना चाहिए, और न्यूज़लेटर से अनसब्सक्राइब उसे रोक देता है, भले ही प्राप्तकर्ता ने उसे खुद माँगा हो। रसीदों, रीसेट, सत्यापन कोड और खाता अलर्ट पर category: "transactional" सेट करें:

{
  "from": "no-reply@yourdomain.com",
  "to": ["delivered@messagebird.dev"],
  "subject": "Reset your password",
  "html": "<p>Click the link below to reset your password...</p>",
  "category": "transactional"
}

विश्लेषण के आयाम के रूप में श्रेणियाँ

श्रेणी संदेश पर बनी रहती है और जहाँ भी संदेश दिखता है, वहाँ लौटती है। इससे आपके डिलीवरी, बाउंस और एंगेजमेंट आँकड़े मार्केटिंग और परिचालन ट्रैफ़िक में बँट जाते हैं, हर संदेश को टैग किए बिना। संदेश सूची श्रेणी के अनुसार फ़िल्टर करती है, आँकड़े API मेट्रिक्स को इसके अनुसार विभाजित करता है, और डैशबोर्ड का ईमेल लॉग भी यही फ़िल्टर देता है।

अगले कदम

• ईमेल भेजना: पूरा POST /v1/email/messages पेलोड, category सहित
• सप्रेशन: सप्रेशन सूची, तीन कारण और पूरी श्रेणी तालिका
• अनसब्सक्राइब लिंक: marketing संदेश में शामिल ऑप्ट-आउट विवरण
• API संदर्भ: पूरे अनुरोध और प्रतिक्रिया स्कीमा