ईमेल का अवलोकन
POST /v1/email/messages के ज़रिए ट्रांज़ैक्शनल और मार्केटिंग ईमेल भेजें। bk_{region}_... कुंजी का उपयोग उसके मेल खाते क्षेत्रीय होस्ट के साथ करें: https://us1.platform.bird.com या https://eu1.platform.bird.com। हम संदेश पर DKIM से हस्ताक्षर करते हैं, उसे डिलीवर करते हैं, और हर प्राप्तकर्ता का परिणाम बताते हैं।
आगे पढ़ने से पहले कुछ भेजना हो, तो क्विकस्टार्ट आपको API कुंजी से लेकर डिलीवर हुए संदेश तक ले जाता है। यह पेज उस मॉडल को समझाता है जिस पर इस सेक्शन का बाकी हिस्सा आधारित है, और उसके हर हिस्से के लिए संबंधित गाइड बताता है।
भेजना कैसे काम करता है
भेजने का अनुरोध एक कॉल में स्वीकार होता है और डिलीवरी एसिंक्रोनस रूप से होती है। POST /v1/email/messages पेलोड और भेजने वाले डोमेन की जाँच करता है, फिर em_ संदेश ID के साथ 202 Accepted लौटाता है। हर प्राप्तकर्ता का परिणाम वेबहुक इवेंट या संदेश एंडपॉइंट से पढ़ें। ईमेल भेजना पेलोड, फ़ील्ड सीमाओं और प्रतिक्रिया को कवर करता है।
इस मॉडल के दो नतीजे इस सेक्शन के बाकी हिस्से को तय करते हैं।
एक संदेश, कई प्राप्तकर्ता, हर एक का अपना जीवनचक्र। पाँच पतों पर भेजा गया संदेश पाँच स्वतंत्र परिणाम देता है, और आप जो संदेश-स्तर की स्थिति पढ़ते हैं वह इन सबका समग्र रूप है। सप्रेशन का मूल्यांकन भी इसी तरह होता है: एक सप्रेस किया गया पता rejected के रूप में लौटता है, जबकि बाकी चार डिलीवर हो जाते हैं।
हर संदेश बताता है कि आप उसे क्यों भेज रहे हैं। transactional या marketing की श्रेणी तय करती है कि उस पर कौन-से सप्रेशन लागू होंगे। जिसने आपके न्यूज़लेटर से सदस्यता छोड़ दी है, उसे भी पासवर्ड रीसेट ईमेल मिलना चाहिए, और श्रेणी से ही हमें यह अंतर पता चलता है।
भेजने का अनुरोध किसी दूसरे रास्ते से भी आ सकता है, या संदेश बाद में भी जा सकता है। SMTP इस प्रोटोकॉल का उपयोग करने वाले किसी भी सिस्टम से सबमिशन स्वीकार करता है, और शेड्यूल्ड भेजना संदेश को आपके तय किए गए समय तक रोके रखता है।
डैशबोर्ड का ईमेल सेक्शन
Email डैशबोर्ड साइडबार के चैनलों में से एक है। इसके पेज, उसी क्रम में जिसमें वे दिखाई देते हैं:
| पेज | इसमें क्या है |
|---|---|
| ऑनबोर्डिंग | तीन चरणों वाली चेकलिस्ट: API कुंजी बनाएँ, एक ईमेल भेजें, अपना डोमेन जोड़ें। यह तब तक दिखती है जब तक आप इसे पूरा नहीं कर लेते |
| मेट्रिक्स | समय के साथ डिलीवरी, ओपन, बाउंस और शिकायत दरें; देखें Email मेट्रिक्स |
| ईमेल | भेजा गया हर संदेश; देखें ईमेल लॉग। इसके Receiving टैब में आने वाले ईमेल की सूची होती है |
| मेलबॉक्स | प्रोग्राम करने योग्य इनबॉक्स, जिन्हें आपका कोड पढ़ता है और जिनसे जवाब देता है; देखें एजेंट मेलबॉक्स |
| टेम्पलेट | दोबारा इस्तेमाल होने वाली विषय और मुख्य सामग्री, एक ड्राफ़्ट और प्रकाशित संस्करणों के साथ; देखें ईमेल टेम्पलेट |
| डोमेन | आपके भेजने वाले डोमेन, उनके DNS रिकॉर्ड और लाइव सत्यापन स्थिति; देखें भेजने वाले डोमेन |
| IP पूल | समर्पित IP और वे पूल जिनमें वे शामिल हैं; देखें समर्पित IP और पूल |
| ब्रॉडकास्ट | सहेजी गई ऑडियंस को एक ईमेल, जिसकी डिलीवरी हर प्राप्तकर्ता के लिए ट्रैक होती है; देखें ब्रॉडकास्ट |
| सप्रेशन | वे पते जिन पर हम ईमेल नहीं भेजते, और उसका कारण; देखें सप्रेशन |
| अनसब्सक्राइब पेज | उस होस्ट किए गए पेज की ब्रांडिंग, जिसका लिंक हर मार्केटिंग ईमेल में होता है; देखें अनसब्सक्राइब लिंक |
| SMTP | कनेक्शन सेटिंग्स, प्रति-कुंजी भेजने के डिफ़ॉल्ट और लाइव कनेक्शन; देखें SMTP |
प्राप्तकर्ता Email सेक्शन से बाहर, साइडबार में Contacts में रहते हैं: All contacts लोगों को टाइप की गई कस्टम प्रॉपर्टी के साथ सहेजता है (देखें Contacts), और Audiences उन्हें ऐसी दोबारा उपयोग योग्य सूचियों में समूहित करता है जिन्हें ब्रॉडकास्ट भेजा जाता है (देखें Audiences)।
हर गाइड कहाँ काम आती है
भेजना। सबसे पहले ईमेल भेजना पढ़ें: इसमें वह पेलोड है जिस पर भेजने के बाकी सभी तरीके आधारित हैं। इसके बाद, टेम्पलेट दोबारा उपयोग होने वाली सामग्री सहेजते हैं, अटैचमेंट फ़ाइलें जोड़ते हैं, बैच में भेजना एक अनुरोध में 100 तक संदेश सबमिट करता है, और ब्रॉडकास्ट एक ईमेल पूरी ऑडियंस को भेजते हैं।
डोमेन और ऑथेंटिकेशन। भेजने वाले डोमेन में डोमेन रजिस्टर करना और उसे सत्यापित करवाना शामिल है। DKIM, SPF और DMARC बताता है कि हर रिकॉर्ड प्राप्त करने वाले मेलबॉक्स प्रदाता को क्या साबित करता है, और BIMI समर्थन करने वाले ईमेल ऐप में आपके संदेशों के पास आपका लोगो दिखाता है।
प्रतिष्ठा। सप्रेशन उन पतों की सूची है जिन पर हम भेजना बंद कर देते हैं; यह हार्ड बाउंस और शिकायतों से अपने आप भरती है। अनसब्सक्राइब भी इसी तरह डिलीवरी रोकते हैं, लेकिन सप्रेशन रिकॉर्ड के बजाय बताई गई प्राथमिकता के ज़रिए। डेडिकेटेड IP और पूल और IP वार्मअप ऐसे IP पतों से भेजने के बारे में हैं जिनका उपयोग केवल आपका संगठन करता है। ईमेल डिलीवरेबिलिटी इन सबको जोड़ती है।
क्या हुआ, यह जानना। ईमेल लॉग एक संदेश और उसकी प्रति-प्राप्तकर्ता टाइमलाइन दिखाता है। ईमेल मेट्रिक्स आपके ट्रैफ़िक को एकत्रित करता है। इवेंट इवेंट की शब्दावली बताता है और यह भी कि वेबहुक उन्हें आपके अपने एंडपॉइंट तक कैसे पहुँचाते हैं।
प्राप्त करना। ईमेल प्राप्त करना ईमेल आने के दोनों तरीके बताता है: हमारे द्वारा बनाया गया फ़ॉरवर्डिंग पता, जिसके लिए DNS की ज़रूरत नहीं, या आपके अपने सबडोमेन पर MX रिकॉर्ड। एजेंट मेलबॉक्स इसी पर ऐसे इनबॉक्स बनाता है जिनसे आपका कोड पढ़ता भी है और भेजता भी है।
टेस्टिंग। मेल सैंडबॉक्स कहीं भी डिलीवर किए बिना आपके इंटीग्रेशन को शुरू से अंत तक परखता है। असली इवेंट और वेबहुक पाइपलाइन से हार्ड बाउंस बनाने के लिए bounce@messagebird.dev पर भेजें। यह टेस्ट आपकी सप्रेशन सूची में कुछ नहीं लिखता।
प्रोडक्शन ईमेल को किसी दूसरे प्रदाता से लाने के लिए माइग्रेशन गाइड का पालन करें। इसमें अनुरोध मैपिंग, DNS, सप्रेशन, वेबहुक, सैंडबॉक्स टेस्टिंग और ट्रैफ़िक कटओवर शामिल हैं।
संबंधित संसाधन
इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।