इनबाउंड ईमेल API आपके स्वामित्व वाले पते या डोमेन पर भेजा गया मेल प्राप्त करता है, उसे पार्स करता है और एक संरचित HTTP POST के रूप में आपके एप्लिकेशन तक पहुँचाता है। मेल सर्वर चलाने और IMAP के ज़रिए मेलबॉक्स को पोल करने के बजाय, आप अपने डोमेन के MX रिकॉर्ड प्रदाता की ओर पॉइंट करते हैं। इसके बाद हर आने वाला संदेश आपके एंडपॉइंट पर पहुँचता है, और उसके हेडर, बॉडी और अटैचमेंट पहले से JSON में पार्स किए हुए होते हैं।
रूटिंग DNS से शुरू होती है। आप किसी डोमेन या सबडोमेन (जैसे reply.yourapp.com) के MX रिकॉर्ड इनबाउंड प्रदाता के मेल सर्वरों की ओर पॉइंट करते हैं। जब कोई उस डोमेन के किसी भी पते पर संदेश भेजता है, तो वह आपके बजाय प्रदाता के इन्फ्रास्ट्रक्चर पर पहुँचता है। प्रदाता संदेश स्वीकार करता है, उसे पार्स करता है और आपके रजिस्टर किए गए URL पर पार्स की गई सामग्री के साथ POST अनुरोध भेजता है।
पार्स किए गए पेलोड में आम तौर पर प्रेषक और प्राप्तकर्ता, विषय, प्लेन-टेक्स्ट और HTML बॉडी, पूरे हेडर और सभी अटैचमेंट होते हैं। अटैचमेंट अक्सर base64-एन्कोडेड होते हैं या किसी URL से संदर्भित होते हैं। आपका ऐप उस JSON को पढ़कर कार्रवाई करता है, और आपको कोई SMTP या IMAP कोड मेंटेन नहीं करना पड़ता। डिलीवरी एक वेबहुक के ज़रिए होती है, इसलिए वही नियम लागू होते हैं: तुरंत 2xx से जवाब दें, फिर संदेश को एसिंक्रोनस रूप से प्रोसेस करें।
इनबाउंड ईमेल प्राप्त संदेशों को एप्लिकेशन इवेंट में बदल देता है। आम उपयोग इस प्रकार हैं:
- जवाबों को संभालना।
notifications@yourapp.comसे सूचना भेजें। जब उपयोगकर्ता जवाब देता है, तो जवाब POST के रूप में आता है, ताकि आप उसे बातचीत के थ्रेड में वापस जोड़ सकें। - सपोर्ट टिकटिंग।
support@yourapp.comपर आया मेल नया टिकट बन जाता है, और प्रेषक व बॉडी सीधे आपके हेल्प डेस्क में मैप हो जाते हैं। - पार्स करके डेटाबेस में। फ़ॉरवर्ड की गई रसीदें या संरचित ईमेल पार्स होकर किसी टेबल में लिखे जाते हैं, बिना मैन्युअल एंट्री के।
- ईमेल से कार्रवाई। किसी विशेष पते पर भेजा गया संदेश एक वर्कफ़्लो शुरू करता है: कोई रिकॉर्ड बनाना, कोई जॉब चलाना या किसी चैनल पर पोस्ट करना।
आउटबाउंड और इनबाउंड अलग-अलग काम हैं। आउटबाउंड में आपका ऐप SMTP या किसी HTTP send API के ज़रिए प्राप्तकर्ताओं तक मेल पहुँचाता है। इनबाउंड इसका उल्टा है: बाहरी प्रेषक आपके ऐप तक मेल पहुँचाते हैं। एक पूरा ईमेल इंटीग्रेशन आमतौर पर दोनों करता है, यानी सूचनाएँ भेजता है और जवाब वापस प्राप्त करता है। फिर भी दोनों को अलग-अलग कॉन्फ़िगर किया जाता है, और केवल इनबाउंड हिस्सा आपके MX रिकॉर्ड पर निर्भर करता है।
आप किसी असली मेलबॉक्स पर IMAP पोलर चला सकते हैं, लेकिन इसकी लगातार लागत होती है। आपको क्रेडेंशियल संभालने पड़ते हैं और तय करना पड़ता है कि कितनी बार पोल करें, जिससे विलंब और निष्क्रिय कनेक्शन बढ़ते हैं। आपको रॉ MIME खुद पार्स करना पड़ता है और यह भी ट्रैक करना पड़ता है कि कौन-से संदेश पहले ही प्रोसेस हो चुके हैं। इनबाउंड API इनमें से ज़्यादातर काम हटा देता है: प्रदाता MIME पार्स करता है, हर संदेश को एक बार साफ़ JSON के रूप में भेजता है, और आप लगभग रियल टाइम में प्रतिक्रिया देते हैं। मूल प्रोटोकॉल की तुलना के लिए SMTP बनाम IMAP देखें।
मुझे DNS में कौन-से बदलाव करने होंगे?
जिस डोमेन या सबडोमेन पर आप मेल प्राप्त करना चाहते हैं, उसके MX रिकॉर्ड को अपने इनबाउंड प्रदाता की ओर सेट करें। प्रोपेगेशन के बाद उस डोमेन के किसी भी पते पर आने वाला मेल प्रदाता तक पहुँचता है, जो उसे पार्स करके आपके एंडपॉइंट पर पोस्ट करता है। अलग सबडोमेन इस्तेमाल करने से इनबाउंड रूटिंग आपके मुख्य डोमेन के मेल से अलग रहती है।
अटैचमेंट कैसे संभाले जाते हैं?
पार्स किए गए पेलोड में अटैचमेंट शामिल होते हैं, आमतौर पर इनलाइन base64-एन्कोडेड रूप में या ऐसे URL के रूप में जिन्हें आप अलग से फ़ेच करते हैं। आपका हैंडलर उन्हें डिकोड या डाउनलोड करके वहाँ स्टोर करता है जहाँ आप फ़ाइलें रखते हैं। पेलोड छोटा रखने के लिए बड़े अटैचमेंट आमतौर पर URL से दिए जाते हैं।
क्या इनबाउंड ईमेल और वेबहुक एक ही चीज़ हैं?
डिलीवरी वेबहुक से होती है: प्रदाता हर संदेश के लिए आपके ऐप को एक HTTP POST भेजता है। फ़र्क यह है कि पेलोड कोई सामान्य इवेंट नहीं, बल्कि पूरी तरह पार्स किया गया ईमेल होता है। इसे किसी भी वेबहुक की तरह संभालें: इसे सत्यापित करें, जल्दी जवाब दें और एसिंक्रोनस रूप से प्रोसेस करें।
Bird ईमेल की दोनों दिशाओं को कैसे संभालता है, यह जानने के लिए ईमेल प्रोडक्ट का अवलोकन और ईमेल इवेंट गाइड से शुरुआत करें। यह गाइड उस इवेंट डिलीवरी मॉडल को समझाती है जिस पर आपका इनबाउंड हैंडलर आधारित होगा।